CKTIS / HTML
onloadedmetadata — zpracování načtení metadat médií
Atribut onloadedmetadata obsahuje JavaScript, který zpracovává událost loadedmetadata, obvykle u audio nebo video. Oznamuje dostupnost metadat, nikoli dokončení stahování nebo připravenost k nepřerušovanému přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onloadedmetadata="JavaScript statements"onloadedmetadata je atribut HTML pro zpracování události loadedmetadata. Jeho hodnota je kód JavaScriptu, nikoli název události nebo logická hodnota. Je povolen u prvků HTML, typicky se však používá u audio a video.
Prohlížeč vyvolá loadedmetadata, jakmile jsou metadata načítaného zdroje poprvé k dispozici: readyState dosáhne alespoň HAVE_METADATA. Poté lze číst duration a u videa také videoWidth a videoHeight. Doba trvání může být Infinity, pokud zdroj nemá známý konec. Neznamená to, že se stáhl celý soubor; loadeddata se týká dostupnosti dat aktuálního snímku.
V kódu atributu označuje event událost a this prvek. V JavaScriptu lze místo toho přiřadit funkci k media.onloadedmetadata nebo použít media.addEventListener('loadedmetadata', handler). Název události nemá předponu on. Přiřazení vlastnosti nahradí její předchozí funkci; addEventListener umožňuje nezávislé obslužné rutiny. Zásady CSP mohou blokovat kód v atributech.
Příklad záměrně vyvolá syntetickou událost, aby otestoval atribut bez mediálního souboru. Nenačte metadata ani nezmění readyState. Při skutečném načítání médií zaregistrujte obslužnou rutinu před zahájením načítání zdroje.
Příklady
<!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>Výsledek
loadedmetadata handled
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.