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.