Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onplaying — gestire la disponibilità alla riproduzione

L’attributo onplaying contiene codice che gestisce l’evento playing, usato da audio e video quando la riproduzione è pronta per iniziare o riprendere dopo un’interruzione. Non avvia la riproduzione e non equivale a onplay.

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

Sintassi

onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };

onplaying è un attributo di gestione dell’evento playing. È disponibile come attributo HTML su tutti gli elementi HTML, ma il suo uso tipico riguarda gli elementi audio e video. Il suo valore è codice JavaScript, non un indirizzo di file né un valore booleano.

L’evento playing indica che la riproduzione è pronta per iniziare dopo una pausa o un ritardo causato da dati insufficienti. Al contrario, play segnala che paused è cambiato in false. playing può verificarsi di nuovo dopo il buffering; non garantisce né una riproduzione ininterrotta né che il suono sia udibile.

In JavaScript, puoi assegnare una funzione a media.onplaying; un’assegnazione successiva sostituisce la funzione precedente per quel gestore. In alternativa, puoi usare media.addEventListener('playing', handler). Impostare un gestore non avvia la riproduzione da solo.

L’esempio invia un evento playing sintetico per provare l’attributo senza un file multimediale. Il testo atteso è playing. Questo non verifica la riproduzione effettiva; richiede che gli script siano abilitati e che siano consentiti i gestori di eventi inline.

Esempi

<!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>

Risultato

playing

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.

Fonti