CKTIS / HTML
onplay — tratar o evento play
O atributo onplay contém JavaScript executado quando ocorre o evento play, normalmente num elemento audio ou video. Este evento indica a saída do estado de pausa, mas não garante que o som ou o vídeo já esteja a ser reproduzido.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onplay="JavaScript statements"onplay é um atributo de conteúdo de tratamento de eventos para play. O seu valor é o corpo de uma função JavaScript, não o endereço de um ficheiro nem um atributo booleano. É normalmente utilizado nos elementos audio e video; adicionar o atributo não inicia a reprodução.
O navegador dispara play quando paused muda de true para false, por exemplo através de play() ou autoplay. Isto ainda não significa que esteja a ocorrer reprodução efetiva: os dados podem não estar disponíveis. O evento playing, tratado através de onplaying, diz respeito ao início ou à retoma da reprodução depois de esta parar por falta de dados.
Em JavaScript, atribua uma função a media.onplay ou utilize media.addEventListener('play', handler). A atribuição à propriedade substitui a função anterior nesse espaço de tratamento do evento. A Content Security Policy pode bloquear código escrito diretamente no atributo.
O exemplo dispara um play sintético, pelo que não precisa de um ficheiro multimédia. O texto esperado é play; isto testa a ligação do tratamento do evento, não a reprodução.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>Resultado
play
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.