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

CKTIS / HTML

onseeking — tratar o início de uma operação de posicionamento em áudio ou vídeo

`onseeking` especifica o código que trata o evento `seeking`. O evento assinala o início de uma operação de posicionamento em áudio ou vídeo, mesmo que a posição de reprodução não mude. Não assinala a conclusão da operação.

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

Sintaxe

HTML: onseeking="JavaScript code"
JavaScript: media.onseeking = handler;

onseeking é um atributo de tratamento do evento seeking. Nos elementos audio e video, o navegador emite este evento quando inicia uma operação de posicionamento. O evento pode ocorrer mesmo que a posição de destino seja a posição de reprodução atual e esta permaneça inalterada. A operação pode ser iniciada ao utilizar a barra de progresso ou ao definir currentTime num script.

O valor do atributo HTML é código JavaScript, não um nome de evento nem um endereço de ficheiro. A propriedade JavaScript correspondente, media.onseeking, aceita uma função de tratamento; atribuir outra função substitui a anterior. Para adicionar ouvintes independentes, utiliza addEventListener('seeking', handler).

Distingue seeking de seeked: o primeiro assinala o início da operação de posicionamento, enquanto o segundo assinala a sua conclusão. A propriedade media.seeking descreve o estado da operação; uma atribuição a onseeking, por si só, não altera a posição de reprodução.

O exemplo emite deliberadamente um evento sintético sem um ficheiro multimédia. Verifica se a função definida pelo atributo está associada ao evento, sem realizar uma operação de posicionamento real. A política de segurança de uma página pode bloquear scripts inline e funções de tratamento de eventos escritas diretamente no HTML.

Exemplos

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

Resultado

seeking

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