Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

allowfullscreen — permesso di schermo intero nel frame

L’attributo booleano `allowfullscreen` delega la funzione di schermo intero a un `iframe`, ma non attiva da solo tale modalità.

Versione: HTML Living Standard

Sintassi

<iframe src="/video" allowfullscreen></iframe>

Scrivi allowfullscreen oppure allowfullscreen="". La presenza significa vero: allowfullscreen="false" è un tentativo non conforme di disattivazione e mantiene allowFullscreen a true. Rimuovi l’attributo per eliminare questa dichiarazione.

È una forma precedente di delegazione di Permissions Policy. La restrizione fullscreen in allow prevale; resta valido il divieto di un documento antenato. Il permesso non sostituisce chiamata Fullscreen API, attivazione richiesta o gestione del rifiuto.

L’esempio include volutamente l’errato "false" per mostrare l’insidia. Contemporaneamente allow="fullscreen 'none'" vieta la funzione: la proprietà riflessa è vera, ma fullscreenEnabled nel frame è falsa. Il test non entra a schermo intero.

Esempi

<!doctype html><meta charset="utf-8">
<iframe id="frame" title="Local player" allowfullscreen="false"
  allow="fullscreen 'none'" srcdoc="<p>Player</p>"></iframe>
<output id="result"></output>
<script>
document.querySelector('#frame').addEventListener('load', event => {
  const frame = event.target;
  document.querySelector('#result').textContent =
    'attributePresent=' + frame.allowFullscreen +
    '; effective=' + frame.contentDocument.fullscreenEnabled;
});
</script>

Risultato

attributePresent=true; effective=false

Il test distingue presenza dell’attributo e politica effettiva. Nell’uso normale scegli la sintassi conforme indicata sopra.

Fonti