ScreenDetails: currentscreenchange-Ereignis

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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

Das currentscreenchange-Ereignis der ScreenDetails-Schnittstelle wird ausgelöst, wenn sich ScreenDetails.currentScreen auf eine der folgenden Arten ändert:

  • Der aktuelle Bildschirm wechselt zu einem anderen Bildschirm, d.h. das aktuelle Browserfenster wird auf einen anderen Bildschirm verschoben.
  • Eine oder mehrere der folgenden Eigenschaften ändern sich auf dem aktuellen Bildschirm:
  • Eine oder mehrere der folgenden Werte ändern sich:
    • Die Position des Bildschirms (Koordinaten (x,y) der oberen linken Ecke) innerhalb der virtuellen Bildschirmanordnung des Betriebssystems, relativ zum multi-screen origin
    • Die verfügbare Position des Bildschirms (Koordinaten (x,y) der oberen linken Ecke) innerhalb der virtuellen Bildschirmanordnung des Betriebssystems, relativ zum multi-screen origin. Diese entspricht der Bildschirmposition plus der Breite/Höhe von UI-Elementen des Betriebssystems, die oben links auf dem Bildschirm gezeichnet werden – Fenster können nicht in diesen Bereichen platziert werden
    • devicePixelRatio
    • label
    • Die Klassifizierung des Bildschirms als primär oder sekundär (siehe isPrimary)
    • Die Klassifizierung des Bildschirms als intern oder extern (siehe isInternal)

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("currentscreenchange", (event) => { })

oncurrentscreenchange = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

js
const screenDetails = await window.getScreenDetails();
screenDetails.addEventListener("currentscreenchange", (event) => {
  const details = screenDetails.currentScreen;
  console.log("The current screen has changed.", event, details);
});

Spezifikationen

Specification
Window Management
# eventdef-screendetails-currentscreenchange
Window Management
# ref-for-dom-screendetails-oncurrentscreenchange

Browser-Kompatibilität

Siehe auch