ScreenDetailed: availTop 属性

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

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

availTop 是 ScreenDetailed 接口的一个只读属性，表示 OS 虚拟屏幕排列中可用屏幕区域的 y 坐标（上边缘），相对于 多屏幕原点。

它等于 ScreenDetailed.top 属性加上屏幕顶部绘制的任何 OS UI 元素的高度。窗口无法放置在这些区域，因此 availTop 可用于提供打开或放置窗口的实际可用区域的顶部边界。

注意：所有浏览器中的 Screen 接口都提供了 availTop 属性的非标准实现。有关用法详细信息，请参阅下面的 非标准示例，有关非标准实现的浏览器支持信息，请参阅 Screen 参考页面。

值

一个数字。

示例

窗口管理 API 示例

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

// Return the availTop value of the first screen
const screen1AvailTop = screenDetails.screens[0].availTop;

非标准示例

js
// Available in all browsers
// Return the availTop value of the current screen
const screenAvailTop = window.screen.availTop;

规范

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

浏览器兼容性

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

另请参阅