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