CKTIS / HTML
onpause — gestore dell’evento di pausa dei media
L’attributo onpause contiene JavaScript che gestisce l’evento pause, di solito su un elemento audio o video. Reagisce alla pausa della riproduzione, ma non la mette in pausa autonomamente.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause è un attributo globale per gestire l’evento pause. Sebbene sia disponibile su tutti gli elementi HTML, viene usato soprattutto per gestire le pause degli elementi audio e video. Il suo valore è codice JavaScript, non un valore booleano.
Quando un media viene messo normalmente in pausa, paused diventa true e l’evento viene inviato in un’attività accodata. Chiamare pause() su un elemento già in pausa non genera un altro evento pause. L’evento non risale la gerarchia e non può essere annullato; return false non impedirà la pausa.
Nel codice dell’attributo, event rappresenta l’evento e this fa riferimento all’elemento. La proprietà JavaScript media.onpause accetta una funzione o null; una nuova assegnazione sostituisce la funzione precedente. media.addEventListener("pause", handler) consente di registrare gestori indipendenti. Una policy CSP può bloccare il codice degli attributi.
L’esempio invia un evento pause sintetico per verificare il collegamento dell’attributo senza un file multimediale. Il testo atteso è pause. Questo test non avvia né mette in pausa la riproduzione e non verifica una transizione reale dello stato del media.
Esempi
<!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>Risultato
pause
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.