屏幕

Screen 接口表示一个屏幕,通常是当前窗口正在渲染的屏幕,可以使用 window.screen 获取。

请注意,浏览器通过检测浏览器窗口中心的屏幕来确定哪个屏幕作为当前屏幕。

实例属性

还继承了其父级 EventTarget 的属性.

Screen.availHeight

以像素为单位指定屏幕高度,减去操作系统显示的永久性或半永久性用户界面功能,例如 Windows 上的任务栏。

Screen.availWidth

返回窗口可用的水平空间,以像素为单位。

Screen.colorDepth

返回屏幕的颜色深度。

Screen.height

返回屏幕高度,以像素为单位。

Screen.isExtended 实验性 安全上下文

如果用户的设备有多个屏幕,则返回 true,否则返回 false

Screen.orientation

返回与该屏幕关联的 ScreenOrientation 实例。

Screen.pixelDepth

获取屏幕的位深度。

Screen.width

返回屏幕宽度。

Screen.mozEnabled 非标准 已弃用

布尔值。设置为 false 将关闭设备的屏幕。

Screen.mozBrightness 非标准 已弃用

控制设备屏幕的亮度。预期是一个介于 0 和 1.0 之间的双精度数。

非标准属性

以下属性在 窗口管理 API 中指定,使其在 ScreenDetailed 接口上可用;这是我们选择记录它们的位置。但是,这些属性的非标准版本在不支持该 API 的浏览器中,在 Screen 接口上可用。有关非标准支持的详细信息,请参阅此页面的 浏览器兼容性 表。

Screen.availLeft 只读 非标准 安全上下文

表示可用屏幕区域的 x 坐标(左边缘)的数字。

Screen.availTop 只读 非标准 安全上下文

表示可用屏幕区域的 y 坐标(顶部边缘)的数字。

Screen.left 只读 非标准 安全上下文

表示整个屏幕区域的 x 坐标(左边缘)的数字。

Screen.top 只读 非标准 已弃用 安全上下文

表示整个屏幕区域的 y 坐标(顶部边缘)的数字。

实例方法

还继承了其父级 EventTarget 的方法.

Screen.lockOrientation 已弃用

锁定屏幕方向(仅在全屏或已安装的应用程序中有效)

Screen.unlockOrientation 已弃用

解锁屏幕方向(仅在全屏或已安装的应用程序中有效)

事件

change 实验性 安全上下文

当特定屏幕以某种方式改变时触发——宽度或高度、可用宽度或高度、颜色深度或方向。

orientationchange 已弃用 非标准

当屏幕方向改变时触发。

示例

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

规范

规范
CSSOM 视图模块
# the-screen-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。