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 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.

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

js
// 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

js
// 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

Siehe auch