Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

allowfullscreen — autorização de ecrã inteiro numa iframe

O atributo booleano `allowfullscreen` delega a funcionalidade de ecrã inteiro a uma `iframe`, mas não ativa esse modo sozinho.

Versão: HTML Living Standard

Sintaxe

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

Escreve allowfullscreen ou allowfullscreen="". A presença significa verdadeiro: allowfullscreen="false" não é uma desativação conforme e mantém allowFullscreen em true. Remove o atributo para retirar esta declaração.

É uma forma anterior de delegação de Permissions Policy. Uma restrição fullscreen em allow tem prioridade, e uma proibição num documento ascendente continua válida. A autorização não substitui a chamada Fullscreen API, a ativação necessária ou o tratamento de uma recusa.

O exemplo usa deliberadamente o incorreto "false" para mostrar a armadilha. Entretanto, allow="fullscreen 'none'" proíbe a funcionalidade: a propriedade refletida é verdadeira, mas fullscreenEnabled na iframe é falsa. O teste não abre ecrã inteiro.

Exemplos

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

Resultado

attributePresent=true; effective=false

O teste distingue presença do atributo e política efetiva. Usa a sintaxe conforme acima no código normal.

Fontes