Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onseeking — obsługa rozpoczęcia przewijania multimediów

`onseeking` określa kod obsługujący zdarzenie `seeking`, które sygnalizuje rozpoczęcie przewijania audio lub wideo, nawet jeśli pozycja odtwarzania się nie zmienia. Nie oznacza zakończenia tej operacji.

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

Składnia

HTML: onseeking="JavaScript code"
JavaScript: media.onseeking = handler;

onseeking jest atrybutem obsługi zdarzenia seeking. W przypadku elementów audio i video przeglądarka wywołuje to zdarzenie, gdy rozpoczyna operację przewijania. Zdarzenie może wystąpić również wtedy, gdy pozycją docelową jest bieżąca pozycja odtwarzania i nie dochodzi do jej zmiany. Operację można rozpocząć za pomocą suwaka lub ustawiając currentTime w skrypcie.

Wartością atrybutu HTML jest kod JavaScript, a nie nazwa zdarzenia ani adres pliku. Odpowiadająca mu właściwość JavaScript, media.onseeking, przyjmuje funkcję obsługi; przypisanie kolejnej funkcji zastępuje poprzednią. Aby dodać niezależne procedury obsługi, użyj addEventListener('seeking', handler).

Rozróżniaj seeking i seeked: pierwsze sygnalizuje rozpoczęcie operacji przewijania, drugie jej zakończenie. Właściwość media.seeking opisuje stan operacji; samo przypisanie onseeking nie zmienia pozycji odtwarzania.

Przykład celowo wysyła syntetyczne zdarzenie bez pliku multimedialnego. Sprawdza podłączenie atrybutu obsługi, nie rzeczywiste przewijanie. Polityka bezpieczeństwa strony może blokować skrypty i procedury obsługi zapisane bezpośrednio w HTML.

Przykłady

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

Wynik

seeking

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

Źródła