CKTIS / HTML
onratechange — gerir alterações na velocidade de reprodução
O atributo onratechange especifica o código JavaScript que gere o evento ratechange, acionado após uma alteração de playbackRate ou defaultPlaybackRate de um elemento multimédia.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<audio onratechange="JavaScript statements"></audio>
<video onratechange="JavaScript statements"></video>onratechange é o atributo de tratamento do evento ratechange. Está disponível em todos os elementos HTML, mas aplica-se sobretudo a audio e video. O seu valor é o corpo de uma função JavaScript, não o nome de um evento nem um valor booleano.
O navegador coloca o evento na fila quando playbackRate ou defaultPlaybackRate muda. playbackRate representa a velocidade de reprodução efetiva: 1 significa velocidade normal e 1.5 significa uma vez e meia a velocidade normal. defaultPlaybackRate especifica a velocidade predefinida; alterá-la não muda, por si só, a velocidade de reprodução efetiva.
No código do atributo, this refere-se ao elemento e event disponibiliza o evento. A propriedade JavaScript correspondente, media.onratechange, aceita uma função ou null; atribuir uma função substitui o controlador anterior nesse espaço. Uma alternativa é media.addEventListener('ratechange', handler). A CSP pode bloquear código nos atributos de tratamento de eventos.
O exemplo altera a velocidade sem carregar um ficheiro nem iniciar a reprodução. O resultado aparece quando o evento colocado na fila é tratado, e não de forma síncrona durante a atribuição.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onratechange demo</title>
<audio id="media" onratechange="document.getElementById('result').textContent = event.type + ': ' + this.playbackRate;"></audio>
<output id="result">Waiting</output>
<script>
document.getElementById('media').playbackRate = 1.5;
</script>
</html>Resultado
ratechange: 1.5
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.