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

CKTIS / HTML

onseeked — tratar o fim de um salto na reprodução

O atributo onseeked especifica o código JavaScript a executar para o evento seeked. Nos elementos audio e video, este evento assinala o fim de uma operação de salto, e não o fim da reprodução.

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

Sintaxe

onseeked="JavaScript"

onseeked é um atributo de tratamento do evento seeked. O seu valor contém código JavaScript. Uma utilização comum é atualizar a interface quando termina uma operação de salto num elemento audio ou video.

Quando se efetua um salto, seeked assinala que a operação terminou e que a propriedade seeking passou a false. Um salto para a posição de reprodução atual pode terminar e disparar seeked sem que a posição se altere. Em contrapartida, o evento seeking assinala o início de uma operação de salto. O fim do salto não significa que o conteúdo multimédia tenha chegado ao fim, nem garante que a reprodução esteja a decorrer.

Não confundas o nome do atributo onseeked com o nome do evento seeked. Em JavaScript, também podes atribuir uma função a media.onseeked ou registar um listener com media.addEventListener('seeked', handler). O atributo recebe código, enquanto à propriedade se atribui uma função.

O exemplo envia deliberadamente um evento sintético sem um ficheiro multimédia. O resultado seeked confirma apenas que o handler foi executado; não demonstra que tenha ocorrido uma operação de salto real. Abre o ficheiro localmente num browser com JavaScript e handlers de eventos inline ativados.

Exemplos

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

Resultado

seeked

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