Document: fullscreenElement Eigenschaft

Limited availability

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

Die schreibgeschützte Eigenschaft Document.fullscreenElement gibt das Element zurück, das derzeit in diesem Dokument im Vollbildmodus angezeigt wird, oder null, wenn der Vollbildmodus derzeit nicht verwendet wird.

Obwohl diese Eigenschaft schreibgeschützt ist, wird sie keinen Fehler auslösen, wenn sie modifiziert wird (sogar im strikten Modus); der Setter ist eine nicht durchgeführte Operation und wird ignoriert.

Wert

Das Element Objekt, das sich derzeit im Vollbildmodus befindet; wenn der Vollbildmodus vom document momentan nicht verwendet wird, ist der Rückgabewert null. Wenn mehrere Elemente im Vollbildmodus sind, wird das oberste (zuletzt angeforderte) Element zurückgegeben.

Beispiele

Dieses Beispiel zeigt eine Funktion, isVideoInFullscreen(), die den Wert überprüft, der von fullscreenElement zurückgegeben wird. Wenn sich das Dokument im Vollbildmodus befindet (fullscreenElement ist nicht null) und der Name des Vollbildelements nodeName VIDEO ist, was auf ein <video>-Element hinweist, 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
# ref-for-dom-document-fullscreenelement①

Browser-Kompatibilität

Siehe auch