WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onplay — das play-Ereignis behandeln

Das Attribut onplay enthält JavaScript, das beim Ereignis play ausgeführt wird, typischerweise auf einem audio- oder video-Element. Dieses Ereignis signalisiert, dass der pausierte Zustand verlassen wird, garantiert aber nicht, dass Ton oder Video bereits wiedergegeben wird.

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

Syntax

onplay="JavaScript statements"

onplay ist ein Event-Handler-Content-Attribut für play. Sein Wert ist der Funktionskörper in JavaScript, keine Dateiadresse und kein boolesches Attribut. Es wird typischerweise auf audio- und video-Elementen verwendet; das Hinzufügen des Attributs startet die Wiedergabe nicht.

Der Browser löst play aus, wenn sich paused von true zu false ändert, zum Beispiel durch play() oder autoplay. Das bedeutet noch nicht, dass tatsächlich etwas wiedergegeben wird: Möglicherweise sind keine Daten verfügbar. Das Ereignis playing, behandelt über onplaying, betrifft den Beginn oder die Fortsetzung der Wiedergabe, nachdem sie wegen unzureichender Daten angehalten wurde.

In JavaScript kannst du der Eigenschaft media.onplay eine Funktion zuweisen oder media.addEventListener('play', handler) verwenden. Eine Zuweisung an die Eigenschaft ersetzt die vorherige Funktion in diesem Event-Handler-Slot. Die Content Security Policy kann Code blockieren, der direkt im Attribut steht.

Das Beispiel löst ein synthetisches play aus und benötigt daher keine Mediendatei. Der erwartete Text ist play; damit wird die Anbindung des Handlers getestet, nicht die Wiedergabe.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Ergebnis

play

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