Screen

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Screen
availHeight
availLeft
Non-standard
Relative to the Multi-screen origin
Non-standard
availTop
Non-standard
Relative to the Multi-screen origin
Non-standard
availWidth
change event
Experimental
colorDepth
height
isExtended
Experimental
left
Non-standard
Relative to the Multi-screen origin
Non-standard
lockOrientation
Deprecated
mozBrightness
DeprecatedNon-standard
mozEnabled
DeprecatedNon-standard
orientation
orientationchange event
DeprecatedNon-standard
pixelDepth
top
DeprecatedNon-standard
Relative to the Multi-screen origin
DeprecatedNon-standard
unlockOrientation
Deprecated
width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Requires a vendor prefix or different name for use.
Has more compatibility info.