CKTIS / HTML
onplaying — gerir a disponibilidade para reprodução
O atributo onplaying contém código que gere o evento playing, usado por áudio e vídeo quando a reprodução está pronta para começar ou ser retomada após uma interrupção. Não inicia a reprodução e não é equivalente a onplay.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };onplaying é um atributo de gestão do evento playing. Está disponível como atributo HTML em todos os elementos HTML, mas a sua utilização típica diz respeito aos elementos audio e video. O seu valor é código JavaScript, não um endereço de ficheiro nem um valor booleano.
O evento playing indica que a reprodução está pronta para começar após uma pausa ou um atraso causado por dados insuficientes. Em contrapartida, play assinala que paused mudou para false. playing pode ocorrer novamente após o armazenamento em buffer; não garante uma reprodução ininterrupta nem que o som seja audível.
Em JavaScript, pode atribuir uma função a media.onplaying; uma atribuição posterior substitui a função anterior desse gestor. Em alternativa, pode usar media.addEventListener('playing', handler). Configurar um gestor não inicia, por si só, a reprodução.
O exemplo envia um evento playing sintético para testar o atributo sem um ficheiro multimédia. O texto esperado é playing. Isto não testa a reprodução real; requer que os scripts estejam ativados e que os gestores de eventos inline sejam permitidos.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>onplaying test</title>
<audio id="media" onplaying="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('playing'));
</script>Resultado
playing
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.