Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
ScreenDetailed
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell:Dies ist eineexperimentelle Technologie
Überprüfen Sie dieBrowser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur insicheren Kontexten (HTTPS) in einigen oder allenunterstützenden Browsern verfügbar.
DasScreenDetailed-Interface derWindow 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 EigenschaftenScreenDetails.screens undScreenDetails.currentScreen abgerufen werden.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil,Screen.
availLeftSchreibgeschütztExperimentellEine Zahl, die die x-Koordinate (linke Kante) des verfügbaren Bildschirmbereichs darstellt.
availTopSchreibgeschütztExperimentellEine Zahl, die die y-Koordinate (obere Kante) des verfügbaren Bildschirmbereichs darstellt.
devicePixelRatioSchreibgeschütztExperimentellEine Zahl, die das Geräte-Pixelverhältnis des Bildschirms repräsentiert.
isInternalSchreibgeschütztExperimentellEin Boolean, der anzeigt, ob der Bildschirm intern für das Gerät oder extern ist.
isPrimarySchreibgeschütztExperimentellEin Boolean, der anzeigt, ob der Bildschirm als primärer Bildschirm des Betriebssystems (OS) festgelegt ist oder nicht.
labelSchreibgeschütztExperimentellEin String, der eine beschreibende Bezeichnung für den Bildschirm bereitstellt, zum Beispiel "Eingebautes Retina Display".
leftSchreibgeschütztExperimentellEine Zahl, die die x-Koordinate (linke Kante) des gesamten Bildschirmbereichs darstellt.
topSchreibgeschütztExperimentellEine Zahl, die die y-Koordinate (obere Kante) des gesamten Bildschirmbereichs darstellt.
Ereignisse
Erbt Ereignisse von seinem Elternteil,Screen.
changeExperimentellWird 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
WennWindow.getScreenDetails() aufgerufen wird, wird der Nutzer um Erlaubnis gebeten, Fenster auf all seinen Bildschirmen zu verwalten (der Status dieser Berechtigung kann mitPermissions.query() abgefragt werden, umwindow-management zu überprüfen). Erteilt der Nutzer die Erlaubnis, enthält das resultierendeScreenDetails-ObjektScreenDetailed-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 ScreenDetailsconst allScreens = await window.getScreenDetails();// Return the primary screen ScreenDetailed objectconst primaryScreenDetailed = allScreens.screens.find( (screenDetailed) => screenDetailed.isPrimary,);// Open a window in the top-left corner of the OS primary screenwindow.open( "https://example.com", "_blank", `left=${primaryScreenDetailed.availLeft}, top=${primaryScreenDetailed.availTop}, width=200, height=200`,);Hinweis:Sehen Sie sich dasMehrfenster-Lernumgebung für ein vollständiges Beispiel an (sehen Sie sich auch denQuellcode an).
Spezifikationen
| Specification |
|---|
| Window Management # api-screendetailed-interface |