WindowControlsOverlayGeometryChangeEvent

The WindowControlsOverlayGeometryChangeEvent interface of the Window Controls Overlay API is passed to geometrychange when the size or visibility of a desktop Progress Web App's title bar region changes.

Event WindowControlsOverlayGeometryChangeEvent

Constructor

WindowControlsOverlayGeometryChangeEvent()

Creates a WindowControlsOverlayGeometryChangeEvent event with the given parameters.

Properties

Also inherits properties from its parent Event.

WindowControlsOverlayGeometryChangeEvent.titlebarAreaRect Read only

A DOMRect representing the position and size of the title bar region.

WindowControlsOverlayGeometryChangeEvent.visible Read only

A Boolean that indicates whether the window controls overlay is visible or not.

Examples

The following example shows how to use a WindowControlsOverlayGeometryChangeEvent instance by adding an event handler on the Navigator.windowControlsOverlay property, to listen to geometry changes of a PWA's title bar region.

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.
    }
  });
}

Specifications

No specification found

No specification data found for api.WindowControlsOverlayGeometryChangeEvent.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

No compatibility data found for api.WindowControlsOverlayGeometryChangeEvent.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

See also