KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onratechange — wijzigingen in de afspeelsnelheid afhandelen

Het kenmerk onratechange geeft JavaScript-code op die de gebeurtenis ratechange afhandelt. Deze wordt geactiveerd nadat playbackRate of defaultPlaybackRate van een media-element is gewijzigd.

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

Syntax

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

onratechange is het gebeurtenisafhandelingskenmerk voor ratechange. Het is beschikbaar op alle HTML-elementen, maar wordt vooral gebruikt bij audio en video. De waarde is de inhoud van een JavaScript-functie, niet een gebeurtenisnaam of een Booleaanse waarde.

De browser zet de gebeurtenis in de wachtrij wanneer playbackRate of defaultPlaybackRate verandert. playbackRate staat voor de effectieve afspeelsnelheid: 1 betekent normale snelheid en 1.5 anderhalf keer de normale snelheid. defaultPlaybackRate bepaalt de standaardsnelheid; een wijziging daarvan verandert niet op zichzelf de effectieve afspeelsnelheid.

In de code van het kenmerk verwijst this naar het element en geeft event toegang tot de gebeurtenis. De bijbehorende JavaScript-eigenschap media.onratechange accepteert een functie of null; door een functie toe te wijzen, wordt de vorige handler in die positie vervangen. Een alternatief is media.addEventListener('ratechange', handler). CSP kan code in gebeurtenisafhandelingskenmerken blokkeren.

Het voorbeeld wijzigt de snelheid zonder een bestand te laden of het afspelen te starten. Het resultaat verschijnt wanneer de gebeurtenis uit de wachtrij wordt afgehandeld, niet synchroon tijdens de toewijzing.

Voorbeelden

<!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>

Resultaat

ratechange: 1.5

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen