CKTIS / HTML
onseeking — Beginn des Spulvorgangs behandeln
`onseeking` legt den Code fest, der das Ereignis `seeking` behandelt. Das Ereignis signalisiert den Beginn eines Spulvorgangs bei Audio oder Video, auch wenn die Wiedergabeposition unverändert bleibt. Es signalisiert nicht den Abschluss.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
HTML: onseeking="JavaScript code"
JavaScript: media.onseeking = handler;onseeking ist ein Ereignisbehandlungsattribut für seeking. Bei audio- und video-Elementen löst der Browser dieses Ereignis zu Beginn eines Spulvorgangs aus. Das kann auch passieren, wenn die aktuelle Wiedergabeposition als Ziel gewählt wird und sich die Position dadurch nicht ändert. Ein Spulvorgang kann über den Wiedergaberegler oder durch Setzen von currentTime in einem Skript gestartet werden.
Der Wert des HTML-Attributs ist JavaScript-Code, kein Ereignisname und keine Dateiadresse. Die entsprechende JavaScript-Eigenschaft media.onseeking nimmt eine Handler-Funktion entgegen; wird eine andere Funktion zugewiesen, ersetzt sie die vorherige. Verwende addEventListener('seeking', handler), um unabhängige Listener hinzuzufügen.
Unterscheide zwischen seeking und seeked: Ersteres signalisiert den Beginn des Spulvorgangs, Letzteres dessen Abschluss. Die Eigenschaft media.seeking beschreibt den Zustand des Vorgangs; allein durch das Zuweisen von onseeking ändert sich die Wiedergabeposition nicht.
Das Beispiel löst absichtlich ein synthetisches Ereignis ohne Mediendatei aus. Es prüft die Verknüpfung des Ereignishandlers, nicht einen tatsächlichen Spulvorgang. Die Sicherheitsrichtlinie einer Seite kann Inline-Skripte und direkt im HTML notierte Ereignishandler blockieren.
Beispiele
<!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>Ergebnis
seeking
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.