Screen

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

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

浏览器兼容性