CKTIS / HTML
onended — tratar o fim da reprodução
O atributo onended contém JavaScript executado quando é recebido um evento ended. Nos elementos audio e video, permite reagir quando o conteúdo multimédia chega ao fim, e não quando a reprodução é simplesmente colocada em pausa.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>onended é um atributo de conteúdo de tratamento do evento ended. O seu valor é o corpo de uma função JavaScript, não o URL de um ficheiro nem apenas o nome de uma função. Pode utilizar event para examinar o evento.
Em audio e video, o navegador desencadeia ended quando a reprodução para a frente chega ao fim do conteúdo multimédia. Chamar pause() não significa, por si só, que a reprodução terminou. Se loop estiver definido, ao chegar ao fim durante a reprodução para a frente, a reprodução volta ao início em vez de desencadear este evento.
É importante distinguir o atributo HTML onended, a propriedade JavaScript media.onended, que contém uma função de tratamento, e a propriedade de estado booleana media.ended. Uma alternativa ao atributo é media.addEventListener('ended', handler); o nome do evento não tem o prefixo on.
O exemplo desencadeia deliberadamente um evento sintético, pelo que não precisa de um ficheiro multimédia. Verifica a ligação do tratamento, não o fim efetivo da reprodução. A política de segurança de uma página pode bloquear o código de tratamento de eventos inline.
Exemplos
<!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>Resultado
ended
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.