Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onseeked — obsługa zakończenia przewijania multimediów

Atrybut onseeked określa kod JavaScript wykonywany po zdarzeniu seeked. W elementach audio i video zdarzenie to sygnalizuje zakończenie operacji przewijania, a nie koniec odtwarzania materiału.

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

Składnia

onseeked="JavaScript"

onseeked jest atrybutem obsługi zdarzenia seeked. Jego wartość zawiera kod JavaScript. Typowe zastosowanie to aktualizacja interfejsu po zakończeniu przewijania w elemencie audio lub video.

Przy rzeczywistym przewijaniu zdarzenie seeked sygnalizuje zakończenie operacji i przejście właściwości seeking na false. Ustawienie pozycji odtwarzania na jej bieżącą wartość również może wywołać seeked, mimo że pozycja się nie zmieniła. Dla porównania zdarzenie seeking sygnalizuje rozpoczęcie operacji przewijania. Zakończenie przewijania nie oznacza końca materiału ani nie gwarantuje, że odtwarzanie trwa.

Nie myl nazwy atrybutu onseeked z nazwą zdarzenia seeked. W JavaScript można również przypisać funkcję do media.onseeked albo zarejestrować nasłuchiwanie przez media.addEventListener('seeked', handler). W atrybucie podaje się kod, a przy przypisaniu do właściwości — funkcję.

Przykład celowo wysyła syntetyczne zdarzenie bez pliku multimedialnego. Wynik seeked potwierdza jedynie wywołanie obsługi; nie dowodzi faktycznego przewinięcia. Uruchom plik lokalnie w przeglądarce z włączonym JavaScript i obsługą zdarzeń zapisanych w atrybutach.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>onseeked</title>
<audio id="media" onseeked="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('seeked'));
</script>

Wynik

seeked

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

Źródła