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.