CKTIS / HTML
onloadedmetadata — obravnava nalaganja metapodatkov predstavnosti
Atribut onloadedmetadata vsebuje JavaScript za obravnavo dogodka loadedmetadata, običajno pri audio ali video. Označuje, da so metapodatki na voljo, ne pa, da je prenos končan ali da je predvajanje pripravljeno na nemoteno delovanje.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onloadedmetadata="JavaScript statements"onloadedmetadata je atribut HTML za obravnavo dogodka loadedmetadata. Njegova vrednost je koda JavaScript, ne ime dogodka ali logična vrednost. Dovoljen je na elementih HTML, vendar se običajno uporablja pri audio in video.
Brskalnik sproži loadedmetadata, ko so metapodatki nalaganega vira prvič na voljo: readyState doseže vsaj HAVE_METADATA. Nato lahko preberete duration in pri videu tudi videoWidth ter videoHeight. Trajanje je lahko Infinity, če vir nima znanega konca. To ne pomeni, da je bila prenesena celotna datoteka; loadeddata se nanaša na razpoložljivost podatkov trenutne sličice.
V kodi atributa event pomeni dogodek, this pa element. V JavaScriptu lahko namesto tega funkcijo dodelite media.onloadedmetadata ali uporabite media.addEventListener('loadedmetadata', handler). Ime dogodka nima predpone on. Dodelitev lastnosti zamenja njeno prejšnjo funkcijo; addEventListener omogoča neodvisne obravnavalnike. Pravilnik CSP lahko blokira kodo v atributih.
Primer namenoma sproži sintetični dogodek, da preizkusi atribut brez predstavnostne datoteke. Ne naloži metapodatkov in ne spremeni readyState. Pri dejanskem nalaganju predstavnosti registrirajte obravnavalnik, preden začnete pridobivati vir.
Primeri
<!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>Rezultat
loadedmetadata handled
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.