WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onplaying — Bereitschaft zur Wiedergabe behandeln

Das Attribut onplaying enthält Code zur Behandlung des playing-Ereignisses. Es wird bei Audio- und Videoelementen verwendet, wenn die Wiedergabe nach einer Unterbrechung starten oder fortgesetzt werden kann. Es startet die Wiedergabe nicht und ist nicht mit onplay gleichzusetzen.

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

Syntax

onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };

onplaying ist ein Ereignisbehandlungsattribut für playing. Es ist als HTML-Attribut bei allen HTML-Elementen verfügbar, wird aber typischerweise bei audio- und video-Elementen verwendet. Sein Wert ist JavaScript-Code, keine Dateiadresse und kein boolescher Wert.

Das Ereignis playing zeigt an, dass die Wiedergabe nach einer Pause oder einer durch unzureichende Daten verursachten Verzögerung starten kann. Im Gegensatz dazu signalisiert play, dass sich paused zu false geändert hat. playing kann nach dem Puffern erneut auftreten; es garantiert weder eine ununterbrochene Wiedergabe noch hörbaren Ton.

In JavaScript kann einer Funktion media.onplaying zugewiesen werden; eine weitere Zuweisung ersetzt die vorherige Funktion für diese Ereignisbehandlung. Alternativ kann media.addEventListener('playing', handler) verwendet werden. Das Einrichten einer Ereignisbehandlung startet die Wiedergabe nicht von selbst.

Das Beispiel löst ein synthetisches playing-Ereignis aus, um das Attribut ohne Mediendatei zu testen. Der erwartete Text ist playing. Damit wird keine tatsächliche Wiedergabe getestet; Skripte müssen aktiviert und Inline-Ereignisbehandlungen erlaubt sein.

Beispiele

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

Ergebnis

playing

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