diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
commit | 074785cea106179cb3305637055ab0a009ca74f2 (patch) | |
tree | e6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/pt-br/web/api/animation | |
parent | da78a9e329e272dedb2400b79a3bdeebff387d47 (diff) | |
download | translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2 translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip |
initial commit
Diffstat (limited to 'files/pt-br/web/api/animation')
-rw-r--r-- | files/pt-br/web/api/animation/cancel/index.html | 120 | ||||
-rw-r--r-- | files/pt-br/web/api/animation/currenttime/index.html | 112 | ||||
-rw-r--r-- | files/pt-br/web/api/animation/index.html | 171 | ||||
-rw-r--r-- | files/pt-br/web/api/animation/playstate/index.html | 152 |
4 files changed, 555 insertions, 0 deletions
diff --git a/files/pt-br/web/api/animation/cancel/index.html b/files/pt-br/web/api/animation/cancel/index.html new file mode 100644 index 0000000000..ceb1b7cf6c --- /dev/null +++ b/files/pt-br/web/api/animation/cancel/index.html @@ -0,0 +1,120 @@ +--- +title: Animation.cancel() +slug: Web/API/Animation/cancel +translation_of: Web/API/Animation/cancel +--- +<p>{{ SeeCompatTable() }}{{ APIRef("Web Animations API") }}</p> + +<p>O método <code><strong>Animation.cancel()</strong></code> da interface {{domxref("Animation")}} , limpa todas as {{domxref("KeyframeEffect", "keyframeEffects")}} geradas pela animação e aborta esta execução.</p> + +<div class="note"> +<p>Quando uma animação é cancelada, os valores de {{domxref("Animation.startTime", "startTime")}} e {{domxref("Animation.currentTime", "currentTime")}} são definidos como <code>null</code>.</p> +</div> + +<h2 id="Sintaxe">Sintaxe</h2> + +<div class="syntaxbox"> +<pre class="brush: js">// cancela animação +animation.cancel();</pre> +</div> + +<h3 id="Parametros">Parametros</h3> + +<p>Nenhum.</p> + +<h3 id="Valor_de_retorno">Valor de retorno</h3> + +<p>Nenhum.</p> + +<dl> +</dl> + +<h3 id="Exceptions">Exceptions</h3> + +<p>Se o método {{domxref("Animation.playState")}} da animação estiver executando quando a operação for cancelada, esta ação vai rejeitar a {{domxref("Animation.finished", "current finished promise")}} com a {{domxref("DOMException")}} nomeada <code>AbortError</code>.</p> + +<dl> +</dl> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('Web Animations', '#dom-animation-cancel', 'Animation.cancel()' )}}</td> + <td>{{Spec2('Web Animations')}}</td> + <td>Editor's draft.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_do_navegador">Compatibilidade do navegador</h2> + +<p>{{CompatibilityTable}}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop(40)}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Android Webview</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>Firefox OS</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{ CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a></li> + <li>{{domxref("KeyframeEffect")}}</li> + <li>{{domxref("Animation")}}</li> + <li>{{domxref("Animation.playState")}}</li> + <li>{{domxref("Animation.finished")}} returns the promise this action will reject if the animation's <code>playState</code> is not <code>idle</code>.</li> +</ul> diff --git a/files/pt-br/web/api/animation/currenttime/index.html b/files/pt-br/web/api/animation/currenttime/index.html new file mode 100644 index 0000000000..e5b7c25559 --- /dev/null +++ b/files/pt-br/web/api/animation/currenttime/index.html @@ -0,0 +1,112 @@ +--- +title: Animation.currentTime +slug: Web/API/Animation/currentTime +translation_of: Web/API/Animation/currentTime +--- +<p>{{APIRef("Web Animations")}}{{SeeCompatTable}}</p> + +<p>A propriedade <code><strong>Animation</strong></code><strong><code>.currentTime</code></strong> da <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a> retorna e altera o tempo atual da animação em milésimos de segundos, seja estando em execução ou pausada.</p> + +<p>Se a animação não tem uma {{domxref("AnimationTimeline", "timeline")}}, está inativa, ou ainda não foi colocada em execução, o valor de retorno do <code>currentTime </code>será<code> null</code>. </p> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">var<em>tempoAtual</em> = <em>Animation</em>.currentTime; +<em>Animation</em>.currentTime =<em> novoTempo;</em></pre> + +<h3 id="Valor">Valor</h3> + +<p>Um número que representará no tempo atual da animação em milésimos de segundos, ou <code>null</code> para desativar a animação.</p> + +<h2 id="Examples">Examples</h2> + +<p>No <a href="http://codepen.io/rachelnabors/pen/PNYGZQ?editors=0010">jogo Drink Me/Eat Me</a>, O tamanho da Alice é animado e pode crescer ou diminuir. No início do jogo, o tamanho dela foi colocado entre os dois extremos do animation's <code>currentTime</code> no meio do <a href="/en-US/docs/Web/API/Web_Animations_API/Animation_timing_options"><code>KeyframeEffect</code>'s duration</a>, desta maneira:</p> + +<pre class="brush: js">aliceChange<strong>.</strong>currentTime = aliceChange.effect.timing.duration / 2;</pre> + +<p>Outra forma mais genérica para encontrar o marco de 50% da animação pode ser feito da seguinte forma:</p> + +<pre class="brush: js">animation.currentTime = + animation.effect.getComputedTiming().delay + + animation.effect.getComputedTiming().activeDuration / 2;</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificações</th> + <th scope="col">Status</th> + <th scope="col">Comentário</th> + </tr> + <tr> + <td>{{SpecName('Web Animations', '#dom-animation-currenttime', 'currentTime')}}</td> + <td>{{Spec2("Web Animations")}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_de_Navegadores">Compatibilidade de Navegadores</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatChrome(39.0)}}</td> + <td>{{CompatGeckoDesktop(48)}}<sup>[1]</sup></td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Android Webview</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Phone</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + <th>Chrome for Android</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(39.0)}}</td> + <td>{{CompatGeckoMobile(48)}}<sup>[1]</sup></td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(39.0)}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] A Web Animations API está ativa por padrão apenas no Firefox Developer Edition e nas versões do Nightly. Você pode habilitá-la em versões beta configurando a preferência <code>dom.animations-api.core.enabled</code> para <code>true</code>, e também desativar em qualquer Firefox mudando esta mesma preferência para <code>false</code>.</p> + +<h2 id="Veja_também" style="line-height: 30px; font-size: 2.14285714285714rem;">Veja também</h2> + +<ul> + <li>{{domxref("Animation")}} para outros métodos e propriedades que você pode usar para controlar a animação da página web.</li> + <li>{{domxref("Animation.startTime")}} para o tempo que a animação está programada começar.</li> + <li><a href="/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a></li> +</ul> diff --git a/files/pt-br/web/api/animation/index.html b/files/pt-br/web/api/animation/index.html new file mode 100644 index 0000000000..09d2f0091c --- /dev/null +++ b/files/pt-br/web/api/animation/index.html @@ -0,0 +1,171 @@ +--- +title: Animation +slug: Web/API/Animation +tags: + - API + - Animations + - Experimental + - Interface + - NeedsTranslation + - Reference + - TopicStub + - Web Animations + - waapi + - web animation api +translation_of: Web/API/Animation +--- +<p>{{ APIRef("Web Animations API") }}{{SeeCompatTable}}</p> + +<p>A interface <strong><code>Animation</code></strong> da <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a> representa um único player de animação e fornece controles e uma linha do tempo (timeline) para um nó de animação ou recurso.</p> + +<h2 id="Construtor">Construtor</h2> + +<dl> + <dt>{{domxref("Animation.Animation()", "Animation()")}}</dt> + <dd>Cria uma nova instância do objeto <code>Animation</code>.</dd> +</dl> + +<h2 id="Propriedades">Propriedades</h2> + +<dl> + <dt>{{domxref("Animation.currentTime")}}</dt> + <dd>O valor do tempo atual da animação, em milissegundos, esteja ela executando ou pausada. Se a animação não tem uma {{domxref("AnimationTimeline", "timeline")}}, está inativa ou ainda não foi executada, este valor é <code>null</code>.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.effect")}}</dt> + <dd>Obtém e define o {{domxref("KeyframeEffect")}} associado a essa animação.</dd> + <dt>{{domxref("Animation.finished")}} {{readOnlyInline}}</dt> + <dd>Retorna a <code>Primise</code> de finalização atual para essa animação.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.id")}}</dt> + <dd>Obtém e define a <code>String</code> usada para identificar a animação.</dd> + <dt>{{domxref("Animation.oncancel")}}</dt> + <dd>Obtém e define o manipulador para o evento <code>cancel</code>.</dd> + <dt>{{domxref("Animation.onfinish")}}</dt> + <dd>Obtém e define o manipulador para o evento <code>finish</code>.</dd> + <dt>{{domxref("Animation.playState")}} {{readOnlyInline}}</dt> + <dd>Retorna um valor enumerado descrevendo o estado de execução de uma animação.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.playbackRate")}}</dt> + <dd>Obtém ou define a taxa de execução da animação.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.ready")}} {{readOnlyInline}}</dt> + <dd>Retorna a promessa atual para quando essa animação estiver pronta.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.startTime")}}</dt> + <dd>Obtém ou define o tempo agendado quando a execução de uma animação deve começar.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.timeline")}}</dt> + <dd>Obtém ou define a {{domxref("AnimationTimeline", "timeline")}} associada a essa animação.</dd> +</dl> + +<h2 id="Métodos">Métodos</h2> + +<dl> + <dt>{{domxref("Animation.cancel()")}}</dt> + <dd>Limpa todos os {{domxref("KeyframeEffect", "keyframeEffects")}} causados por essa animação e aborta sua execução.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.finish()")}}</dt> + <dd>Vai até um dos extremos dessa animação, dependendo se ela está executando ou retornando.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.pause()")}}</dt> + <dd>Suspende a execução de uma animação.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.play()")}}</dt> + <dd>Inicia ou continua a execução de uma animação ou a recomeça se ela tiver terminado anteriormente.</dd> +</dl> + +<dl> + <dt>{{domxref("Animation.reverse()")}}</dt> + <dd>Move a animação ao contrário, parando no início da animação.</dd> +</dl> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Estado</th> + <th scope="col">Comentário</th> + </tr> + <tr> + <td>{{SpecName("Web Animations", "#the-animation-interface", "Animation")}}</td> + <td>{{Spec2("Web Animations")}}</td> + <td>Definição inicial</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_com_navegadores">Compatibilidade com navegadores</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Recurso</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Suporte básico</td> + <td>{{CompatChrome(39.0)}} [1]</td> + <td>{{CompatGeckoDesktop(40.0)}} [2]</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Recurso</th> + <th>Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Phone</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Suporte básico</td> + <td>{{CompatVersionUnknown}} [1]</td> + <td>{{CompatGeckoDesktop(40.0)}} [2]</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Implementado como <code>AnimationPlayer</code> (nome da interface em uma versão primária da especificação).</p> + +<p>[2] Anteriormente ao Firefox 40, estava disponível como <code>AnimationPlayer</code>. Em ambos os casos, é necessário definir a preferência <code>dom.animations-api.core.enabled</code> para poder usá-la.</p> + +<p> </p> diff --git a/files/pt-br/web/api/animation/playstate/index.html b/files/pt-br/web/api/animation/playstate/index.html new file mode 100644 index 0000000000..a31d8d7c64 --- /dev/null +++ b/files/pt-br/web/api/animation/playstate/index.html @@ -0,0 +1,152 @@ +--- +title: Animation.playState +slug: Web/API/Animation/playState +translation_of: Web/API/Animation/playState +--- +<p>{{APIRef("Web Animations")}}{{SeeCompatTable}}</p> + +<p><br> + A propriedade <code><strong>Animation</strong></code><strong><code>.playState</code></strong> do <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a> retorna e altera um valor enumerado que descreve o estado de reprodução da animação.</p> + +<div class="note"> +<p>Essa propriedade é apenas de leitura para Animações CSS e Transições.</p> +</div> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">var<em> estadoAtualDaReproducao</em> = <em>Animation</em>.playState; + +<em>Animation</em>.playState =<em>novoEstado</em>; +</pre> + +<h3 id="Valor">Valor</h3> + +<dl> + <dt><code>idle</code></dt> + <dd>O tempo atual da animação não está acertado e não há tarefas pendentes.</dd> + <dt><code>pending</code></dt> + <dd>A animação está aguardando a realização de algumas tarefas para ser completada.</dd> + <dt><code>running</code></dt> + <dd>A animação está rodando.</dd> + <dt><code>paused</code></dt> + <dd>A animação está parada e a propriedade {{domxref("Animation.currentTime")}} não está sendo atualizada.</dd> + <dt><code>finished</code></dt> + <dd>A animação alcançou um de seus finais e a propriedade {{domxref("Animation.currentTime")}} não está sendo atualizada.</dd> +</dl> + +<h2 id="Exemplo">Exemplo</h2> + +<p>No <a href="http://codepen.io/rachelnabors/pen/PNYGZQ?editors=0010">jogo</a> <a href="http://codepen.io/rachelnabors/pen/PNYGZQ?editors=0010">Growing/Shrinking Alice Game</a> , os jogadores podem chegar ao final com a <a href="http://codepen.io/rachelnabors/pen/EPJdJx?editors=0010">Alice chorando em uma poça de lágrimas</a>. No jogo, por razões de performance, as lágrimas só são animadas quando estão visiveis. Então elas devem ficar pausadas enquanto a animação ocorre, como no exemplo:</p> + +<pre class="brush: js">// Configurando a animação das lágrimas + +tears.forEach(function(el) { + el.animate( + tearsFalling, + { + delay: getRandomMsRange(-1000, 1000), // aleatório para cada lágrima + duration: getRandomMsRange(2000, 6000), // aleatório para cada lágrima + iterations: Infinity, + easing: "cubic-bezier(0.6, 0.04, 0.98, 0.335)" + }); + el.playState = 'paused'; +}); + + +// Rodar as lágrimas caindo quando o final precisa aparecer. + +tears.forEach(function(el) { + el.playState = 'playing'; +}); + + +// Reseta a animação e coloca o estado em pause. + +tears.forEach(function(el) { + el.playState = "paused"; + el.currentTime = 0; +}); +</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificações</th> + <th scope="col">Status</th> + <th scope="col">Comentários</th> + </tr> + <tr> + <td>{{SpecName('Web Animations', '#play-state', 'playState')}}</td> + <td>{{Spec2("Web Animations")}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_de_Navegadores">Compatibilidade de Navegadores</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatChrome(39.0)}} [1]</td> + <td>{{CompatGeckoDesktop(48)}}<sup>[2]</sup></td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Android Webview</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo}}</td> + <td>{{CompatChrome(39.0)}} [1]</td> + <td>{{CompatChrome(39.0)}} [1]</td> + <td>{{CompatGeckoMobile(48)}}<sup>[2]</sup></td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Antes do Chrome 50, este atributo retorna <code>idle</code> para animações que ainda não foram reproduzidas . A partir do Chrome 50, ele retorna <code>paused</code>.</p> + +<p>[2] A Web Animations API está ativa por padrão apenas no Firefox Developer Edition e nas versões do Nightly. Você pode habilitá-la em versões beta configurando a preferência <code>dom.animations-api.core.enabled</code> para <code>true</code>, e também desativar em qualquer Firefox mudando esta mesma preferência para <code>false</code>.</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a></li> + <li>{{domxref("Animation")}} para outros métodos e propriedades que você pode usar para controlar a animação da página web.</li> + <li>Os métodos {{domxref("Animation.play()")}}, {{domxref("Animation.pause()")}}, {{domxref("Animation.finish()")}} conseguem alterar o <code>Animation</code>'s <code>playState</code>.</li> +</ul> |