CKTIS / HTML
allowfullscreen — permiso de pantalla completa en un marco
El atributo booleano `allowfullscreen` delega la función de pantalla completa a un `iframe`; no activa ese modo por sí mismo.
Versión: HTML Living Standard
Sintaxis
<iframe src="/video" allowfullscreen></iframe>Escribe allowfullscreen o allowfullscreen="". La presencia significa verdadero: allowfullscreen="false" no es una desactivación conforme y mantiene allowFullscreen en true. Elimina el atributo para retirar esta declaración.
Es una forma anterior de delegación de Permissions Policy. Una restricción fullscreen en allow tiene prioridad, y sigue vigente cualquier prohibición del documento ancestro. El permiso no sustituye la llamada a Fullscreen API, la activación requerida ni el tratamiento de una negativa.
El ejemplo incluye deliberadamente el incorrecto "false". A la vez, allow="fullscreen 'none'" prohíbe la función: la propiedad reflejada es verdadera, pero fullscreenEnabled dentro del marco es falsa. No se entra en pantalla completa.
Ejemplos
<!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
La prueba diferencia presencia del atributo y política efectiva. En código normal usa la sintaxis conforme indicada arriba.