WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onseeked — den Abschluss eines Sprungvorgangs bei Medien behandeln

Das Attribut onseeked legt fest, welcher JavaScript-Code beim Ereignis seeked ausgeführt wird. Bei Audio- und Videoelementen meldet dieses Ereignis den Abschluss eines Sprungvorgangs, nicht das Ende der Wiedergabe.

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

Syntax

onseeked="JavaScript"

onseeked ist ein Event-Handler-Attribut für das Ereignis seeked. Sein Wert enthält JavaScript-Code. Typischerweise wird damit die Benutzeroberfläche aktualisiert, sobald ein Sprungvorgang in einem audio- oder video-Element abgeschlossen ist.

Bei einem tatsächlichen Sprungvorgang signalisiert seeked, dass der Vorgang abgeschlossen ist und die Eigenschaft seeking den Wert false angenommen hat. Auch ein Sprung zur aktuellen Wiedergabeposition kann abgeschlossen werden und seeked auslösen, ohne dass sich die Position ändert. Das Ereignis seeking signalisiert dagegen den Beginn eines Sprungvorgangs. Dessen Abschluss bedeutet weder, dass die Wiedergabe beendet ist, noch garantiert er, dass sie gerade läuft.

Unterscheide den Attributnamen onseeked vom Ereignisnamen seeked. In JavaScript kannst du auch der Eigenschaft media.onseeked eine Funktion zuweisen oder mit media.addEventListener('seeked', handler) einen Listener registrieren. Das Attribut erwartet Code, während bei der Zuweisung an die Eigenschaft eine Funktion angegeben wird.

Das Beispiel löst absichtlich ein synthetisches Ereignis aus, ohne eine Mediendatei zu verwenden. Das Ergebnis seeked bestätigt nur, dass der Handler ausgeführt wurde; es belegt keinen tatsächlichen Sprungvorgang. Öffne die Datei lokal in einem Browser, in dem JavaScript und Inline-Event-Handler aktiviert sind.

Beispiele

<!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>

Ergebnis

seeked

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.

Quellen