CKTIS / HTML
onloadedmetadata — gerir o carregamento de metadados multimédia
O atributo onloadedmetadata contém JavaScript que gere o evento loadedmetadata, geralmente em audio ou video. Indica que os metadados estão disponíveis, não que a transferência terminou ou que a reprodução pode decorrer sem interrupções.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onloadedmetadata="JavaScript statements"onloadedmetadata é um atributo HTML para gerir o evento loadedmetadata. O seu valor é código JavaScript, não o nome de um evento nem um valor booleano. É permitido em elementos HTML, mas é normalmente usado com audio e video.
O navegador dispara loadedmetadata quando os metadados do recurso em carregamento ficam disponíveis pela primeira vez: readyState atinge, pelo menos, HAVE_METADATA. Pode então ler duration e, no caso de vídeo, videoWidth e videoHeight. A duração pode ser Infinity se o recurso não tiver um fim conhecido. Isto não significa que o ficheiro inteiro tenha sido transferido; loadeddata diz respeito à disponibilidade dos dados do fotograma atual.
No código do atributo, event representa o evento e this o elemento. Em JavaScript, pode, em alternativa, atribuir uma função a media.onloadedmetadata ou usar media.addEventListener('loadedmetadata', handler). O nome do evento não tem o prefixo on. Atribuir à propriedade substitui a função anterior; addEventListener permite manipuladores independentes. Uma política CSP pode bloquear código nos atributos.
O exemplo dispara deliberadamente um evento sintético para testar o atributo sem um ficheiro multimédia. Não carrega metadados nem altera readyState. Para o carregamento real de multimédia, registe o manipulador antes de iniciar a obtenção do recurso.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadedmetadata demo</title>
<audio id="media" onloadedmetadata="document.getElementById('result').textContent = event.type + ' handled'"></audio>
<p id="result">Waiting</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('loadedmetadata'));
</script>
</html>Resultado
loadedmetadata handled
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.