Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes