blob: 2d61c9408ac15879795d68eed3f9b40c0e722b37 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
---
title: Screen
slug: Web/API/Screen
tags:
- API
- CSSOM View
- Interface
- Reference
browser-compat: api.Screen
translation_of: Web/API/Screen
---
{{APIRef("CSSOM")}}
The `Screen` interface represents a screen, usually the one on which the current window is being rendered, and is obtained using {{DOMxRef("window.screen")}}.
Note that browsers determine which screen to report as current by detecting which screen has the center of the browser window.
## Properties
- {{DOMxRef("Screen.availTop")}} {{Non-standard_Inline}}
- : Specifies the y-coordinate of the first pixel that is not allocated to permanent or semipermanent user interface features.
- {{DOMxRef("Screen.availLeft")}} {{Non-standard_Inline}}
- : Returns the first available pixel available from the left side of the screen.
- {{DOMxRef("Screen.availHeight")}}
- : Specifies the height of the screen, in pixels, minus permanent or semipermanent user interface features displayed by the operating system, such as the Taskbar on Windows.
- {{DOMxRef("Screen.availWidth")}}
- : Returns the amount of horizontal space in pixels available to the window.
- {{DOMxRef("Screen.colorDepth")}}
- : Returns the color depth of the screen.
- {{DOMxRef("Screen.height")}}
- : Returns the height of the screen in pixels.
- {{DOMxRef("Screen.left")}} {{Non-standard_Inline}}
- : Returns the distance in pixels from the left side of the main screen to the left side of the current screen.
- {{DOMxRef("Screen.orientation")}}
- : Returns the {{DOMxRef("ScreenOrientation")}} instance associated with this screen.
- {{DOMxRef("Screen.pixelDepth")}}
- : Gets the bit depth of the screen.
- {{DOMxRef("Screen.top")}} {{deprecated_inline}}{{Non-standard_Inline}}
- : Returns the distance in pixels from the top side of the current screen.
- {{DOMxRef("Screen.width")}}
- : Returns the width of the screen.
- {{DOMxRef("Screen.mozEnabled")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
- : Boolean. Setting to false will turn off the device's screen.
- {{DOMxRef("Screen.mozBrightness")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
- : Controls the brightness of a device's screen. A double between 0 and 1.0 is expected.
### Events handler
- {{DOMxRef("Screen.onorientationchange")}} {{Deprecated_Inline}}
- : A handler for the {{Event("orientationchange")}} event.
## Methods
- {{DOMxRef("Screen.lockOrientation")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
- : Lock the screen orientation (only works in fullscreen or for installed apps)
- {{DOMxRef("Screen.unlockOrientation")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
- : Unlock the screen orientation (only works in fullscreen or for installed apps)
## Example
```js
if (screen.pixelDepth < 8) {
// use low-color version of page
} else {
// use regular, colorful page
}
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
|
