Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

ScreenDetails: currentscreenchange-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

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 Weisen ä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 des aktuellen Bildschirms ändern sich:
  • Einer oder mehrere der folgenden Werte ändern sich:
    • Die Position des Bildschirms ((x,y)-Koordinaten der oberen linken Ecke) innerhalb der virtuellen Bildschirmanordnung des Betriebssystems, relativ zum Ursprung der Mehrbildschirmkonfiguration
    • Die verfügbare Position des Bildschirms ((x,y)-Koordinaten der oberen linken Ecke) innerhalb der virtuellen Bildschirmanordnung des Betriebssystems, relativ zum Ursprung der Mehrbildschirmkonfiguration. Sie entspricht der Bildschirmposition zuzüglich der Breite bzw. Höhe aller Benutzeroberflächenelemente des Betriebssystems, die am oberen oder linken Bildschirmrand angezeigt werden. In diesen Bereichen können keine Fenster platziert werden.
    • devicePixelRatio
    • label
    • Die Einstufung des Bildschirms als primär oder sekundär (siehe isPrimary)
    • Die Einstufung des Bildschirms als intern oder extern (siehe isInternal)

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:

js
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

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

Browser-Kompatibilität

Siehe auch