ScreenDetailed
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, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das ScreenDetailed
-Interface der Window Management API repräsentiert detaillierte Informationen über einen spezifischen Bildschirm, der dem Gerät des Nutzers zur Verfügung steht.
ScreenDetailed
-Objekte können über die Eigenschaften ScreenDetails.screens
und ScreenDetails.currentScreen
abgerufen werden.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, Screen
.
availLeft
Nur lesbar Experimentell-
Eine Zahl, die die x-Koordinate (linke Kante) des verfügbaren Bildschirmbereichs darstellt.
availTop
Nur lesbar Experimentell-
Eine Zahl, die die y-Koordinate (obere Kante) des verfügbaren Bildschirmbereichs darstellt.
devicePixelRatio
Nur lesbar Experimentell-
Eine Zahl, die das Geräte-Pixelverhältnis des Bildschirms repräsentiert.
isInternal
Nur lesbar Experimentell-
Ein Boolean, der anzeigt, ob der Bildschirm intern für das Gerät oder extern ist.
isPrimary
Nur lesbar Experimentell-
Ein Boolean, der anzeigt, ob der Bildschirm als primärer Bildschirm des Betriebssystems (OS) festgelegt ist oder nicht.
label
Nur lesbar Experimentell-
Ein String, der eine beschreibende Bezeichnung für den Bildschirm bereitstellt, zum Beispiel "Eingebautes Retina Display".
left
Nur lesbar Experimentell-
Eine Zahl, die die x-Koordinate (linke Kante) des gesamten Bildschirmbereichs darstellt.
top
Nur lesbar Experimentell-
Eine Zahl, die die y-Koordinate (obere Kante) des gesamten Bildschirmbereichs darstellt.
Ereignisse
Erbt Ereignisse von seinem Elternteil, Screen
.
change
Experimentell-
Wird auf einem spezifischen Bildschirm ausgelöst, wenn sich eine Eigenschaft des Bildschirms ändert – Breite oder Höhe, verfügbare Breite oder verfügbare Höhe, Farbtiefe oder Ausrichtung, Bildschirmposition und verfügbare Bildschirmposition, Geräte-Pixelverhältnis, Bezeichnung oder Bildschirmzuweisung.
Beispiele
Wenn Window.getScreenDetails()
aufgerufen wird, wird der Nutzer um Erlaubnis gebeten, Fenster auf all seinen Bildschirmen zu verwalten (der Status dieser Berechtigung kann mit Permissions.query()
abgefragt werden, um window-management
zu überprüfen). Erteilt der Nutzer die Erlaubnis, enthält das resultierende ScreenDetails
-Objekt ScreenDetailed
-Objekte, die alle dem System des Nutzers zur Verfügung stehenden Bildschirme repräsentieren.
Das folgende Beispiel öffnet ein Fenster in der oberen linken Ecke des primären OS-Bildschirms:
// Return ScreenDetails
const allScreens = await window.getScreenDetails();
// Return the primary screen ScreenDetailed object
const primaryScreenDetailed = allScreens.screens.find(
(screenDetailed) => screenDetailed.isPrimary,
);
// Open a window in the top-left corner of the OS primary screen
window.open(
"https://example.com",
"_blank",
`left=${primaryScreenDetailed.availLeft},
top=${primaryScreenDetailed.availTop},
width=200,
height=200`,
);
Hinweis: Sehen Sie sich das Mehrfenster-Lernumgebung für ein vollständiges Beispiel an (sehen Sie sich auch den Quellcode an).
Spezifikationen
Specification |
---|
Window Management # api-screendetailed-interface |
Browser-Kompatibilität
BCD tables only load in the browser