Document: fullscreenElement-Eigenschaft

Limited availability

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

Die Document.fullscreenElement-Eigenschaft (nur lesbar) gibt das Element zurück, das derzeit in diesem Dokument im Vollbildmodus dargestellt wird, oder null, wenn der Vollbildmodus derzeit nicht verwendet wird.

Obwohl diese Eigenschaft nur lesbar ist, wird sie keinen Fehler auslösen, wenn sie verändert wird (selbst im Strict-Modus); der Setter ist eine No-Operation und wird ignoriert.

Wert

Das Element-Objekt, das sich derzeit im Vollbildmodus befindet; wenn der Vollbildmodus nicht vom document verwendet wird, ist der zurückgegebene Wert null.

Beispiele

Dieses Beispiel stellt eine Funktion isVideoInFullscreen() vor, die den von fullscreenElement zurückgegebenen Wert überprüft; wenn sich das Dokument im Vollbildmodus befindet (fullscreenElement ist nicht null) und der Vollbild-Element-nodeName VIDEO ist, was auf ein <video>-Element hindeutet, gibt die Funktion true zurück, was darauf hinweist, dass das Video im Vollbildmodus ist.

js
function isVideoInFullscreen() {
  if (document.fullscreenElement?.nodeName === "VIDEO") {
    return true;
  }
  return false;
}

Spezifikationen

Specification
Fullscreen API Standard
# ref-for-dom-document-fullscreenelement①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch