Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

ondurationchange — obsługa zmiany czasu trwania multimediów

Atrybut ondurationchange zawiera kod JavaScript uruchamiany przy zdarzeniu durationchange. Służy zwykle do aktualizowania informacji o długości nagrania w elementach audio i video; nie informuje o bieżącym postępie odtwarzania.

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

Składnia

ondurationchange="JavaScript statements"

ondurationchange jest atrybutem obsługi zdarzenia durationchange, zwykle używanym z elementami audio i video. Jego wartością jest kod JavaScript, a nie wartość logiczna ani sam czas trwania. W procedurze zapisanej w atrybucie this wskazuje element, a event udostępnia zdarzenie.

Przeglądarka wywołuje to zdarzenie, gdy zmienia się ustalona długość zasobu, na przykład gdy staje się znana albo zostaje skorygowana. Odczytaj this.duration: wynik jest wyrażony w sekundach, NaN oznacza brak dostępnych danych, a Infinity — nieograniczony czas trwania. To nie jest zdarzenie postępu odtwarzania; do tego służy timeupdate.

W JavaScript można zamiast atrybutu przypisać funkcję do media.ondurationchange albo użyć media.addEventListener('durationchange', handler). Nazwa zdarzenia nie zawiera przedrostka on. Przypisanie właściwości zastępuje dotychczasową procedurę tego slotu; addEventListener pozwala dodawać niezależne procedury. Polityka CSP może blokować kod zapisany bezpośrednio w atrybucie.

Przykład wysyła syntetyczne zdarzenie bez pobierania nagrania. Sprawdza połączenie atrybutu z procedurą, nie wykrywanie rzeczywistej zmiany długości. Nie zmienia duration, więc oczekiwany tekst to durationchange: NaN.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('durationchange'));
</script>

Wynik

durationchange: NaN

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

Źródła