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

CKTIS / HTML

onloadeddata — gerir dados multimédia disponíveis

O atributo onloadeddata executa código quando ocorre o evento loadeddata, assim que os dados da posição de reprodução atual de áudio ou vídeo ficam disponíveis pela primeira vez. Não significa que o ficheiro inteiro tenha sido transferido nem que a reprodução tenha começado.

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

Sintaxe

<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;

onloadeddata é um atributo HTML de tratamento do evento loadeddata. Está disponível nos elementos HTML, mas é usado sobretudo com audio e video. O seu valor é código JavaScript, não um valor booleano.

O navegador desencadeia loadeddata quando consegue apresentar pela primeira vez dados na posição de reprodução atual durante o carregamento: readyState atinge HAVE_CURRENT_DATA (2) ou um estado superior. No caso de vídeo, isto significa que o fotograma atual está disponível, não o filme inteiro. loadedmetadata diz respeito aos metadados, enquanto canplay indica que a reprodução pode avançar pelo menos um pouco. O próprio loadeddata não inicia a reprodução.

Em JavaScript, atribua uma função a media.onloadeddata; uma atribuição posterior substitui o tratamento anterior nesse espaço. Em alternativa, use media.addEventListener('loadeddata', handler). O nome do evento não tem o prefixo on. A Content Security Policy pode bloquear os tratamentos escritos diretamente nos atributos.

O exemplo desencadeia deliberadamente um evento sintético. Testa a ligação entre o atributo e o tratamento, bem como a atualização do texto, mas não testa a descodificação nem a disponibilidade dos conteúdos multimédia.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  // Synthetic event: tests the handler, not media loading.
  document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>

Resultado

loadeddata

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