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.