Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onloadeddata — obsługa dostępności danych multimedialnych

Atrybut onloadeddata uruchamia kod przy zdarzeniu loadeddata, gdy po raz pierwszy dostępne są dane dla bieżącej pozycji odtwarzania audio lub wideo. Nie oznacza pobrania całego pliku ani rozpoczęcia odtwarzania.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;

onloadeddata jest atrybutem HTML obsługującym zdarzenie loadeddata. Jest dostępny na elementach HTML, lecz naturalnie dotyczy przede wszystkim audio i video. Jego wartością jest kod JavaScript, a nie wartość logiczna.

Przeglądarka zgłasza loadeddata, gdy podczas ładowania po raz pierwszy może wyrenderować dane dla bieżącej pozycji: readyState osiąga HAVE_CURRENT_DATA (2) lub wyższy stan. Dla wideo oznacza to dostępność bieżącej klatki, nie całego filmu. loadedmetadata dotyczy metadanych, a canplay oznacza możliwość przynajmniej krótkiego dalszego odtwarzania. Samo loadeddata nie rozpoczyna odtwarzania.

W JavaScript można przypisać funkcję do media.onloadeddata; kolejne przypisanie zastępuje poprzednią obsługę w tym miejscu. Alternatywą jest media.addEventListener('loadeddata', handler). Nazwa zdarzenia nie zawiera prefiksu on. Polityka Content Security Policy może blokować obsługę zapisaną bezpośrednio w atrybucie.

Przykład celowo wysyła syntetyczne zdarzenie. Sprawdza powiązanie atrybutu z obsługą i aktualizację tekstu, ale nie sprawdza dekodowania ani gotowości multimediów.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  // Synthetic event: tests the handler, not media loading.
  document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>

Wynik

loadeddata

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła