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.