WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onpause — Ereignisbehandlung für pausierte Medien

Das Attribut onpause enthält JavaScript-Code zur Behandlung des Ereignisses pause, meist auf einem audio- oder video-Element. Es reagiert auf eine Wiedergabepause, pausiert die Wiedergabe aber nicht selbst.

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

Syntax

<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);

onpause ist ein globales Ereignisbehandlungsattribut für pause. Obwohl es auf allen HTML-Elementen verfügbar ist, wird es typischerweise verwendet, um Pausen bei audio- und video-Elementen zu behandeln. Sein Wert ist JavaScript-Code, kein boolescher Wert.

Beim normalen Pausieren eines Mediums wird paused auf true gesetzt und das Ereignis in einer eingereihten Aufgabe ausgelöst. Ein Aufruf von pause() für ein bereits pausiertes Element löst kein weiteres pause-Ereignis aus. Das Ereignis steigt nicht in der DOM-Struktur auf und kann nicht abgebrochen werden; return false verhindert die Pause nicht.

Im Attributcode steht event für das Ereignis und this für das Element. Die JavaScript-Eigenschaft media.onpause akzeptiert eine Funktion oder null; eine erneute Zuweisung ersetzt die vorherige Funktion. Mit media.addEventListener("pause", handler) lassen sich unabhängige Handler registrieren. Eine CSP-Richtlinie kann Attributcode blockieren.

Das Beispiel löst ein synthetisches pause-Ereignis aus, um die Verknüpfung des Attributs ohne Mediendatei zu überprüfen. Der erwartete Text lautet pause. Dieser Test startet oder pausiert die Wiedergabe nicht und überprüft keinen tatsächlichen Zustandswechsel des Mediums.

Beispiele

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

Ergebnis

pause

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