CKTIS / HTML
oncanplay — gestire la disponibilità dei contenuti multimediali per la riproduzione
L’attributo oncanplay contiene JavaScript che viene eseguito quando si verifica l’evento canplay. Per audio e video, segnala che la riproduzione può iniziare o riprendere, ma non garantisce che l’intera risorsa possa essere riprodotta senza interruzioni dovute al buffering.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>oncanplay è un attributo di contenuto gestore di eventi per canplay. Il suo valore è codice JavaScript; il gestore ha accesso all’oggetto event. L’attributo è consentito su tutti gli elementi HTML, ma il suo uso tipico è reagire alla disponibilità degli elementi audio e video.
Il browser genera canplay quando lo stato di disponibilità del contenuto multimediale passa da un livello inferiore a HAVE_FUTURE_DATA o superiore. Sono quindi disponibili dati per continuare la riproduzione, ma non necessariamente abbastanza per riprodurre l’intera risorsa senza buffering. canplaythrough, invece, indica che si stima possibile riprodurre il contenuto fino alla fine senza fermarsi per il buffering. canplay da solo non significa che la riproduzione sia già in corso.
In HTML, usa oncanplay="handler(event)"; in JavaScript, assegna una funzione a media.oncanplay oppure chiama media.addEventListener('canplay', handler). Il nome dell’evento non include il prefisso on. L’esempio genera un evento sintetico: verifica il collegamento tra l’attributo e il suo gestore, non la disponibilità effettiva del contenuto multimediale.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplay'));
</script>Risultato
canplay
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.