Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onprogress — obsługa zdarzenia postępu pobierania

Atrybut onprogress zawiera kod JavaScript obsługujący zdarzenie progress. Przy elementach audio i video dotyczy pobierania danych multimedialnych, a nie upływu czasu odtwarzania.

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

Składnia

onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);

onprogress to atrybut obsługi zdarzenia progress. Jest dostępny na wszystkich elementach HTML, ale sama jego obecność nie powoduje pobierania ani generowania zdarzeń. Odpowiadająca mu właściwość JavaScript jest dostępna także na obiektach Document i Window.

W przypadku audio i video zdarzenie progress informuje o pobieraniu danych multimedialnych. Nie oznacza postępu odtwarzania ani nie dostarcza automatycznie procentu pobranych bajtów. Zdarzenie multimedialne używa interfejsu Event, nie ProgressEvent; nie należy zakładać dostępności loaded i total.

Wartością atrybutu jest kod JavaScript, w którym event oznacza zdarzenie. Alternatywnie przypisz funkcję do element.onprogress albo użyj element.addEventListener("progress", handler). Przypisanie do właściwości zastępuje dotychczasową funkcję tego mechanizmu; addEventListener() pozwala rejestrować niezależne nasłuchy.

Przykład jawnie wysyła syntetyczne zdarzenie progress, więc wynik nie zależy od sieci. Sprawdza obsługę atrybutu, a nie rzeczywisty postęp pobierania. Polityka Content Security Policy może blokować kod w atrybutach i skrypty osadzone.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>

Wynik

progress

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

Źródła