Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

playsinline — riproduzione video all’interno della pagina

L’attributo booleano playsinline suggerisce al browser di riprodurre il video nell’area di riproduzione dell’elemento invece che a schermo intero o in una finestra separata. È un’indicazione, non una garanzia; ometterlo non forza lo schermo intero.

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

Sintassi

<video playsinline></video>

playsinline è un attributo booleano dell’elemento video. La sua presenza suggerisce al browser di mostrare il video, per impostazione predefinita, all’interno del documento e nell’area di riproduzione dell’elemento, invece che a schermo intero o in una finestra separata ridimensionabile. È un’indicazione per il browser, non un requisito assoluto per la presentazione.

L’assenza di playsinline non significa che il video venga visualizzato a schermo intero: il browser può riprodurlo all’interno della pagina per impostazione predefinita. L’attributo non avvia la riproduzione e non sostituisce autoplay o controls.

Le forme valide sono playsinline, playsinline="" e playsinline="playsinline". Scrivere playsinline="false" non rispetta la sintassi degli attributi booleani e lascia comunque presente l’attributo. Per disattivare l’indicazione, rimuovi l’attributo.

In JavaScript, la proprietà corrispondente è playsInline di HTMLVideoElement, con la I maiuscola. Riflette la presenza dell’attributo: assegnarle false rimuove l’attributo, mentre assegnarle true lo aggiunge. L’esempio verifica questa relazione senza un file multimediale; non prova la presentazione effettiva del video.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>playsinline</title>
<video id="clip" playsinline controls></video>
<pre id="result"></pre>
<script>
  const clip = document.getElementById('clip');
  const states = [clip.playsInline];
  clip.playsInline = false;
  states.push(clip.hasAttribute('playsinline'));
  clip.playsInline = true;
  states.push(clip.hasAttribute('playsinline'));
  document.getElementById('result').textContent = states.join('\n');
</script>

Risultato

true
false
true

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