Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onplay — obsługa zdarzenia play

Atrybut onplay zawiera kod JavaScript wykonywany po zdarzeniu play, zwykle na elemencie audio lub video. Sygnalizuje ono wyjście ze stanu wstrzymania, a nie gwarancję, że dźwięk lub obraz jest już odtwarzany.

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

Składnia

onplay="JavaScript statements"

onplay jest atrybutem obsługi zdarzenia play. Jego wartością jest treść funkcji JavaScript, a nie adres pliku ani atrybut logiczny. Typowo używa się go na elementach audio i video; samo dodanie atrybutu nie uruchamia odtwarzania.

Przeglądarka emituje play, gdy paused zmienia się z true na false, na przykład wskutek play() lub autoplay. Nie oznacza to jeszcze faktycznego odtwarzania: może brakować danych. Zdarzenie playing, obsługiwane przez onplaying, dotyczy rozpoczęcia lub wznowienia odtwarzania po zatrzymaniu spowodowanym brakiem danych.

W JavaScript można przypisać funkcję do media.onplay albo użyć media.addEventListener('play', handler). Przypisanie do właściwości zastępuje dotychczasową funkcję tego mechanizmu obsługi. Polityka Content Security Policy może blokować kod zapisany bezpośrednio w atrybucie.

Przykład wywołuje syntetyczne play, więc nie potrzebuje pliku multimedialnego. Oczekiwany tekst to play; test sprawdza podłączenie obsługi, nie odtwarzanie.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Wynik

play

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

Źródła