Die Funktion Element.requestFullscreen()
sendet eine asynchrone Anfrage, um das Element in Vollbild darzustellen.
Es ist nicht garantiert, dass das Element in Vollbild angezeigt werden wird. Wenn die Berechtigung dazu erteilt wird, erhält das Dokument ein fullscreenchange
Event, um es wissen zu lassen, dass nun etwas in Vollbild angezeigt wird. Wird die Berechtigung jedoch verweigert, erhält das Dokument ein fullscreenerror
Event.
Nur Elemente im HTML Namespace (Standard HTML Elemente), plus die <svg>
und <math>
Elemente, welche sich im Top-Level Dokument oder in einem <iframe>
mit dem allowfullscreen
Attribut befinden, können im Vollbildmodus angezeigt werden. Das bedeutet, dass ein <frame>
oder ein <object>
dies nicht kann.
Syntax
Element.requestFullscreen();
Beispiel
Bevor requestFullScreen()
aufgerufen wird, sollte man Eventhandler für die fullscreenchange
und fullscreenerror
Events erstellen, damit man erfährt, wenn das Dokument in den Vollbildmodus wechselt (oder die entsprechende Berechtigung dazu fehlt).
tbd
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
Fullscreen API Die Definition von 'Element.requestFullScreen()' in dieser Spezifikation. |
Lebender Standard | Ursprüngliche Definition |
Browser-Kompatibilität
Feature | Chrome | Firefox | Internet Explorer | Edge | Opera | Safari |
---|---|---|---|---|---|---|
Grundlegene Unterstütung | (Ja)webkit[1] | 9.0 (9.0) as mozRequestFullScreen [2]47.0 (47.0) (behind full-screen-api.unprefix.enabled |
11ms[3] | (Ja)[3] | ? | ? |
Feature | Chrome Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Grundlegene Unterstütung | (Ja)webkit[1] | (Ja) | 9.0 (9.0) as mozRequestFullScreen [2]47.0 (47.0) (behind full-screen-api.unprefix.enabled |
? | ? | ? |
[1] Auch implementiert als webkitRequestFullScreen
.
[2] Implementiert als mozRequestFullScreen
(man beachte das große S für Screen). Vor Firefox 44 erlaubte Gecko Elementen innerhalb eines <frame>
oder <object>
fälschlicherweise in den Vollbildmodus zu wechseln. Ab Firefox 44 wurde dieses Verhalten behoben: nur Elemente im Top-Level Dokument oder in einem <iframe>
mit dem allowfullscreen
Attribut können in den Vollbildmodus wechseln.
[3] Siehe Dokumentation auf MSDN.