Element.requestFullscreen()

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

Wir konvertieren die KompatibilitÀtsdaten in ein maschinenlesbares JSON Format. Diese KompatibilitÀtstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst!

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.

Siehe auch