Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

allowfullscreen — autoriser le plein écran d’une iframe

L’attribut booléen `allowfullscreen` délègue le plein écran à une `iframe` ; il ne déclenche pas lui-même ce mode.

Version : HTML Living Standard

Syntaxe

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

Écrivez allowfullscreen ou allowfullscreen="". Sa présence signifie vrai : allowfullscreen="false" n’est pas une désactivation conforme et maintient allowFullscreen à true. Supprimez l’attribut pour retirer cette déclaration.

Il s’agit d’une ancienne forme de délégation de Permissions Policy. Une restriction fullscreen dans allow est prioritaire ; l’iframe ne contourne pas l’interdiction d’un ancêtre. L’autorisation ne remplace ni appel Fullscreen API, ni activation utilisateur requise, ni traitement du refus.

L’exemple emploie délibérément le mauvais "false" pour montrer ce piège. Cependant, allow="fullscreen 'none'" interdit la fonction : la propriété reflétée est vraie, mais fullscreenEnabled dans l’iframe est faux. Le test n’ouvre pas le plein écran.

Exemples

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

Résultat

attributePresent=true; effective=false

Le test distingue présence de l’attribut et politique effective. Utilisez la syntaxe conforme indiquée plus haut dans votre propre code.

Sources