CKTIS / HTML
onloadedmetadata — obsługa wczytania metadanych multimediów
Atrybut onloadedmetadata zawiera kod JavaScript obsługujący zdarzenie loadedmetadata, zwykle na audio lub video. Sygnalizuje dostępność metadanych, a nie pobranie całego pliku ani gotowość do płynnego odtwarzania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onloadedmetadata="JavaScript statements"onloadedmetadata to atrybut HTML obsługi zdarzenia loadedmetadata. Jego wartością jest kod JavaScript, nie nazwa zdarzenia ani wartość logiczna. Jest dozwolony na elementach HTML, lecz jego typowe zastosowanie dotyczy audio i video.
Przeglądarka emituje loadedmetadata, gdy po raz pierwszy dla ładowanego zasobu dostępne są metadane: readyState osiąga co najmniej HAVE_METADATA. Można wtedy odczytać duration, a dla filmu także videoWidth i videoHeight. Czas trwania może wynosić Infinity, jeśli zasób nie ma znanego końca. Nie oznacza to pobrania całego pliku; loadeddata dotyczy dostępności danych bieżącej klatki.
W kodzie atrybutu event oznacza zdarzenie, a this — element. W JavaScript można zamiast atrybutu przypisać funkcję do media.onloadedmetadata albo użyć media.addEventListener('loadedmetadata', handler). Nazwa zdarzenia nie zawiera prefiksu on. Przypisanie właściwości zastępuje jej dotychczasową funkcję; addEventListener umożliwia niezależne procedury obsługi. Polityka CSP może blokować kod w atrybutach.
Przykład celowo wysyła syntetyczne zdarzenie, aby bez pliku multimedialnego sprawdzić uruchomienie atrybutu. Nie ładuje metadanych ani nie zmienia readyState. Przy rzeczywistym ładowaniu zarejestruj obsługę przed rozpoczęciem pobierania zasobu.
Przykłady
<!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>Wynik
loadedmetadata handled
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.