Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła