Screen

Das Screen-Interface repräsentiert einen Bildschirm, in der Regel den, auf dem das aktuelle Fenster gerendert wird, und wird mit window.screen abgerufen.

Beachten Sie, dass Browser den aktuellen Bildschirm anhand der Position des Zentrums des Browserfensters bestimmen.

Instanzeigenschaften

Erbt auch Eigenschaften von seinem Elternteil EventTarget.

Screen.availHeight

Gibt die Höhe des Bildschirms in Pixeln an, abzüglich permanenter oder semipermanenter Benutzeroberflächenelemente, die vom Betriebssystem angezeigt werden, wie die Taskleiste unter Windows.

Screen.availWidth

Gibt die in Pixeln verfügbare horizontale Fläche für das Fenster zurück.

Screen.colorDepth

Gibt die Farbtiefe des Bildschirms zurück.

Screen.height

Gibt die Höhe des Bildschirms in Pixeln zurück.

Screen.isExtended Experimentell Sicherer Kontext

Gibt true zurück, wenn das Gerät des Benutzers über mehrere Bildschirme verfügt, und false, wenn nicht.

Screen.orientation

Gibt die ScreenOrientation-Instanz zurück, die mit diesem Bildschirm verbunden ist.

Screen.pixelDepth

Ruft die Bittiefe des Bildschirms ab.

Screen.width

Gibt die Breite des Bildschirms zurück.

Screen.mozEnabled Nicht standardisiert Veraltet

Boolean. Das Setzen auf false schaltet den Bildschirm des Geräts aus.

Screen.mozBrightness Nicht standardisiert Veraltet

Steuert die Helligkeit des Bildschirms eines Geräts. Ein Wert zwischen 0 und 1,0 wird erwartet.

Nicht standardisierte Eigenschaften

Die folgenden Eigenschaften sind als Teil der Window Management API festgelegt, die sie im ScreenDetailed-Interface verfügbar macht; dort haben wir uns entschieden, sie zu dokumentieren. Nicht standardisierte Versionen dieser Eigenschaften sind jedoch im Screen-Interface in Browsern verfügbar, die diese API nicht unterstützen. Siehe die Browser-Kompatibilität-Tabelle dieser Seite für Details zur nicht standardisierten Unterstützung.

Screen.availLeft Schreibgeschützt Nicht standardisiert Sicherer Kontext

Eine Zahl, die die x-Koordinate (linke Kante) des verfügbaren Bildschirmbereichs repräsentiert.

Screen.availTop Schreibgeschützt Nicht standardisiert Sicherer Kontext

Eine Zahl, die die y-Koordinate (obere Kante) des verfügbaren Bildschirmbereichs repräsentiert.

Screen.left Schreibgeschützt Nicht standardisiert Sicherer Kontext

Eine Zahl, die die x-Koordinate (linke Kante) der gesamten Bildschirmfläche repräsentiert.

Screen.top Schreibgeschützt Nicht standardisiert Veraltet Sicherer Kontext

Eine Zahl, die die y-Koordinate (obere Kante) der gesamten Bildschirmfläche repräsentiert.

Instanzmethoden

Erbt auch Methoden von seinem Elternteil EventTarget.

Screen.lockOrientation Veraltet

Sperrt die Bildschirmorientierung (funktioniert nur im Vollbildmodus oder für installierte Apps)

Screen.unlockOrientation Veraltet

Entsperrt die Bildschirmorientierung (funktioniert nur im Vollbildmodus oder für installierte Apps)

Ereignisse

change Experimentell Sicherer Kontext

Wird ausgelöst, wenn sich ein bestimmter Bildschirm in irgendeiner Weise ändert — Breite oder Höhe, verfügbare Breite oder Höhe, Farbtiefe oder Ausrichtung.

orientationchange Veraltet Nicht standardisiert

Wird ausgelöst, wenn sich die Bildschirmorientierung ändert.

Beispiele

js
if (screen.colorDepth < 8) {
  // use low-color version of page
} else {
  // use regular, colorful page
}

Spezifikationen

Specification
CSSOM View Module
# the-screen-interface

Browser-Kompatibilität

BCD tables only load in the browser