ScreenDetailed: top Eigenschaft
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.
Die top
-Eigenschaft der schreibgeschützten
ScreenDetailed
-Schnittstelle ist eine Zahl, die die y-Koordinate (obere Kante) des gesamten Bildschirmbereichs innerhalb der Betriebssystem-Virtualscreen-Anordnung darstellt, relativ zum Multi-Screen-Ursprung.
Dies entspricht der tatsächlichen oberen Kante, ohne Berücksichtigung von UI-Elementen des Betriebssystems, die am oberen Bildschirmrand gezeichnet werden. Fenster können nicht in diesen Bereichen platziert werden; um die obere Koordinate des Bildschirmbereichs zu erhalten, in dem Fenster platziert werden können, verwenden Sie ScreenDetailed.availTop
.
Hinweis: In Firefox ist eine nicht standardisierte Implementierung der top
-Eigenschaft auf der Screen
-Schnittstelle verfügbar. Weitere Informationen zur Verwendung finden Sie im Nicht-standardmäßigen Beispiel unten und auf der Screen
-Referenzseite für Informationen zur Browser-Unterstützung in Bezug auf die nicht standardisierte Implementierung.
Wert
Eine Zahl.
Beispiele
Beispiel für die Window Management API
// Available in browsers that support the Window Management API
const screenDetails = await window.getScreenDetails();
// Return the absolute top value of the first screen
const screen1Top = screenDetails.screens[0].top;
Nicht-standardmäßiges Beispiel
// Available in Firefox
// Return the absolute top value of the current screen
const screenTop = window.screen.top;
Spezifikationen
Specification |
---|
Window Management # ref-for-dom-screendetailed-top |
Browser-Kompatibilität
BCD tables only load in the browser