Permissions-Policy: fullscreen
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Der HTTP-Header Permissions-Policy mit der Direktive fullscreen steuert, ob das aktuelle Dokument die Verwendung von Element.requestFullscreen() erlaubt ist.
Standardmäßig können Dokumente auf höchster Ebene und deren gleiche Herkunfts-Kinderrahmen den Vollbildmodus anfordern und betreten. Diese Direktive erlaubt oder verhindert, dass kreuz-originäre Frames den Vollbildmodus verwenden. Dazu gehören auch gleiche Herkunfts-Frames.
Speziell wenn eine definierte Richtlinie die Verwendung dieser Funktion blockiert, werden Aufrufe von requestFullscreen() mit einem Promise beantwortet, das mit einem TypeError abgelehnt wird.
Hinweis:
Wenn sowohl diese Direktive (d.h. über das allow-Attribut) als auch das allowfullscreen-Attribut auf einem <iframe>-Element vorhanden sind, hat diese Direktive Vorrang.
Syntax
Permissions-Policy: fullscreen=<allowlist>;
<allowlist>-
Eine Liste von Ursprüngen, für die die Berechtigung zur Nutzung der Funktion erteilt wird. Siehe
Permissions-Policy> Syntax für weitere Details.
Standardrichtlinie
Die Standard-Whitelist für fullscreen ist self.
Beispiele
Allgemeines Beispiel
SecureCorp Inc. möchte die Fullscreen-API in allen Browsing-Kontexten deaktivieren, mit Ausnahme ihres eigenen Ursprungs und derer, deren Ursprung https://example.com ist. Dies kann durch das Liefern des folgenden HTTP-Antwort-Headers erreicht werden, um eine Berechtigungsrichtlinie zu definieren:
Permissions-Policy: fullscreen=(self "https://example.com")
Mit einem <iframe>-Element
FastCorp Inc. möchte fullscreen für alle kreuz-originären Kinderrahmen deaktivieren, mit Ausnahme eines bestimmten <iframe>. Dies kann durch das Liefern des folgenden HTTP-Antwort-Headers erreicht werden, um eine Berechtigungsrichtlinie zu definieren:
Permissions-Policy: fullscreen=(self)
Dann das allow-Attribut im <iframe>-Element einfügen:
<iframe src="https://other.com/videoplayer" allow="fullscreen"></iframe>
Iframe-Attribute können selektiv Funktionen in bestimmten Frames aktivieren und in anderen nicht, selbst wenn diese Frames Dokumente vom gleichen Ursprung enthalten.
Spezifikationen
| Specification |
|---|
| Fullscreen API # permissions-policy-integration |