diff options
Diffstat (limited to 'files/es/web/api/animation/pause/index.html')
-rw-r--r-- | files/es/web/api/animation/pause/index.html | 106 |
1 files changed, 106 insertions, 0 deletions
diff --git a/files/es/web/api/animation/pause/index.html b/files/es/web/api/animation/pause/index.html new file mode 100644 index 0000000000..0c0329dda7 --- /dev/null +++ b/files/es/web/api/animation/pause/index.html @@ -0,0 +1,106 @@ +--- +title: Animation.pause() +slug: Web/API/Animation/pause +tags: + - API + - Animacion + - Animaciones Web + - Experimental + - Referencia + - pausar + - pause + - waapi +translation_of: Web/API/Animation/pause +--- +<p>{{ SeeCompatTable() }}{{ APIRef("Web Animations") }}</p> + +<p>El método <code><strong>pause()</strong></code> de la interfaz {{domxref("Animation")}} de la <a href="/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a>, suspende la reproducción de la animación.</p> + +<h2 id="Sintaxis">Sintaxis</h2> + +<pre class="syntaxbox">animation.pause(); +</pre> + +<h3 id="Parámetros">Parámetros</h3> + +<p>None.</p> + +<h3 id="Valor_devuelto">Valor devuelto</h3> + +<p>None.</p> + +<h3 id="Excepciones">Excepciones</h3> + +<dl> + <dt>InvalidStateError</dt> + <dd>La animación {{domxref ("Animation.currentTime", "currentTime")}} no está resuelta <code>unresolved</code> (por ejemplo, si nunca se ha reproducido o no se está reproduciendo actualmente) y el tiempo de finalización de la animación es infinito positivo.</dd> +</dl> + +<p>Lanza un <code>InvalidStateError</code> si el {{domxref("Animation.currentTime", "currentTime")}} de la animación no está resuelto <code>unresolved</code> (tal vez no se haya iniciado la reproducción) y el fin de la animación es infinito positivo.</p> + +<h2 id="Ejemplos">Ejemplos</h2> + +<p><code>Animation.pause()</code> es utilizado en varias ocasiones en el juego Alice in Web Animations API Land <a href="http://codepen.io/rachelnabors/pen/PNYGZQ?editors=0010">Growing/Shrinking Alice Game</a>, porque las animaciones creadas con el método {{domxref("Element.animate()")}} se inician de inmediato y deben ser detenidas manualmente para evitar esto:</p> + +<pre class="brush: js">// animación de la magdalena que lentamente se está comiendo +var nommingCake = document.getElementById('eat-me_sprite').animate( +[ + { transform: 'translateY(0)' }, + { transform: 'translateY(-80%)' } +], { + fill: 'forwards', + easing: 'steps(4, end)', + duration: aliceChange.effect.timing.duration / 2 +}); + +// realmente solo debe funcionar al hacer click, así que se pausa inicialmente: +nommingCake.pause(); +</pre> + +<p>Adicionalmente, al restablecer:</p> + +<pre class="brush: js">// Una función multiusos para pausar las animaciones de Alicia, el pastelito y la botella que dice "drink me." +var stopPlayingAlice = function() { + aliceChange.pause(); + nommingCake.pause(); + drinking.pause(); +}; + +// Cuando el usuario suelte el cupcake o la botella, pause las animaciones. +cake.addEventListener("mouseup", stopPlayingAlice, false); +bottle.addEventListener("mouseup", stopPlayingAlice, false); +</pre> + +<h2 id="Especificaciones">Especificaciones</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th>Especificación</th> + <th>Estado</th> + <th>Comentario</th> + </tr> + <tr> + <td>{{SpecName('Web Animations', '#dom-animation-pause', 'play()')}}</td> + <td>{{Spec2("Web Animations")}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidad_en_navegadores">Compatibilidad en navegadores</h2> + +<div> +<p>{{Compat("api.Animation.pause")}}</p> +</div> + +<h2 id="Ver_también" style="line-height: 30px; font-size: 2.14285714285714rem;">Ver también</h2> + +<ul> + <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a></li> + <li>{{domxref("Animation")}} para otros métodos y propiedades que puedes usar para el control de animaciones en páginas web.</li> + <li>{{domxref("Animation.pause()")}} para pausar una animación.</li> + <li>{{domxref("Animation.reverse()")}} para reproducir una animación al revés.</li> + <li>{{domxref("Animation.finish()")}} para finalizar una animación.</li> + <li>{{domxref("Animation.cancel()")}} para cancelar una animación.</li> +</ul> |