CKTIS / HTML
onratechange — gestire le modifiche della velocità di riproduzione
L’attributo onratechange specifica il codice JavaScript che gestisce l’evento ratechange, attivato dopo la modifica di playbackRate o defaultPlaybackRate di un elemento multimediale.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<audio onratechange="JavaScript statements"></audio>
<video onratechange="JavaScript statements"></video>onratechange è l’attributo gestore dell’evento ratechange. È disponibile su tutti gli elementi HTML, ma si applica soprattutto a audio e video. Il suo valore è il corpo di una funzione JavaScript, non il nome di un evento né un valore booleano.
Il browser accoda l’evento quando cambia playbackRate o defaultPlaybackRate. playbackRate rappresenta la velocità di riproduzione effettiva: 1 indica la velocità normale e 1.5 una volta e mezzo la velocità normale. defaultPlaybackRate specifica la velocità predefinita; modificarla non cambia di per sé la velocità di riproduzione effettiva.
Nel codice dell’attributo, this fa riferimento all’elemento e event fornisce l’evento. La proprietà JavaScript corrispondente, media.onratechange, accetta una funzione o null; assegnare una funzione sostituisce il gestore precedente in quello slot. In alternativa si può usare media.addEventListener('ratechange', handler). CSP può bloccare il codice negli attributi gestori di eventi.
L’esempio modifica la velocità senza caricare un file né avviare la riproduzione. Il risultato appare quando viene gestito l’evento accodato, non in modo sincrono durante l’assegnazione.
Esempi
<!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>Risultato
ratechange: 1.5
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.