Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onratechange — obsługa zmiany szybkości odtwarzania

Atrybut onratechange określa kod JavaScript obsługujący zdarzenie ratechange, wywoływane po zmianie playbackRate lub defaultPlaybackRate elementu multimedialnego.

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

Składnia

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

onratechange jest atrybutem obsługi zdarzenia ratechange. Jest dostępny na wszystkich elementach HTML, ale naturalnie dotyczy przede wszystkim audio i video. Wartość atrybutu to treść funkcji w JavaScript, a nie nazwa zdarzenia ani wartość logiczna.

Przeglądarka kolejkuje zdarzenie, gdy zmienia się playbackRate lub defaultPlaybackRate. playbackRate oznacza faktyczną szybkość odtwarzania: 1 to szybkość normalna, a 1.5 to półtora raza szybciej. defaultPlaybackRate określa szybkość domyślną; jego zmiana sama nie zmienia faktycznej szybkości odtwarzania.

W kodzie atrybutu this wskazuje element, a event udostępnia zdarzenie. Odpowiadająca mu właściwość JavaScript media.onratechange przyjmuje funkcję lub null; przypisanie funkcji zastępuje poprzednią obsługę w tym slocie. Alternatywą jest media.addEventListener('ratechange', handler). Polityka CSP może blokować kod w atrybutach.

Przykład zmienia szybkość bez ładowania pliku i bez rozpoczynania odtwarzania. Wynik pojawia się po obsłużeniu zakolejkowanego zdarzenia, nie synchronicznie podczas przypisania.

Przykłady

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

Wynik

ratechange: 1.5

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła