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.