ScreenDetailed: availTop-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 availTop schreibgeschützte Eigenschaft des ScreenDetailed-Interfaces ist eine Zahl, die die y-Koordinate (obere Kante) des verfügbaren Bildschirmbereichs innerhalb des virtuellen Bildschirmarrangements des Betriebssystems darstellt, relativ zum Multi-Screen-Ursprung.

Diese entspricht der ScreenDetailed.top-Eigenschaft, zuzüglich der Höhe eines beliebigen Betriebssystem-UI-Elements, das oben auf dem Bildschirm gezeichnet wird. Fenster können nicht in diesen Bereichen platziert werden, daher ist availTop nützlich, um Ihnen die obere Grenze des tatsächlichen Bereichs zu geben, der zum Öffnen oder Platzieren von Fenstern verfügbar ist.

Hinweis: Eine nicht standardmäßige Implementierung der availTop-Eigenschaft ist in allen Browsern im Screen-Interface verfügbar. Siehe das Nicht-standardmäßige Beispiel unten für Anwendungsdetails und die Screen-Referenzseite für Informationen zur Browserunterstützung in Bezug auf die nicht standardmäßige Implementierung.

Wert

Eine Zahl.

Beispiele

Window Management API Beispiel

js
// Available in browsers that support the Window Management API
const screenDetails = await window.getScreenDetails();

// Return the availTop value of the first screen
const screen1AvailTop = screenDetails.screens[0].availTop;

Nicht-standardmäßiges Beispiel

js
// Available in all browsers
// Return the availTop value of the current screen
const screenAvailTop = window.screen.availTop;

Spezifikationen

Specification
Window Management
# ref-for-dom-screendetailed-availtop

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch