Document: fullscreenEnabled-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die schreibgeschützte fullscreenEnabled-Eigenschaft des Document-Interface zeigt an, ob der Vollbildmodus verfügbar ist oder nicht.

Der Vollbildmodus ist nur für eine Seite verfügbar, die in keinem ihrer Dokumente fensterbasierte Plug-ins enthält und wenn alle <iframe>-Elemente, die das Dokument enthalten, ihr allowfullscreen-Attribut gesetzt haben.

Obwohl diese Eigenschaft schreibgeschützt ist, wird sie nicht ausgelöst, wenn sie geändert wird (auch nicht im Strict-Modus); der Setter ist eine No-Operation und wird ignoriert.

Wert

Ein boolescher Wert, der true ist, wenn das Dokument und die darin enthaltenen Elemente in den Vollbildmodus versetzt werden können, indem Element.requestFullscreen() aufgerufen wird. Wenn der Vollbildmodus nicht verfügbar ist, ist dieser Wert false.

Beispiele

In diesem Beispiel wird vor dem Versuch, den Vollbildmodus für ein <video>-Element anzufordern, der Wert von fullscreenEnabled überprüft, um zu vermeiden, dass ein Versuch unternommen wird, wenn er nicht verfügbar ist.

js
function requestFullscreen() {
  if (document.fullscreenEnabled) {
    videoElement.requestFullscreen();
  } else {
    console.log("Your browser cannot use fullscreen right now");
  }
}

Spezifikationen

Specification
Fullscreen API
# ref-for-dom-document-fullscreenenabled①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
fullscreenEnabled

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Uses a non-standard name.
Requires a vendor prefix or different name for use.
Has more compatibility info.

Siehe auch