aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/api/animation/pause/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/es/web/api/animation/pause/index.html')
-rw-r--r--files/es/web/api/animation/pause/index.html106
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>