Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oncanplay — obsługa gotowości multimediów do odtwarzania

Atrybut oncanplay zawiera kod JavaScript wykonywany po zdarzeniu canplay. Dla audio i video oznacza ono gotowość do rozpoczęcia lub wznowienia odtwarzania, ale nie gwarantuje odtworzenia całości bez przerw na buforowanie.

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

Składnia

<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>

oncanplay jest atrybutem obsługi zdarzenia canplay. Jego wartością jest kod JavaScript; w procedurze obsługi dostępny jest obiekt event. Atrybut jest dozwolony na wszystkich elementach HTML, ale jego typowym zastosowaniem jest reagowanie na gotowość elementów audio i video.

Przeglądarka emituje canplay, gdy stan gotowości multimediów przechodzi z niższego poziomu do HAVE_FUTURE_DATA lub wyższego. Dostępne są wtedy dane pozwalające kontynuować odtwarzanie, lecz niekoniecznie wystarczające do odtworzenia całego materiału bez buforowania. canplaythrough oznacza natomiast oszacowaną możliwość odtworzenia materiału do końca bez zatrzymywania na buforowanie. Samo canplay nie oznacza, że odtwarzanie już trwa.

W HTML używa się oncanplay="handler(event)", natomiast w JavaScript można przypisać funkcję do media.oncanplay albo wywołać media.addEventListener('canplay', handler). Nazwa zdarzenia nie zawiera prefiksu on. Przykład wywołuje zdarzenie syntetycznie: sprawdza połączenie atrybutu z procedurą obsługi, a nie rzeczywistą gotowość multimediów.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('canplay'));
</script>

Wynik

canplay

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

Źródła