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.