Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje