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

CKTIS / HTML

onpause — gestor do evento de pausa de multimédia

O atributo onpause contém JavaScript que trata o evento pause, normalmente num elemento audio ou video. Reage à pausa da reprodução, mas não pausa a reprodução por si próprio.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);

onpause é um atributo global de tratamento do evento pause. Embora esteja disponível em todos os elementos HTML, é normalmente utilizado para tratar pausas em elementos audio e video. O seu valor é código JavaScript, não um valor booleano.

Durante a pausa normal de um elemento multimédia, paused passa a true e o evento é enviado numa tarefa colocada em fila. Chamar pause() num elemento que já está em pausa não gera outro evento pause. O evento não se propaga para cima e não pode ser cancelado; return false não impede a pausa.

No código do atributo, event representa o evento e this refere-se ao elemento. A propriedade JavaScript media.onpause aceita uma função ou null; uma nova atribuição substitui a função anterior. media.addEventListener("pause", handler) permite registar gestores independentes. Uma política CSP pode bloquear o código dos atributos.

O exemplo envia um evento pause sintético para verificar a ligação do atributo sem um ficheiro multimédia. O texto esperado é pause. Este teste não inicia nem pausa a reprodução e não verifica uma transição real do estado do elemento multimédia.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('pause'));
</script>

Resultado

pause

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