设备姿态 API

设备姿态是指设备所处的物理位置，这可能是由传感器以及角度推导出来的。出现了新型的移动设备，它们具有某种可以改变其姿态的能力。最常见的设备类型是那些可以折叠的设备（其屏幕或围绕屏幕），使它们可以物理改变其外形尺寸。了解设备姿态的主要目的是通过响应式设计实现新的用户体验。

在上述“折叠”设备中，主要有两种不同的物理外形：具有单个柔性屏幕（无缝）的设备，以及具有两个屏幕（带缝）的设备。它们都可以围绕铰链折叠，当前规范适用于这两种类型。还应说明，无缝和带缝的设备都可以有不同的尺寸，从移动设备、平板到笔记本电脑大小。此外，还应注意，不同设备将有不同的默认方向（纵向或横向），折叠可能是垂直或水平的。

从通过避开折叠区域来增强网站的可用性，到为 Web 实现创新的用例，了解设备的姿态可以帮助开发人员根据不同设备定制其内容。

即使设备不是平放的情况下，内容也可以被浏览和消费，此时开发人员可能希望根据设备所处的姿态状态提供不同的布局。

以下内部槽被添加到 Document 接口。

[HTML] 规范定义了 Navigator 接口，本规范对其进行扩展：

WebIDL[SecureContext, Exposed=(Window)]
partial interface Navigator {
  [SameObject] readonly attribute DevicePosture devicePosture;
};

WebIDL[SecureContext, Exposed=(Window)]
interface DevicePosture : EventTarget {
  readonly attribute DevicePostureType type;
  attribute EventHandler onchange;
};

enum DevicePostureType {
  "continuous",
  "folded"      
};

本规范定义了以下 姿态 值：

1. 

   连续 姿态：连续姿态指的是“平坦”位置。这是大多数不允许不同姿态的设备的默认情况。

   包括没有折叠、铰链或类似功能的设备。

   由于硬件创新的性质，它还包括具有 双屏、可折叠、可卷曲或曲面屏幕的设备，只要它们 处于预期 Document 以平面布局 显示 的姿态。

   示例包括：

   • 在平坦、完全展开姿态下的可折叠设备。
   • 运行浏览器的可折叠设备，其窗口/部分不跨越铰链。
   • 处于平板模式并仅使用 1 个屏幕/侧面的 2 合 1 设备。
   • 不可折叠的设备。
   注意

   在某些情况下，设备可以运行多个应用程序，并处于非平坦的物理姿态，但只要浏览器不跨越多个屏幕/部分，相应的姿态就是连续的。

2. 折叠 姿态：折叠姿态是指可以物理折叠的设备。这些设备可以具有一个柔性屏幕或两个相邻的屏幕。此姿态在显示屏/部分之间形成一个不超过“平坦”位置的角度。

   示例包括：

   • 具有垂直铰链和内部屏幕的可折叠设备，处于“书本”姿态，其中内容跨越两个部分，并在 ~30° 和 ~170° 之间形成一个角度。
   • 具有水平铰链和内部屏幕的可折叠设备，处于“笔记本”姿态。
   注意

   当可折叠设备处于半折叠状态（如书本）时，实现者可能需要考虑文本方向和书写模式对布局和呈现的影响。

   例如，从右到左的语言（使用阿拉伯文、希伯来文、叙利亚文等文字的语言）以及许多东亚语言使用的垂直书写模式，其页面顺序与英文书籍相反，页码较小的页面在右侧。

   有关更多信息，请参阅中文、日文和韩文书写模式的差异。

在 API 中，姿态 值由 DevicePostureType 枚举值表示。

每个 Document 实例都有一个内部槽 [[CurrentPosture]]，它应在 Document 创建时初始化，否则必须在第一次 访问它们且读取其值之前 对它们进行初始化。用户 代理必须运行设备姿态 变更步骤，并将 document 设置为该 Document，将 disallowRecursion 设置为 true，以初始化它。

对于给定的 Document，当前姿态派生自 当前铰链角度和屏幕方向， 以及可能的其他特定于实现的信号。

这些表格是非规范性的。

关于此规范，目前没有报告新的安全注意事项。但是，建议查看本文档中列出的潜在10. 隐私注意事项。

1. 设计和开发不将内容（特别是按钮）放置在折叠/铰链区域的应用程序。由于折叠的弯曲性，使得使用手指在此区域进行交互变得困难甚至不可能。
2. 设计和开发不在折叠/铰链区域上跨越大型连续内容（如视频或图片）的应用程序。如果设备处于折叠状态，此区域会轻微扭曲内容和颜色。
3. 设计和开发更好地利用屏幕空间的应用程序，通过提供分屏 UI（将内容分割显示在屏幕不同部分的用户界面）， 使得应用程序提供一种差异化且更具功能性的界面。

• UI 元素的放置： 对话框的典型放置逻辑 是在水平和垂直方向上居中，但在具有对称折叠的 折叠设备中，它们可能最终位于折叠区域的中间， 从而更难与之交互，例如 点击按钮。由于 失真和光线反射，也可能使文本更难阅读。
• 全屏模式： 在全屏中调整元素大小时， 典型逻辑会将该元素扩展到 Window 的宽度和高度。 如果设备处于折叠状态，该 元素将跨折叠区域布局，从而导致较差的用户 体验。另一种做法是将该元素显示在折叠区域的上方 或下方。
• 改善用户体验： 使用此 API，可以在 设备折叠时创建不同且适配的用户体验， 从而获得更好的用户体验和改进的 可访问性。例如，在观看视频且设备 折叠时，视频可以显示在折叠区域上方，而 评论区默认显示在折叠区域下方。另一个 示例是视频会议应用将视频 源显示在折叠区域上方，将聊天显示在折叠区域下方。
• 内容不应只针对一种 posture 来设计： 可折叠设备的理念是 其 多功能性，以及用户能够按 自己认为合适的方式改变姿态。类似于方向， 重要的是不要总是替用户作选择，因为他们可能有 其他需求，而应允许他们选择更适合其需求的 UI。 理想情况下，最好使 UI 可配置。
• 面向辅助设备的内容公告： 使用 ARIA 实时区域动态公告重要的布局变化。 例如，当折叠改变网页布局时，确保 屏幕阅读器向用户公告这些变化。例如，如果 视频播放器被移动到屏幕顶部，评论被移动到 底部，像“视频播放器已移动到顶部屏幕， 评论已移动到折叠区域下方”这样的公告可以帮助用户更好地导航。
• 辅助技术兼容性： 使用各种辅助技术进行全面 测试，以确保在达到不同姿态时的兼容性 以及对变化的正确传达。

Device Posture API 给测试作者带来了挑战，因为要全面 测试接口需要物理硬件设备。为了解决 这一挑战，本文档定义了 [WEBDRIVER2] 扩展命令，允许用户 控制所报告的设备姿态并 模拟真实设备。

为了支持下面的扩展命令及其与 8. 算法的集成，顶级 可遍历必须具有以下 内部槽：

除了标记为非规范性的部分外，本规范中的所有编写指南、图表、示例和注释都是非规范性的。本规范中的其他内容均为规范性。

本文档中的关键词 MUST 和 SHOULD 应按 BCP 14 [RFC2119] [RFC8174] 中所述进行解读，且仅当它们如这里所示以全 大写形式出现时才如此。

本规范定义了一个产品的一致性标准： 一个实现其包含接口的用户代理。