CKTIS / HTML
onended – das Ende der Wiedergabe behandeln
Das Attribut onended enthält JavaScript, das ausgeführt wird, wenn ein ended-Ereignis empfangen wird. Bei audio- und video-Elementen reagiert es darauf, dass das Medium sein Ende erreicht, nicht darauf, dass die Wiedergabe lediglich pausiert wird.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>onended ist ein Ereignisbehandlungs-Content-Attribut für ended. Sein Wert ist der Inhalt einer JavaScript-Funktion, keine Datei-URL und nicht bloß ein Funktionsname. Mit event kann das Ereignis untersucht werden.
Bei audio und video löst der Browser ended aus, wenn die Vorwärtswiedergabe das Ende des Mediums erreicht. Ein Aufruf von pause() bedeutet allein nicht, dass die Wiedergabe beendet ist. Ist loop gesetzt, springt die Wiedergabe beim Erreichen des Endes während der Vorwärtswiedergabe an den Anfang zurück, statt dieses Ereignis auszulösen.
Unterscheide das HTML-Attribut onended, die JavaScript-Eigenschaft media.onended, die eine Handler-Funktion enthält, und die boolesche Zustandseigenschaft media.ended. Eine Alternative zum Attribut ist media.addEventListener('ended', handler); dem Ereignisnamen wird kein on vorangestellt.
Das Beispiel löst absichtlich ein synthetisches Ereignis aus und benötigt daher keine Mediendatei. Es prüft die Verknüpfung des Handlers, nicht den tatsächlichen Abschluss der Wiedergabe. Die Sicherheitsrichtlinie einer Seite kann Inline-Code für Ereignishandler blockieren.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>onended test</title>
<audio id="media" onended="document.getElementById('result').textContent = event.type"></audio>
<output id="result">waiting</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('ended'));
</script>Ergebnis
ended
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.