设备姿态 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 可以在设备折叠时创建不同且适配的用户体验，提供更好的用户体验和改进的可访问性。 例如，当设备折叠时观看视频，视频可以显示在折叠上方，而评论区可以默认显示在折叠下方。 另一个例子是视频会议应用程序在折叠上方显示视频流，在折叠下方显示聊天。
• 内容不应仅设计为适合一种 姿态： 可折叠设备的理念是它们的多功能性和用户可以根据自己的需要更改姿态。 类似于 方向，重要的是不要总是替用户做选择， 因为他们可能有其他需求，而是让他们选择最适合自己需求的 UI。理想情况下，建议使 UI 可配置。
• 辅助设备的内容提示： 使用 ARIA 实时区域动态宣布显著的布局更改。 例如，当折叠改变网页的布局时，确保屏幕阅读器将这些更改通知给用户。 例如，如果视频播放器移动到屏幕顶部，评论移动到折叠下方，像“视频播放器移动到屏幕顶部，评论移动到折叠下方”这样的提示可以帮助用户更好地导航。
• 辅助技术兼容性： 进行全面的辅助技术测试，以确保在达到不同姿态时的兼容性和正确的信息传递。

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

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

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

本文档中的关键词 MUST 和 SHOULD 应按 BCP 14 [RFC2119] [RFC8174] 的描述进行解释，仅当这些词汇完全以大写形式出现时，如此处所示。

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