CKTIS / HTML
onplaying — obsługa zdarzenia gotowości do odtwarzania
Atrybut onplaying zawiera kod obsługujący zdarzenie playing, używane przez audio i video, gdy odtwarzanie jest gotowe do rozpoczęcia lub wznowienia po przerwie. Nie uruchamia odtwarzania i nie jest odpowiednikiem onplay.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };onplaying jest atrybutem obsługi zdarzenia playing. Jest dostępny jako atrybut HTML na wszystkich elementach HTML, lecz jego typowe zastosowanie dotyczy elementów audio i video. Wartość atrybutu to kod JavaScript, a nie adres pliku ani wartość logiczna.
Zdarzenie playing oznacza gotowość do rozpoczęcia odtwarzania po pauzie lub opóźnieniu spowodowanym brakiem danych. W przeciwieństwie do niego play sygnalizuje zmianę paused na false. playing może wystąpić ponownie po buforowaniu; nie gwarantuje nieprzerwanego odtwarzania ani tego, że dźwięk jest słyszalny.
W JavaScript można przypisać funkcję do media.onplaying; kolejne przypisanie zastępuje poprzednią funkcję tego mechanizmu obsługi. Alternatywą jest media.addEventListener('playing', handler). Samo ustawienie obsługi nie rozpoczyna odtwarzania.
Przykład wysyła syntetyczne zdarzenie playing, aby bez pliku multimedialnego sprawdzić działanie atrybutu. Oczekiwany tekst to playing. Test nie sprawdza rzeczywistego odtwarzania; wymaga włączonych skryptów i dozwolonych procedur obsługi zapisanych w atrybutach.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>onplaying test</title>
<audio id="media" onplaying="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('playing'));
</script>Wynik
playing
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.