Screen
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Die Screen-Schnittstelle repräsentiert einen Bildschirm, in der Regel den, auf dem das aktuelle Fenster dargestellt wird. Sie wird über window.screen abgerufen.
Browser bestimmen den als aktuell gemeldeten Bildschirm anhand des Bildschirms, auf dem sich die Mitte des Browserfensters befindet.
Instanzeigenschaften
Erbt außerdem Eigenschaften von der übergeordneten Schnittstelle EventTarget.
Screen.availHeightSchreibgeschützt-
Gibt die Höhe des Bildschirms in Pixeln an, abzüglich dauerhaft oder über längere Zeit angezeigter Bedienelemente des Betriebssystems, etwa der Taskleiste unter Windows.
Screen.availWidthSchreibgeschützt-
Gibt den horizontalen Platz in Pixeln zurück, der für das Fenster verfügbar ist.
Screen.colorDepthSchreibgeschützt-
Gibt die Farbtiefe des Bildschirms zurück.
Screen.heightSchreibgeschützt-
Gibt die Höhe des Bildschirms in Pixeln zurück.
Screen.isExtendedSchreibgeschützt Sicherer Kontext-
Gibt
truezurück, wenn das Gerät der nutzenden Person über mehrere Bildschirme verfügt, andernfallsfalse. Screen.orientationSchreibgeschützt-
Gibt die diesem Bildschirm zugeordnete
ScreenOrientation-Instanz zurück. Screen.pixelDepthSchreibgeschützt-
Gibt die Bittiefe des Bildschirms zurück.
Screen.widthSchreibgeschützt-
Gibt die Breite des Bildschirms zurück.
Screen.mozEnabled-
Boolescher Wert. Wird er auf false gesetzt, schaltet sich der Bildschirm des Geräts aus.
Screen.mozBrightness-
Steuert die Helligkeit des Bildschirms eines Geräts. Erwartet wird eine Gleitkommazahl zwischen 0 und 1.0.
Nicht standardisierte Eigenschaften
Die folgenden Eigenschaften sind Teil der Window Management API. Diese stellt sie über die ScreenDetailed-Schnittstelle bereit; deshalb sind sie dort dokumentiert. In Browsern, die diese API nicht unterstützen, sind jedoch nicht standardisierte Versionen dieser Eigenschaften über die Screen-Schnittstelle verfügbar. Einzelheiten zu dieser nicht standardisierten Unterstützung finden Sie in der Tabelle zur Browser-Kompatibilität auf dieser Seite.
Screen.availLeftSchreibgeschützt Sicherer Kontext-
Eine Zahl, die die x-Koordinate (linker Rand) des verfügbaren Bildschirmbereichs angibt.
Screen.availTopSchreibgeschützt Sicherer Kontext-
Eine Zahl, die die y-Koordinate (oberer Rand) des verfügbaren Bildschirmbereichs angibt.
Screen.leftSchreibgeschützt Sicherer Kontext-
Eine Zahl, die die x-Koordinate (linker Rand) des gesamten Bildschirmbereichs angibt.
Screen.topSchreibgeschützt Sicherer Kontext-
Eine Zahl, die die y-Koordinate (oberer Rand) des gesamten Bildschirmbereichs angibt.
Instanzmethoden
Erbt außerdem Methoden von der übergeordneten Schnittstelle EventTarget.
Screen.lockOrientation-
Sperrt die Bildschirmausrichtung (funktioniert nur im Vollbildmodus oder bei installierten Apps).
Screen.unlockOrientation-
Entsperrt die Bildschirmausrichtung (funktioniert nur im Vollbildmodus oder bei installierten Apps).
Ereignisse
changeSicherer Kontext-
Wird für einen bestimmten Bildschirm ausgelöst, wenn sich dessen Breite oder Höhe, verfügbare Breite oder Höhe, Farbtiefe oder Ausrichtung ändert.
orientationchange-
Wird ausgelöst, wenn sich die Bildschirmausrichtung ändert.
Beispiele
if (screen.colorDepth < 8) {
// use low-color version of page
} else {
// use regular, colorful page
}
Spezifikationen
| Spezifikation |
|---|
| CSSOM View Module> # the-screen-interface> |