WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onratechange — Änderungen der Wiedergabegeschwindigkeit behandeln

Das Attribut onratechange gibt JavaScript-Code an, der das ratechange-Ereignis behandelt. Es wird ausgelöst, nachdem sich playbackRate oder defaultPlaybackRate eines Medienelements geändert hat.

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

Syntax

<audio onratechange="JavaScript statements"></audio>
<video onratechange="JavaScript statements"></video>

onratechange ist das Ereignisbehandler-Attribut für ratechange. Es ist für alle HTML-Elemente verfügbar, wird aber vor allem bei audio und video verwendet. Sein Wert ist der Inhalt einer JavaScript-Funktion, nicht ein Ereignisname oder ein boolescher Wert.

Der Browser stellt das Ereignis in die Warteschlange, wenn sich playbackRate oder defaultPlaybackRate ändert. playbackRate bezeichnet die tatsächliche Wiedergabegeschwindigkeit: 1 bedeutet normale Geschwindigkeit, 1.5 das Eineinhalbfache. defaultPlaybackRate legt die Standardgeschwindigkeit fest; eine Änderung daran ändert nicht von selbst die tatsächliche Wiedergabegeschwindigkeit.

Im Code des Attributs verweist this auf das Element und event stellt das Ereignis bereit. Die entsprechende JavaScript-Eigenschaft media.onratechange akzeptiert eine Funktion oder null; durch Zuweisen einer Funktion wird der bisherige Handler in diesem Slot ersetzt. Eine Alternative ist media.addEventListener('ratechange', handler). CSP kann Code in Ereignisbehandler-Attributen blockieren.

Das Beispiel ändert die Geschwindigkeit, ohne eine Datei zu laden oder die Wiedergabe zu starten. Das Ergebnis erscheint, wenn das Ereignis aus der Warteschlange behandelt wird, nicht synchron während der Zuweisung.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onratechange demo</title>
<audio id="media" onratechange="document.getElementById('result').textContent = event.type + ': ' + this.playbackRate;"></audio>
<output id="result">Waiting</output>
<script>
  document.getElementById('media').playbackRate = 1.5;
</script>
</html>

Ergebnis

ratechange: 1.5

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