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.