Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje