WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

allowfullscreen — Vollbildberechtigung eines Frames

Das boolesche Attribut `allowfullscreen` delegiert die Vollbildfunktion an einen `iframe`, schaltet aber nicht selbst in den Vollbildmodus.

Version: HTML Living Standard

Syntax

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

Schreibe allowfullscreen oder allowfullscreen="". Anwesenheit bedeutet wahr: allowfullscreen="false" ist kein konformer Ausschalter und setzt allowFullscreen trotzdem auf true. Entferne das Attribut, um diese Deklaration zu entfernen.

Dies ist eine ältere Form der Permissions-Policy-Delegation. Eine fullscreen-Beschränkung in allow hat Vorrang; ein Verbot im übergeordneten Dokument bleibt wirksam. Die Erlaubnis ersetzt weder den Fullscreen-API-Aufruf noch nötige Benutzeraktivierung oder Fehlerbehandlung.

Das Beispiel enthält absichtlich das falsche "false", um diese Falle zu zeigen. Gleichzeitig sperrt allow="fullscreen 'none'" die Funktion: die reflektierte Eigenschaft ist wahr, fullscreenEnabled im Frame aber falsch. Der Test öffnet keinen Vollbildmodus.

Beispiele

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

Ergebnis

attributePresent=true; effective=false

Geprüft wird der Unterschied zwischen Attributanwesenheit und wirksamer Richtlinie. Für normalen Einsatz gilt die korrekte Syntax oben.

Quellen