Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes