CKTIS / HTML
onended — gestire la fine della riproduzione
L’attributo onended contiene JavaScript che viene eseguito quando si riceve un evento ended. Sugli elementi audio e video, permette di reagire quando il contenuto multimediale raggiunge la fine, non quando la riproduzione viene semplicemente messa in pausa.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>onended è un attributo di contenuto per la gestione dell’evento ended. Il suo valore è il corpo di una funzione JavaScript, non l’URL di un file né il solo nome di una funzione. È possibile usare event per esaminare l’evento.
Per audio e video, il browser genera ended quando la riproduzione in avanti raggiunge la fine del contenuto multimediale. Chiamare pause() da solo non significa che la riproduzione sia terminata. Se è impostato loop, quando la riproduzione in avanti raggiunge la fine, torna all’inizio invece di generare questo evento.
È importante distinguere l’attributo HTML onended, la proprietà JavaScript media.onended che contiene una funzione gestore e la proprietà di stato booleana media.ended. Un’alternativa all’attributo è media.addEventListener('ended', handler); il nome dell’evento non ha il prefisso on.
L’esempio genera intenzionalmente un evento sintetico, quindi non richiede un file multimediale. Verifica il collegamento del gestore, non l’effettivo completamento della riproduzione. Le norme di sicurezza di una pagina possono bloccare il codice del gestore di eventi inline.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>onended test</title>
<audio id="media" onended="document.getElementById('result').textContent = event.type"></audio>
<output id="result">waiting</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('ended'));
</script>Risultato
ended
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.