Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onplay — gestire l’evento play

L’attributo onplay contiene JavaScript eseguito in risposta all’evento play, in genere su un elemento audio o video. Questo evento segnala l’uscita dallo stato di pausa, ma non garantisce che l’audio o il video sia già in riproduzione.

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

Sintassi

onplay="JavaScript statements"

onplay è un attributo di contenuto gestore di eventi per play. Il suo valore è il corpo di una funzione JavaScript, non un indirizzo di file né un attributo booleano. Si usa in genere sugli elementi audio e video; aggiungere l’attributo non avvia la riproduzione.

Il browser attiva play quando paused passa da true a false, per esempio tramite play() o autoplay. Questo non significa ancora che la riproduzione sia effettivamente in corso: i dati potrebbero non essere disponibili. L’evento playing, gestito tramite onplaying, riguarda l’avvio o la ripresa della riproduzione dopo un’interruzione dovuta alla mancanza di dati.

In JavaScript, assegna una funzione a media.onplay oppure usa media.addEventListener('play', handler). L’assegnazione alla proprietà sostituisce la funzione precedente in quello slot di gestione dell’evento. La Content Security Policy può bloccare il codice scritto direttamente nell’attributo.

L’esempio invia un play sintetico e quindi non richiede un file multimediale. Il testo atteso è play; questo verifica il collegamento del gestore, non la riproduzione.

Esempi

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

Risultato

play

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