CKTIS / HTML
onloadedmetadata — spracovanie načítania metadát médií
Atribút onloadedmetadata obsahuje JavaScript, ktorý spracúva udalosť loadedmetadata, zvyčajne na audio alebo video. Signalizuje dostupnosť metadát, nie dokončenie sťahovania ani pripravenosť na plynulé prehrávanie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onloadedmetadata="JavaScript statements"onloadedmetadata je atribút HTML na spracovanie udalosti loadedmetadata. Jeho hodnota je kód JavaScriptu, nie názov udalosti ani logická hodnota. Je povolený na prvkoch HTML, typicky sa však používa pri audio a video.
Prehliadač vyvolá loadedmetadata, keď sú metadáta načítavaného zdroja prvýkrát dostupné: readyState dosiahne aspoň HAVE_METADATA. Potom možno čítať duration a pri videu aj videoWidth a videoHeight. Trvanie môže byť Infinity, ak zdroj nemá známy koniec. Neznamená to, že sa stiahol celý súbor; loadeddata sa týka dostupnosti údajov aktuálnej snímky.
V kóde atribútu označuje event udalosť a this prvok. V JavaScripte možno namiesto toho priradiť funkciu k media.onloadedmetadata alebo použiť media.addEventListener('loadedmetadata', handler). Názov udalosti nemá predponu on. Priradenie vlastnosti nahradí jej predchádzajúcu funkciu; addEventListener umožňuje nezávislé obslužné rutiny. Politika CSP môže blokovať kód v atribútoch.
Príklad zámerne vyvolá syntetickú udalosť, aby otestoval atribút bez mediálneho súboru. Nenačíta metadáta ani nezmení readyState. Pri skutočnom načítavaní médií zaregistrujte obslužnú rutinu pred začatím získavania zdroja.
Prí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ýsledok
loadedmetadata handled
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.