WindowControlsOverlay

Limited availability

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

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Das WindowControlsOverlay-Interface der Window Controls Overlay API liefert Informationen über die Geometrie des Titelbereichs in Desktop-Progressive-Web-Apps und ein Ereignis, das anzeigt, wann sich dieser ändert. Dieses Interface ist über Navigator.windowControlsOverlay zugänglich.

EventTarget WindowControlsOverlay

Instanzeigenschaften

WindowControlsOverlay.visible Nur lesbar

Ein Boolean, der angibt, ob das Fenstersteuerungs-Overlay sichtbar ist oder nicht.

Instanzmethoden

WindowControlsOverlay.getTitlebarAreaRect()

Gibt die Größe und Position des Titelbereichs zurück.

Ereignisse

Hören Sie diese Ereignisse mit EventTarget.addEventListener() oder indem Sie einen Ereignis-Listener der relevanten oneventname-Eigenschaft dieses Interfaces zuweisen.

geometrychange

Wird ausgelöst, wenn sich die Geometrie des Titelbereichs ändert.

Beispiele

js
if ("windowControlsOverlay" in navigator) {
  navigator.windowControlsOverlay.addEventListener(
    "geometrychange",
    (event) => {
      if (event.visible) {
        const rect = event.titlebarAreaRect;
        // Do something with the coordinates of the title bar area.
      }
    },
  );
}

Spezifikationen

Specification
Window Controls Overlay
# windowcontrolsoverlay-interface

Browser-Kompatibilität

BCD tables only load in the browser