ScreenDetailed: top 属性

实验性： 这是一项 实验性技术
在生产环境中使用此功能之前，请仔细检查 浏览器兼容性表。

安全上下文： 此功能仅在 安全上下文（HTTPS）中可用，在某些或所有 支持的浏览器 中。

top 属性是 ScreenDetailed 接口的只读属性，是一个数字，表示 OS 虚拟屏幕排列中整个屏幕区域的 y 坐标（顶部边缘），相对于 多屏幕原点。

这等于真正的顶部边缘，忽略任何在屏幕顶部绘制的 OS UI 元素。窗口无法放置在这些区域中；要获取窗口可以放置的屏幕区域的顶部坐标，请使用 ScreenDetailed.availTop。

注意：在 Firefox 中，Screen 接口上提供了一个 top 属性的非标准实现。有关用法详细信息，请参见下面的 非标准示例，并参见 Screen 参考页面，了解与非标准实现相关的浏览器支持信息。

值

一个数字。

示例

窗口管理 API 示例

js
// Available in browsers that support the Window Management API
const screenDetails = await window.getScreenDetails();

// Return the absolute top value of the first screen
const screen1Top = screenDetails.screens[0].top;

非标准示例

js
// Available in Firefox
// Return the absolute top value of the current screen
const screenTop = window.screen.top;

规范

规范
窗口管理
# ref-for-dom-screendetailed-top

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅