CKTIS / HTML
onpause — obsługa zdarzenia wstrzymania multimediów
Atrybut onpause zawiera kod JavaScript obsługujący zdarzenie pause, zwykle na elemencie audio lub video. Reaguje na wstrzymanie odtwarzania, ale sam go nie powoduje.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause jest globalnym atrybutem obsługi zdarzenia pause. Choć jest dostępny na wszystkich elementach HTML, jego typowym zastosowaniem jest obsługa wstrzymania elementów audio i video. Wartością atrybutu jest kod JavaScript, a nie wartość logiczna.
Przy zwykłym wstrzymaniu multimediów paused przyjmuje wartość true, a zdarzenie jest wysyłane w zadaniu dodanym do kolejki. Wywołanie pause() na już wstrzymanym elemencie nie wywołuje kolejnego zdarzenia pause. Zdarzenie nie bąbelkuje i nie można go anulować; return false nie zapobiegnie wstrzymaniu.
W kodzie atrybutu event oznacza zdarzenie, a this wskazuje element. Właściwość JavaScript media.onpause przyjmuje funkcję lub null; ponowne przypisanie zastępuje poprzednią funkcję. media.addEventListener("pause", handler) pozwala rejestrować niezależne procedury obsługi. Polityka CSP może blokować kod atrybutów.
Przykład wysyła syntetyczne zdarzenie pause, aby bez pliku multimedialnego sprawdzić podłączenie atrybutu. Oczekiwany tekst to pause. Test nie uruchamia ani nie wstrzymuje odtwarzania i nie sprawdza rzeczywistego przejścia stanu multimediów.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('pause'));
</script>Wynik
pause
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.