核心可访问性 API 映射 1.2

W3C 候选推荐草案 2026 年 4 月 30 日

关于本文档的更多详细信息

此版本：: https://www.w3.org/TR/2026/CRD-core-aam-1.2-20260430/
最新发布版本：: https://www.w3.org/TR/core-aam-1.2/
最新编辑草案：: https://w3c.github.io/core-aam/
历史：: https://www.w3.org/standards/history/core-aam-1.2/; 提交历史
实现报告：: https://w3c.github.io/test-results/core-aam-1.2/
最新推荐标准：: https://www.w3.org/TR/core-aam-1.1/
编辑：: Valerie Young (Igalia, S.L.); Cynthia Shelly (W3C 特邀专家)
前任编辑：: Alexander Surkov (Igalia, S.L.)（编辑至 2025 年 8 月）; Joanmarie Diggs (Igalia, S.L.)（编辑至 2022 年 10 月）; Richard Schwerdtfeger (Knowbility)（编辑至 2017 年 10 月）; Joseph Scheuhammer (Inclusive Design Research Centre, OCAD University)（编辑至 2017 年 5 月）; Andi Snow-Weaver (IBM)（编辑至 2012 年 12 月）; Aaron Leventhal (IBM)（编辑至 2009 年 1 月）; Michael Cooper (W3C)（编辑至 2023 年 7 月）
平台映射维护者：: Benjamin Beaudry (Microsoft Corp.) (UIA); James Craig (Apple, Inc.) (AX API); Joanmarie Diggs (Igalia, S.L.) (ATK / AT-SPI); Alexander Surkov (Igalia, S.L.) (MSAA, IAccessible2); David Tseng (Google LLC) (Android Accessibility API)
反馈：: GitHub w3c/core-aam (拉取请求, 新议题, 开放议题)

摘要

本文档描述用户代理应如何向可访问性 API暴露 Web 内容语言的语义。这有助于残障用户使用辅助技术获取信息并与之交互。记录这些映射可促进由可访问性 API 实现的角色、状态、属性和事件的可互操作暴露，并有助于确保此信息以符合作者意图的方式呈现。

本 Core Accessibility API Mappings 规范定义了适用于多种内容技术的支持，包括通用键盘导航支持，以及通过 WAI-ARIA [WAI-ARIA-1.2] 在 Web 内容中提供的通用角色、状态和属性的映射。其他 Accessibility API Mappings 规范依赖并扩展此 Core 规范，以用于特定技术，包括原生技术特性和 WAI-ARIA 扩展。本文档更新并最终将取代 Core Accessibility API Mappings 1.1 [CORE-AAM-1.1] W3C 推荐标准中的指南。它是 WAI-ARIA 概述中所述 WAI-ARIA 套件的一部分。

本文档的状态

本节描述本文档在发布时的状态。当前 W3C 出版物列表以及本技术报告的最新修订版可在 W3C 标准和草案索引中找到。

Accessible Rich Internet Applications Working Group 征求对本规范任何方面的反馈。提交反馈时，请结合配套文档的上下文考虑相关问题。若要评论，请在 W3C core-aam GitHub 仓库中提交议题。如果这不可行，请发送电子邮件至 public-aria@w3.org（评论归档）。文档的进行中更新可在公开可见的编辑草案中查看。

活规范 — 本文档作为活规范维护。有关最新规范性版本，请访问 Core Accessibility API Mappings。

本文档由 Accessible Rich Internet Applications Working Group 使用推荐标准轨道作为候选推荐草案发布。

作为候选推荐发布并不表示 W3C 及其成员认可。候选推荐草案整合了自上一个候选推荐以来的更改，工作组打算将这些更改纳入后续的候选推荐快照。

这是一份草案文档，随时可能被其他文档更新、替换或废弃。除了作为进行中的工作之外，引用本文档是不适当的。

本文档由一个按照 W3C 专利政策运行的小组制作。 W3C 维护一份公开的任何专利披露列表，这些披露与该小组的交付物有关；该页面还包括披露专利的说明。实际知晓某项专利且认为该专利包含必要权利要求的个人必须按照 W3C 专利政策第 6 节披露相关信息。

本文档受 2025 年 8 月 18 日 W3C 流程文档约束。

本节是非规范性的。

Core Accessibility API Mappings 规定 WAI-ARIA 角色、状态和属性应如何由用户代理通过平台可访问性 API 暴露。它是用于定义和支持 WAI-ARIA 规范的一组资源的一部分，其中包括以下文档：

可访问富互联网应用（WAI-ARIA）1.2 [WAI-ARIA-1.2]，一项 W3C 推荐标准，定义 WAI-ARIA 标准。
WAI-ARIA 创作实践指南，描述 Web 内容开发者如何使用 WAI-ARIA 开发可访问的富互联网应用。它提供了主要面向 Web 应用开发者的详细建议和示例，但对用户代理和辅助技术开发者也有用。
可访问富互联网应用（WAI-ARIA 路线图） [WAI-ARIA-ROADMAP]，定义使富 Web 内容可访问的路径，包括已经采取的步骤、剩余的未来步骤以及时间线。

有关 WAI-ARIA 的介绍，请参见 WAI-ARIA 概述。

可访问性 API 使得向辅助技术传达关于用户界面的可访问性信息成为可能。此信息包括：

描述性属性（角色、名称、值、位置等）
瞬时状态（按下、聚焦等）
事件（文本已更改、按钮已被点击、复选框已切换）
用户可能执行的动作（点击、选中/切换、拖动等）
关系（父/子、描述/被描述对象、前一对象/后一对象等）
文本内容

本规范涵盖的可访问性 API 包括：

MSAA 与 IAccessible2 1.3 [IAccessible2]
User Interface Automation [UI-AUTOMATION]
ATK - Accessibility Toolkit [ATK] 和 Assistive Technology Service Provider Interface [AT-SPI]，以下称为 “ATK/AT-SPI”
macOS Accessibility Protocol [AXAPI]
Android [Android-Accessibility-API]

WAI-ARIA 1.0 用户代理实现指南包含了 [UIA-EXPRESS] 的映射，也称为 IAccessibleEx，其已在 Microsoft Internet Explorer 8.0 - 11 中实现。强烈鼓励新的实现改用 UI Automation。

如果用户代理开发者需要使用其他可访问性 API 暴露信息，建议他们与该 API 运行所在平台的开发者以及该平台上的辅助技术开发者密切合作。

出于各种技术和历史原因，可访问性 API 并非都以相同方式工作。在许多情况下，它们各自如何向辅助技术命名或暴露角色、状态和属性之间并不存在简单的一对一关系。以下小节描述其中一些 API 的若干区别性特征。

MSAA、IAccessible2、UIA 和 AX API 各自定义了一个 API，该 API 由暴露其内容和交互式组件信息的软件应用程序以及使用这些信息的辅助技术共享。相反，Linux/GNOME 将该共享接口分离为两个方面，每个方面由不同的可访问性 API 表示：ATK 或 AT-SPI。

ATK 定义了一个由软件实现的接口，用于暴露可访问性信息，而 AT-SPI 是一个桌面服务，用于从活动应用程序收集可访问性信息并将其转发给其他感兴趣的应用程序，通常是辅助技术。

例如，GNOME GUI 工具包 [GTK] 为每个部件（菜单、组合框、复选框等）实现 ATK 的相关方面，以便 GTK 部件暴露关于自身的可访问性信息。 AT-SPI 随后从使用 GTK 构建的应用程序获取这些信息，并使其可供相关方使用。

ATK 与实现者最相关，而 AT-SPI 与使用者相关。在映射 WAI-ARIA 角色、状态和属性的上下文中，用户代理是实现者，并使用 ATK。辅助技术是使用者，并使用 AT-SPI。

UI Automation 将应用程序用户界面的每个元素表示为自动化元素。自动化元素构成应用程序可访问性树的节点，可由自动化客户端查询、遍历并与之交互。

UI Automation 中有几个核心概念：

自动化元素 - 控件和某些应用程序内容表示为自动化元素。
元素属性 - 自动化元素具有若干通用属性，以与框架无关的方式描述原生框架元素特征，使所有自动化客户端都能理解。访问元素属性值有几种方式，如下所述。
控件模式 - 不同框架中的一些常见交互性在 UIA 中表示为控件模式，使不同的自动化客户端能够使用通用的编程接口与控件交互。
事件 - 与其他可访问性 API 类似，自动化元素支持各种事件，允许自动化提供程序就重要状态变化通知客户端。

所有自动化元素都继承自 IUIAutomationElement 接口，且所有非特定于某个控件模式的属性都可以通过该接口查询。访问 UI Automation 元素属性有几种方式：

对当前值的直接属性访问器 - Current{PropertyName}，例如 IUIAutomationElement::CurrentName 用于 Name 属性
缓存属性访问器 - Cached{PropertyName}，例如 IUIAutomationElement::CachedName 用于 Name 属性。在远程环境中使用提供程序和客户端时，首选使用缓存值。
GetCurrentPropertyValue，并传入与该属性对应的 UIA Property ID 枚举值以获取当前值，例如 IUIAutomationElement::GetCurrentPropertyValue(UIA_NamePropertyId) 用于 Name 属性。
GetCachedPropertyValue，并传入与该属性对应的 UIA Property ID 枚举值以获取缓存值，例如 IUIAutomationElement::GetCachedPropertyValue(UIA_NamePropertyId) 用于 Name 属性。

特定 UIA 控件模式的属性也使用相关控件模式接口以相同方式查询。以 Toggle Pattern 为例，若要查询 ToggleState 属性，客户端可以使用 IUIAutomationTogglePattern::CurrentToggleState 或 IUIAutomationTogglePattern::GetCurrentPropertyValue(UIA_ToggleToggleStatePropertyId) 来获取当前值。

本规范中的属性映射提供 {PropertyName}，并不指定访问属性值的所有具体方式。自动化客户端可以根据具体需要和编码风格约定，使用上述约定访问当前值或缓存值。

Android 可访问性服务和应用程序都将用户界面元素表示为 AccessibilityNodeInfo 对象树。可访问性服务接收事件，遍历 AccessibilityNodeInfo 树、检索属性并在节点上执行动作。相反，Android 应用程序通过构造视图或 composable，或直接通过 AccessibilityNodeProvider，间接构建 AccessibilityNodeInfo 树。然后它们随后触发事件并处理动作。

对于 WAI-ARIA 实现者，尤其感兴趣的是到 AccessibilityNodeInfo 和 AccessibilityEvent 上的属性、动作和事件的映射。

每个平台可访问性 API 都包含一种为可访问性树中创建的每个可访问名称和可访问描述可访问对象分配和检索属性的方式。可访问性树。这些属性如何实现以及如何命名会因 API 而异。

例如，在 MSAA 中，所有可访问对象都支持 accName 属性，用于存储该对象的可访问名称。当该对象也支持拥有可访问描述时， MSAA 会将此属性存储在该对象的 accDescription 属性中。

使用 ATK 的软件可以读取和写入对象的 accessible-name 和 accessible-description 属性。相应地，AT-SPI 可以通过其 atspi_accessible_get_name 和 atspi_accessible_get_description 函数查询这些属性的值。

UIA 可访问性树中的自动化元素具有 Name 属性。当该对象也支持拥有可访问描述时， UIA 会将此属性存储在该对象的 FullDescription 属性中。

对象的可访问描述，当由 aria-description 或 aria-describedby 提供时，应在 accessibilityCustomContent API 中暴露。否则，它应暴露为 AXHelp。

在 Android 中，可访问名称映射到 AccessibilityNodeInfo 上定义的多个属性，例如内容描述、补充描述和文本。

更多详细信息，请参见可访问名称和描述计算规范。

除标记为非规范性的章节外，本规范中的所有创作指南、图表、示例和注释均为非规范性的。本规范中的其他所有内容均为规范性的。

本文档中的关键词 MAY、MUST、MUST NOT、SHOULD 和 SHOULD NOT 应按 BCP 14 [RFC2119] [RFC8174] 中的描述解释，但仅在它们如本文所示全部以大写字母出现时才如此解释。

规范性章节提供用户代理和辅助技术为使实现符合本规范而 MUST 遵循的要求。

非规范性（资料性）章节提供有助于理解本规范的信息。此类章节可以包含推荐实践的示例，但为了符合本规范，并不要求遵循这些建议。

WAI-ARIA 规范将某些特性列为已弃用。尽管这意味着鼓励作者不要使用此类特性，但预计这些特性仍可能在遗留内容中使用。因此，用户代理继续将这些特性映射到可访问性 API 非常重要，并且这样做也是符合本规范的一部分。当未来版本的 WAI-ARIA 规范将此类特性从已弃用更改为已移除时，它们也将从映射中移除，用户代理将不再被要求继续支持这些特性。

在平台可访问性 API支持的情况下，用户代理通过桌面可访问性 WAI-ARIA 语义的标准机制暴露桌面可访问性 API。例如，对于 WAI-ARIA 部件，可比较该部件在类似桌面部件中如何暴露。一般而言，大多数 WAI-ARIA 部件能力都通过可访问性 API 的角色、值、布尔型状态以及关系来暴露。

就 WAI-ARIA 1.0 和 1.1 而言，可访问性 API 仅单向工作。用户代理通过可访问性 API 发布 WAI-ARIA 信息（角色、状态和属性），而 AT 可以使用同一 API 获取该信息。然而，另一个方向并不受支持。WAI-ARIA 1.0 和 1.1 并未定义辅助技术直接修改 WAI-ARIA 信息的机制。

术语“exposing”、“mapping”和“including”指在可访问对象的节点中创建可访问性树，并用特定于可访问性 API 的状态和属性填充这些对象。

WAI-ARIA 角色、状态和属性旨在当具有这些语义的原生宿主语言元素不可用时，添加语义信息，并且通常用于自身没有原生语义的元素。它们也可以用于与目标对象具有相似但不完全相同语义的元素（例如，嵌套列表可用于表示树结构）。此方法可作为旧浏览器后备策略的一部分，这些浏览器没有 WAI-ARIA 实现；或者因为重新利用的元素的原生呈现减少了所需的样式和/或脚本量。除以下概述的情况外，用户代理MUST 始终使用 WAI-ARIA 语义来定义它如何向可访问性 API暴露该元素，而不是使用宿主语言语义。

宿主语言可能具有与角色对应的隐式 WAI-ARIA 语义的特性。当提供了一个 WAI-ARIA 角色，且该角色在可访问性 API 中有对应角色时，用户代理 MUST 使用 WAI-ARIA 角色的语义进行处理，而不是原生语义，除非该角色需要 WAI-ARIA 状态和属性，而这些状态和属性的属性被宿主语言在原生元素上明确禁止。角色的值不会像状态和属性的值那样发生冲突，并且因为预期作者即使在通常不会被重新利用的元素上提供 WAI-ARIA 角色，也应有有效理由。例如，旋钮按钮通常由文本字段（<input type="text">）构造，以获得大多数默认键盘支持。但是，原生角色“文本字段”并不正确，因为它不能恰当地传达旋钮按钮的附加功能。作者添加 WAI-ARIA 角色 spinbutton（<input type="text" role="spinbutton" ...>），以便该控件在可访问性 API 中被正确映射。当提供的 WAI-ARIA 角色在可访问性 API 中没有对应角色时，用户代理 MAY 除 WAI-ARIA 角色外，还暴露原生语义。如果宿主语言元素被一个 WAI-ARIA 角色覆盖，而该角色的语义或结构不等同于原生宿主语言语义，也不等同于这些语义的子类，则将任何具有“允许的可访问性子角色”中指定角色的子元素视为具有 presentation 或 none。

注

上述文本与 WAI-ARIA 规范略有不同。要求用户代理暴露 WAI-ARIA 角色而不是原生角色，本意是仅适用于从 WAI-ARIA 角色到可访问性 API 中相应角色存在直接映射的情况。该要求在 WAI-ARIA 规范中的措辞并不明确，然而，且已被实现者作出不同解释。这里对此要求进行了澄清，并添加了一项附加声明，以表明如果没有直接映射到可访问性 API 中的角色，用户代理可以暴露原生语义。由于存在不同的实现，将建议作者不要在 WAI-ARIA Authoring Practices Guide 中，将此类 WAI-ARIA 角色添加到在自身具有语义的原生元素上。

当 WAI-ARIA 状态和属性对应于具有相同隐式 WAI-ARIA 语义的宿主语言特性时，如果值不同步，可能会出现问题。例如， HTML checked 属性和 aria-checked 属性可能具有冲突的值。因此，为防止向辅助技术提供冲突的状态和属性，宿主语言将明确声明在哪些情况下，在宿主语言元素上使用 WAI-ARIA 属性会与该元素的原生属性发生冲突。当宿主语言声明某个 WAI-ARIA 属性与给定元素的原生属性存在直接语义冲突时，用户代理 MUST 忽略该 WAI-ARIA 属性，并改用具有相同隐式语义的宿主语言属性。

宿主语言还可能记录不能用 WAI-ARIA 覆盖的特性（这些称为“强原生语义”）。这些可以是具有隐式 WAI-ARIA 语义的特性，也可以是在用 WAI-ARIA 改变语义时处理会变得不确定的特性。虽然一致性检查器在 WAI-ARIA 角色用于具有强原生语义的元素上时可能会发出错误或警告，但用户代理 MUST 仍然在将该元素暴露给可访问性 API 时，使用 WAI-ARIA 角色的语义值。

平台可访问性 API可能具有 WAI-ARIA 中没有的特性。同样， WAI-ARIA 暴露了在发布时尚不被可访问性 API 支持的能力。通常，并非所有 WAI-ARIA 属性与平台可访问性 API 之间都存在一对一关系。当 WAI-ARIA 角色、状态和属性不直接映射到某个可访问性 API，并且该 API 中存在用于暴露 WAI-ARIA 角色、状态和属性及其值的机制时，用户代理 MUST 按如下方式使用该机制暴露 WAI-ARIA 数据：

在 IAccessible2 和 ATK/AT-SPI 中，使用对象属性来暴露语义，这些语义并不直接受 API 支持。对象属性是名称-值对，其规定较为宽泛，并且在可访问性 API 中没有特定接口的情况下，非常灵活地用于暴露相关内容。例如，目前，aria-live 属性可以通过对象属性暴露，因为可访问性 API 没有可用的此类属性。关于暴露对象属性名称-值对的具体规则贯穿本文档进行描述，而一般情况的规则见状态和属性映射。
在 Microsoft UIA 中，使用 AriaRole 和 AriaProperties 属性来暴露控制类型中不直接支持的语义。

注

MSAA 没有提供用于暴露不直接映射到 API 的属性的机制，并且在实现者之间也没有关于如何实现这一点的共识。

用户代理还 MUST 通过此机制暴露完整的角色字符串，并且 MAY 也通过此机制暴露 WAI-ARIA 属性和值，即使这些属性和值已经直接映射到可访问性 API。

建议浏览器实现者公开记录其用于暴露任何相关信息的 API 方法，以便辅助技术开发者可以使用该 API 来支持用户特性。

平台可访问性 API 传统上具有一组有限的预定义角色，这些角色是该平台上的辅助技术所预期的，并且可能只暴露一个或两个角色。相比之下， WAI-ARIA 允许将多个角色指定为由空格分隔的有效角色令牌的有序集合。附加角色是后备角色，类似于在首选字体类型不受支持时指定多个字体的概念。

如果 API 支持相应机制，用户代理 MUST 暴露 WAI-ARIA 角色字符串。这允许辅助技术对角色执行自己的额外处理。

MSAA：不支持。用户代理 SHOULD NOT 在 MSAA 的 accRole 属性中暴露自定义角色。
IAccessible2：作为对象属性对（xml-roles:"string"）暴露
UIA：作为 AriaRole 属性暴露。 AriaRole property 还可以支持使用空格作为分隔符的次要角色。
ATK/AT-SPI：作为对象属性对暴露（xml-roles:"string"）

元素的 computedrole 是一个字符串，表示由浏览器引擎计算出的该元素的角色。 computedrole 主要用于开发者工具以及规范一致性和互操作性测试。

注

用户代理会提供此角色字符串，例如在开发者工具中提供，并响应 WebDriver 函数 getComputedRole，该函数用于 ARIA、HTML-AAM 和其他规范的互操作性测试。

示例 1

<button> <!-- computedrole 返回 "button" -->

<a href="#" role="button"> <!-- computedrole 返回 "button" -->

注

当元素具有角色但未包含在所需上下文中时（例如，没有所需的 list 角色可访问性父项的孤立 listitem），这是创作错误，但用户代理行为并未被指定为单一规则。对于大多数角色，用户代理可以通过忽略该角色来恢复错误，或在实现认为无害的场景中尊重作者预期的角色。请注意，引擎如何处理作者角色错误方面的这种宽容性可能会被特定语言的映射文档（例如 [HTML-AAM]）覆盖。

示例 2

<div role="listitem"> <!-- 作者错误：孤立的 listitem。computedrole 未指定。 -->

<div role="list"> <!-- computedrole 返回 "list" -->
  <div role="listitem"> <!-- 在适当上下文中，computedrole 返回 "listitem"。 -->

当宿主语言元素没有到某个有效的、非抽象角色的精确或等效映射时，相关的 Accessibility API Mapping 扩展规范 MAY 指定一个唯一的 computedrole 字符串作为互操作性测试用途的返回值，例如 [HTML-AAM] 中的 <video> -> "html-video"。然而，作者 MUST NOT 在 role 属性中使用任何带宿主语言前缀的 computedrole 字符串（例如 html-video），除非该令牌也匹配一个有效的、已定义的角色（例如 dpub-chapter）。用户代理 MUST 忽略任何抽象或无效的角色令牌。

示例 3

<video> <!-- computedrole 返回 "html-video" -->

<main role="html-video"> <!-- 作者错误。computedrole 返回 "main" -->

ARIA 规范	`alert`
计算角色	`alert`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_ALERT` 事件：用户代理 SHOULD 触发 `EVENT_SYSTEM_ALERT`。^{[注 2]}
UIA	控件类型：`Group` 本地化控件类型：`alert` LiveSetting：`Assertive (2)` 事件：用户代理 SHOULD 触发一个系统警报事件。^{[注 2]}
ATK/AT-SPI	角色：`ROLE_NOTIFICATION` 事件：用户代理 SHOULD 触发一个系统警报事件。^{[注 2]}
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationAlert` 事件：用户代理 SHOULD 触发一个系统警报事件。^{[注 2]}
Android	待定

ARIA 规范	`alertdialog`
计算角色	`alertdialog`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_DIALOG` 事件：用户代理 SHOULD 触发 `EVENT_SYSTEM_ALERT`。^{[注 2]}
UIA	控件类型：`Pane` 事件：用户代理 SHOULD 触发一个系统警报事件。^{[注 2]}
ATK/AT-SPI	角色：`ROLE_ALERT` 接口：`Window` 事件：用户代理 SHOULD 触发一个系统警报事件。^{[注 2]}
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationAlertDialog` 事件：用户代理 SHOULD 触发一个系统警报事件。^{[注 2]}
Android	待定

ARIA 规范	`application`
计算角色	`application`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_APPLICATION`
UIA	控件类型：`Pane` 本地化控件类型：`application`
ATK/AT-SPI	角色：`ROLE_EMBEDDED`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXWebApplication`
Android	待定

ARIA 规范	`article`
计算角色	`article`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_DOCUMENT` 状态：`STATE_SYSTEM_READONLY` 对象属性：`xml-roles:article`
UIA	控件类型：`Group` 本地化控件类型：`article`
ATK/AT-SPI	角色：`ROLE_ARTICLE` 对象属性：`xml-roles:article`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXDocumentArticle`
Android	待定

ARIA 规范	`banner`
计算角色	`banner`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:banner`
UIA	控件类型：`Group` 本地化控件类型：`banner` Landmark Type：`Custom` Localized Landmark Type：`banner`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:banner`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkBanner`
Android	待定

ARIA 规范	`blockquote`
计算角色	`blockquote`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_BLOCK_QUOTE`
UIA	控件类型：`Group` 本地化控件类型：`blockquote`
ATK/AT-SPI	角色：`ROLE_BLOCK_QUOTE`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`button` ，其 `aria-pressed` 和 `aria-haspopup` 为默认值
计算角色	`button`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_PUSHBUTTON`
UIA	控件类型：`Button`
ATK/AT-SPI	角色：`ROLE_PUSH_BUTTON`
AX API^{[注 1]}	AXRole：`AXButton` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`button` ，其 `aria-haspopup` 为非 `false` 值
计算角色	`button`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_BUTTONMENU`
UIA	控件类型：`Button`
ATK/AT-SPI	角色：`ROLE_PUSH_BUTTON`
AX API^{[注 1]}	AXRole：`AXPopUpButton` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`button` ，其 `aria-pressed` 具有已定义值
计算角色	`button`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_PUSHBUTTON` 角色：`IA2_ROLE_TOGGLE_BUTTON`
UIA	控件类型：`Button`
ATK/AT-SPI	角色：`ROLE_TOGGLE_BUTTON`
AX API^{[注 1]}	AXRole：`AXCheckBox` AXSubrole：`AXToggle`
Android	待定

ARIA 规范	`caption`
计算角色	`caption`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_CAPTION`
UIA	控件类型：`Text`
ATK/AT-SPI	角色：`ROLE_CAPTION`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`cell`
计算角色	`cell`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_CELL` 接口：`IAccessibleTableCell`
UIA	控件类型：`DataItem` 本地化控件类型：`item` 控件模式：`GridItem` 控件模式：`TableItem`
ATK/AT-SPI	角色：`ROLE_TABLE_CELL` 接口：`TableCell`
AX API^{[注 1]}	AXRole：`AXCell` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`checkbox`
计算角色	`checkbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_CHECKBUTTON` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`Checkbox` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_CHECK_BOX` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXCheckBox` AXSubrole：`<nil>` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`code`
计算角色	`code`
MSAA + IAccessible2	角色：`IA2_ROLE_TEXT_FRAME` 对象属性：`xml-roles:code`
UIA	控件类型：`Text` 本地化控件类型：`code`
ATK/AT-SPI	角色：`ROLE_STATIC` 对象属性：`xml-roles:code`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXCodeStyleGroup`
Android	待定

ARIA 规范	`columnheader`
计算角色	`columnheader`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_COLUMNHEADER` 接口：`IAccessibleTableCell`
UIA	控件类型：`DataItem` 本地化控件类型：`column header` 控件模式：`GridItem` 控件模式：`TableItem`
ATK/AT-SPI	角色：`ROLE_COLUMN_HEADER` 接口：`TableCell`
AX API^{[注 1]}	AXRole：`AXCell` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`combobox`
计算角色	`combobox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_COMBOBOX` 状态：`STATE_SYSTEM_HASPOPUP` 状态：如果 `aria-expanded` 不是 `"true"`，则为 `STATE_SYSTEM_COLLAPSED`
UIA	控件类型：`Combobox`
ATK/AT-SPI	角色：`ROLE_COMBO_BOX` 状态：`STATE_EXPANDABLE` 状态：`STATE_HAS_POPUP`
AX API^{[注 1]}	AXRole：`AXComboBox` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`comment`
计算角色	`comment`
MSAA + IAccessible2	角色：`IA2_ROLE_COMMENT` 对象属性：`xml-roles:comment`
UIA	控件类型：`Group` 本地化控件类型：`comment`
ATK/AT-SPI	角色：`ROLE_COMMENT` 对象属性：`xml-roles:comment`
AX API^{[注 1]}	AXRole：`AXGroup`
Android	待定

ARIA 规范	`complementary`
计算角色	`complementary`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:complementary`
UIA	控件类型：`Group` 本地化控件类型：`complementary` Landmark Type：`Custom` Localized Landmark Type：`complementary`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:complementary`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkComplementary`
Android	待定

ARIA 规范	`contentinfo`
计算角色	`contentinfo`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:contentinfo`
UIA	控件类型：`Group` 本地化控件类型： `content information` Landmark Type：`Custom` Localized Landmark Type： `content information`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:contentinfo`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkContentInfo`
Android	待定

ARIA 规范	`definition`
计算角色	`definition`
MSAA + IAccessible2	对象属性：`xml-roles:definition`
UIA	控件类型：`Group` 本地化控件类型：`definition`
ATK/AT-SPI	角色：`ROLE_DESCRIPTION_VALUE` 对象属性：`xml-roles:definition`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXDefinition`
Android	待定

ARIA 规范	`deletion`
计算角色	`deletion`
MSAA + IAccessible2	角色：`IA2_ROLE_CONTENT_DELETION`
UIA	控件类型：`Text` 本地化控件类型：`deletion`
ATK/AT-SPI	角色：`ROLE_CONTENT_DELETION` 对象属性：`xml-roles:deletion`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXDeleteStyleGroup` AXAttributedStringForTextMarkerRange：对 `deletion` 中包含的所有文本，包含 `AXIsSuggestedDeletion = 1;`
Android	待定

ARIA 规范	`dialog`
计算角色	`dialog`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_DIALOG`
UIA	控件类型：`Pane`
ATK/AT-SPI	角色：`ROLE_DIALOG` 接口：`Window`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationDialog`
Android	待定

ARIA 规范	`directory`
计算角色	list
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LIST`
UIA	控件类型：`List`
ATK/AT-SPI	角色：`ROLE_LIST`
AX API^{[注 1]}	AXRole：`AXList` AXSubrole：`AXContentList`
Android	待定

ARIA 规范	`document`
计算角色	`document`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_DOCUMENT` 状态：`STATE_SYSTEM_READONLY`
UIA	控件类型：`Document`
ATK/AT-SPI	角色：`ROLE_DOCUMENT_FRAME`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXDocument`
Android	待定

ARIA 规范	`emphasis`
计算角色	`emphasis`
MSAA + IAccessible2	角色：`IA2_ROLE_TEXT_FRAME` 对象属性：`xml-roles:emphasis`
UIA	控件类型：`Text` 本地化控件类型：`emphasis`
ATK/AT-SPI	角色：`ROLE_STATIC` 对象属性：`xml-roles:emphasis`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXEmphasisStyleGroup`
Android	待定

ARIA 规范	`feed`
计算角色	`feed`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 对象属性：`xml-roles:feed`
UIA	控件类型：`Group` 本地化控件类型：`feed`
ATK/AT-SPI	角色：`ROLE_PANEL` 对象属性：`xml-roles:feed`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationGroup`
Android	待定

ARIA 规范	`figure`
计算角色	`figure`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 对象属性：`xml-roles:figure`
UIA	控件类型：`Group` 本地化控件类型：`figure`
ATK/AT-SPI	角色：`ROLE_PANEL` 对象属性：`xml-roles:figure`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`form` 具有可访问名称
计算角色	`form`
MSAA + IAccessible2	角色：`IA2_ROLE_FORM` 对象属性：`xml-roles:form`
UIA	控件类型：`Group` 本地化控件类型：`form` Landmark Type：`Form`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:form`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkForm`
Android	待定

ARIA 规范	`form` 没有可访问名称
计算角色	`form`
MSAA + IAccessible2	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
UIA	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
ATK/AT-SPI	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
AX API^{[注 1]}	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
Android	待定

ARIA 规范	`generic`
计算角色	`generic`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_SECTION`
UIA	控件类型：`Group`
ATK/AT-SPI	角色：`ROLE_SECTION`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`grid`
计算角色	`grid`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TABLE` 对象属性：`xml-roles:grid` 接口：`IAccessibleTable2` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`DataGrid` 控件模式：`Grid` 控件模式：`Table` 控件模式：`Selection`
ATK/AT-SPI	角色：`ROLE_TABLE` 对象属性：`xml-roles:grid` 接口：`Table` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXTable` AXSubrole：`<nil>` AXColumnHeaderUIElements：指向 columnheader 元素的指针列表 AXHeader：指向包含这些 columnheader 元素的 row 或 group 的指针 AXRowHeaderUIElements：指向 rowheader 元素的指针列表
Android	待定

ARIA 规范	`gridcell`
计算角色	`gridcell`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_CELL` 接口：`IAccessibleTableCell`
UIA	控件类型：`DataItem` 本地化控件类型：`item` 控件模式：`SelectionItem` 控件模式：`GridItem` 控件模式：`TableItem` SelectionItem.SelectionContainer：包含它的 `grid`
ATK/AT-SPI	角色：`ROLE_TABLE_CELL` 接口：`TableCell`
AX API^{[注 1]}	AXRole：`AXCell` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`group`
计算角色	`group`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING`
UIA	控件类型：`Group`
ATK/AT-SPI	角色：`ROLE_PANEL`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationGroup`
Android	待定

ARIA 规范	`heading`
计算角色	`heading`
MSAA + IAccessible2	角色：`IA2_ROLE_HEADING` 对象属性：`xml-roles:heading`
UIA	控件类型：`Text` 本地化控件类型：`heading`
ATK/AT-SPI	角色：`ROLE_HEADING`
AX API^{[注 1]}	AXRole：`AXHeading` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`image`
计算角色	`image`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GRAPHIC` 接口：`IAccessibleImage`
UIA	控件类型：`Image`
ATK/AT-SPI	角色：`ROLE_IMAGE` 接口：`Image`
AX API^{[注 1]}	AXRole：`AXImage` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`img`
计算角色	`image`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GRAPHIC` 接口：`IAccessibleImage`
UIA	控件类型：`Image`
ATK/AT-SPI	角色：`ROLE_IMAGE` 接口：`Image`
AX API^{[注 1]}	AXRole：`AXImage` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`insertion`
计算角色	`insertion`
MSAA + IAccessible2	角色：`IA2_ROLE_CONTENT_INSERTION`
UIA	控件类型：`Text` 本地化控件类型：`insertion`
ATK/AT-SPI	角色：`ROLE_CONTENT_INSERTION` 对象属性：`xml-roles:insertion`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXInsertStyleGroup` AXAttributedStringForTextMarkerRange：对 `insertion` 中包含的所有文本，包含 `AXIsSuggestedInsertion = 1;`
Android	待定

ARIA 规范	`link`
计算角色	`link`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LINK` 状态：`STATE_SYSTEM_LINKED` 状态：其后代上的 `STATE_SYSTEM_LINKED` 接口：`IAccessibleHypertext`
UIA	控件类型：`HyperLink` 控件模式：`Value`
ATK/AT-SPI	角色：`ROLE_LINK` 接口：`HyperlinkImpl`
AX API^{[注 1]}	AXRole：`AXLink` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`list`
计算角色	`list`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LIST` 状态：`STATE_SYSTEM_READONLY`
UIA	控件类型：`List`
ATK/AT-SPI	角色：`ROLE_LIST`
AX API^{[注 1]}	AXRole：`AXList` AXSubrole：`AXContentList`
Android	待定

ARIA 规范	`listbox`
计算角色	`listbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LIST` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`List` 控件模式：`Selection`
ATK/AT-SPI	角色：`ROLE_LIST_BOX` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXList` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`listbox`
计算角色	`listbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LIST` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`List` 控件模式：`Selection`
ATK/AT-SPI	角色：`ROLE_MENU` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXList` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`listitem`
计算角色	`listitem`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LISTITEM` 状态：`STATE_SYSTEM_READONLY`
UIA	控件类型：`ListItem` 控件模式：`SelectionItem` SelectionItem.SelectionContainer：包含它的 `list`
ATK/AT-SPI	角色：`ROLE_LIST_ITEM`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`log`
计算角色	`log`
MSAA + IAccessible2	对象属性：`xml-roles:log` 对象属性： `container-live:polite` 对象属性：`live:polite` 对象属性：`container-live-role:log`
UIA	控件类型：`Group` 本地化控件类型：`log` LiveSetting：`Polite (1)`
ATK/AT-SPI	角色：`ROLE_LOG` 对象属性：`xml-roles:log` 对象属性： `container-live:polite` 对象属性：`live:polite` 对象属性：`container-live-role:log`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationLog`
Android	待定

ARIA 规范	`main`
计算角色	`main`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:main`
UIA	控件类型：`Group` 本地化控件类型：`main` Landmark Type：`Main`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:main`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkMain`
Android	待定

ARIA 规范	`mark`
计算角色	`mark`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_MARK` 对象属性：`xml-roles:mark`
UIA	控件类型：`Group`
ATK/AT-SPI	角色：`ROLE_MARK` 对象属性：`xml-roles:mark`
AX API^{[注 1]}	AXRole：`AXGroup` AXRoleDescription：`highlight` AXAttributedStringForTextMarkerRange：对 `mark` 中包含的所有文本，包含 `AXHighlight = 1;`
Android	待定

ARIA 规范	`marquee`
计算角色	`marquee`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_ANIMATION` 对象属性：`xml-roles:marquee`
UIA	控件类型：`Group` 本地化控件类型：`marquee`
ATK/AT-SPI	角色：`ROLE_MARQUEE`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationMarquee`
Android	待定

ARIA 规范	`math`
计算角色	`math`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_EQUATION`
UIA	控件类型：`Group` 本地化控件类型：`math`
ATK/AT-SPI	角色：`ROLE_MATH`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXDocumentMath`
Android	待定

ARIA 规范	`menu`
计算角色	`menu`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_MENUPOPUP` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`Menu`
ATK/AT-SPI	角色：`ROLE_MENU` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXMenu` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`menubar`
计算角色	`menubar`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_MENUBAR` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`MenuBar`
ATK/AT-SPI	角色：`ROLE_MENU_BAR` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXMenuBar` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`menuitem`
计算角色	`menuitem`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_MENUITEM`
UIA	控件类型：`MenuItem`
ATK/AT-SPI	角色：`ROLE_MENU_ITEM`
AX API^{[注 1]}	AXRole：`AXMenuItem` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`menuitemcheckbox`
计算角色	`menuitemcheckbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_CHECKBUTTON` 或 `ROLE_SYSTEM_MENUITEM` 角色：`IA2_ROLE_CHECK_MENU_ITEM` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`MenuItem` 控件模式：`Toggle` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_CHECK_MENU_ITEM` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXMenuItem` AXSubrole：`<nil>` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`menuitemradio`
计算角色	`menuitemradio`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_RADIOBUTTON` 或 `ROLE_SYSTEM_MENUITEM` 角色：`IA2_ROLE_RADIO_MENU_ITEM` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`MenuItem` 控件模式：`Toggle` 控件模式：`SelectionItem` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_RADIO_MENU_ITEM` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXMenuItem` AXSubrole：`<nil>` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`meter`
计算角色	`meter`
MSAA + IAccessible2	角色：`IA2_ROLE_LEVEL_BAR` 接口：`IAccessibleValue`
UIA	控件类型：`ProgressBar` 本地化控件类型：`meter` 控件模式：`RangeValue`
ATK/AT-SPI	角色：`ROLE_LEVEL_BAR` 接口：`Value`
AX API^{[注 1]}	AXRole：`AXLevelIndicator` AXSubrole：`AXMeter`
Android	待定

ARIA 规范	`navigation`
计算角色	`navigation`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:navigation`
UIA	控件类型：`Group` 本地化控件类型：`navigation` Landmark Type：`Navigation`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:navigation`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkNavigation`
Android	待定

ARIA 规范	`none`
计算角色	`none`
MSAA + IAccessible2	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，将其暴露为 `IA2_ROLE_TEXT_FRAME`。用户代理 SHOULD 从可访问性树中剪除空后代。
UIA	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，使用 `text` 模式暴露它。用户代理 SHOULD 从可访问性树中剪除空后代。
ATK/AT-SPI	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，将其暴露为 `ROLE_SECTION`。用户代理 SHOULD 从可访问性树中剪除空后代。
AX API^{[注 1]}	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，将其暴露为 `AXGroup`。用户代理 SHOULD 从可访问性树中剪除空后代。
Android	待定

ARIA 规范	`note`
计算角色	`note`
MSAA + IAccessible2	角色：`IA2_ROLE_NOTE`
UIA	控件类型：`Group` 本地化控件类型：`note`
ATK/AT-SPI	角色：`ROLE_COMMENT`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXDocumentNote`
Android	待定

ARIA 规范	`option` 不在 `combobox` 内部
计算角色	`option`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LISTITEM` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`ListItem` 控件模式：`Invoke` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_LIST_ITEM` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXStaticText` AXSubrole：`<nil>` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`option` 在 `combobox` 内部
计算角色	`option`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_LISTITEM` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`ListItem` 控件模式：`Invoke` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_MENU_ITEM` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXStaticText` AXSubrole：`<nil>` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`paragraph`
计算角色	`paragraph`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_PARAGRAPH`
UIA	控件类型：`Text`
ATK/AT-SPI	角色：`ROLE_PARAGRAPH`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`presentation`
计算角色	`none`
MSAA + IAccessible2	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，将其暴露为 `IA2_ROLE_TEXT_FRAME`。用户代理 SHOULD 从可访问性树中剪除空后代。
UIA	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，使用 `text` 模式暴露它。用户代理 SHOULD 从可访问性树中剪除空后代。
ATK/AT-SPI	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，将其暴露为 `ROLE_SECTION`。用户代理 SHOULD 从可访问性树中剪除空后代。
AX API^{[注 1]}	对于具有指定的允许可访问性子项的对象（例如，具有 gridcell 子项的 grid，具有 listitem 子项的 list），且该后代位于可访问性树中时，将其暴露为 `AXGroup`。用户代理 SHOULD 从可访问性树中剪除空后代。
Android	待定

ARIA 规范	`progressbar`
计算角色	`progressbar`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_PROGRESSBAR` 状态：`STATE_SYSTEM_READONLY` 接口：`IAccessibleValue`
UIA	控件类型：`ProgressBar` 控件模式：如果存在 `aria-valuenow`、`aria-valuemax` 或 `aria-valuemin`，则为 `RangeValue`
ATK/AT-SPI	角色：`ROLE_PROGRESS_BAR` 接口：`Value` 由于 WAI-ARIA 不支持通过可访问性 API 修改值，用户代理 MUST 对所有提供修改值方式的 `Value` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXProgressIndicator` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`radio`
计算角色	`radio`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_RADIOBUTTON` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`RadioButton` 控件模式：`Toggle` 控件模式：`SelectionItem` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_RADIO_BUTTON` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXRadioButton` AXSubrole：`<nil>` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`radiogroup`
计算角色	`radiogroup`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING`
UIA	控件类型：`List`
ATK/AT-SPI	角色：`ROLE_PANEL`
AX API^{[注 1]}	AXRole：`AXRadioGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`region` 具有可访问名称
计算角色	`region`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:region`
UIA	控件类型：`Group` 本地化控件类型：`region` Landmark Type：`Custom` Localized Landmark Type：`region`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:region`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkRegion`
Android	待定

ARIA 规范	`region` 没有可访问名称
计算角色	使用原生宿主语言角色。
MSAA + IAccessible2	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
UIA	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
ATK/AT-SPI	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
AX API^{[注 1]}	不要将该元素暴露为地标。请改用该元素的原生宿主语言角色。
Android	待定

ARIA 规范	`row` 不在 `treegrid` 内部
计算角色	`row`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_ROW`
UIA	控件类型：`DataItem` 本地化控件类型：`row` 控件模式：`SelectionItem`
ATK/AT-SPI	角色：`ROLE_TABLE_ROW`
AX API^{[注 1]}	AXRole：`AXRow` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`row` 在 `treegrid` 内部
计算角色	`row`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_OUTLINEITEM`
UIA	控件类型：`DataItem` 本地化控件类型：`row` 控件模式：`SelectionItem`
ATK/AT-SPI	角色：`ROLE_TABLE_ROW`
AX API^{[注 1]}	AXRole：`AXRow` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`rowgroup`
计算角色	`rowgroup`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING`
UIA	控件类型：`Group`
ATK/AT-SPI	角色：`ROLE_PANEL`
AX API^{[注 1]}	未映射
Android	待定

ARIA 规范	`rowheader`
计算角色	`rowheader`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_ROWHEADER` 接口：`IAccessibleTableCell`
UIA	控件类型：`HeaderItem`
ATK/AT-SPI	角色：`ROLE_ROW_HEADER` 接口：`TableCell`
AX API^{[注 1]}	AXRole：`AXCell` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`scrollbar`
计算角色	`scrollbar`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_SCROLLBAR` 接口：`IAccessibleValue`
UIA	控件类型：`ScrollBar` 控件模式：`RangeValue`
ATK/AT-SPI	角色：`ROLE_SCROLL_BAR` 接口：`Value` 由于 WAI-ARIA 不支持通过可访问性 API 修改值，用户代理 MUST 对所有提供修改值方式的 `Value` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXScrollBar` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`search`
计算角色	`search`
MSAA + IAccessible2	角色：`IA2_ROLE_LANDMARK` 对象属性：`xml-roles:search`
UIA	控件类型：`Group` 本地化控件类型：`search` Landmark Type：`Search`
ATK/AT-SPI	角色：`ROLE_LANDMARK` 对象属性：`xml-roles:search`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXLandmarkSearch`
Android	待定

ARIA 规范	`searchbox`
计算角色	`searchbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TEXT` 对象属性：`text-input-type:search`
UIA	控件类型：`Edit` 本地化控件类型：`search box`
ATK/AT-SPI	角色：`ROLE_ENTRY` 对象属性：`xml-roles:searchbox` 对象属性：`text-input-type:search` 接口：如果 `aria-readonly` 不是 `"true"`，则为 `EditableText`
AX API^{[注 1]}	AXRole：`AXTextField` AXSubrole：`AXSearchField`
Android	待定

ARIA 规范	`sectionfooter`
计算角色	`sectionfooter`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 对象属性：`xml-roles:sectionfooter`
UIA	控件类型：`Group` 本地化控件类型：`section footer`
ATK/AT-SPI	角色：`ROLE_FOOTER`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXSectionFooter` AXRoleDescription：`section footer`
Android	待定

ARIA 规范	`sectionheader`
计算角色	`sectionheader`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 对象属性：`xml-roles:sectionheader`
UIA	控件类型：`Group` 本地化控件类型：`section header`
ATK/AT-SPI	角色：`ROLE_HEADER`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXSectionHeader` AXRoleDescription：`section header`
Android	待定

ARIA 规范	`separator` （不可聚焦）
计算角色	`seperator`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_SEPARATOR`
UIA	控件类型：`Separator`
ATK/AT-SPI	角色：`ROLE_SEPARATOR`
AX API^{[注 1]}	AXRole：`AXSplitter` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`separator` （可聚焦）
计算角色	`seperator`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_SEPARATOR` 接口：`IAccessibleValue`
UIA	控件类型：`Thumb` 控件模式：`RangeValue`
ATK/AT-SPI	角色：`ROLE_SEPARATOR` 接口：`Value` 由于 WAI-ARIA 不支持通过可访问性 API 修改值，用户代理 MUST 对所有提供修改值方式的 `Value` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXSplitter` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`slider`
计算角色	`slider`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_SLIDER` 接口：`IAccessibleValue`
UIA	控件类型：`Slider` 控件模式：`RangeValue`
ATK/AT-SPI	角色：`ROLE_SLIDER` 接口：`Value` 由于 WAI-ARIA 不支持通过可访问性 API 修改值，用户代理 MUST 对所有提供修改值方式的 `Value` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXSlider` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`spinbutton`
计算角色	`spinbutton`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_SPINBUTTON` 接口：`IAccessibleValue`
UIA	控件类型：`Spinner` 控件模式：`RangeValue`
ATK/AT-SPI	角色：`ROLE_SPIN_BUTTON` 接口：`Value` 由于 WAI-ARIA 不支持通过可访问性 API 修改值，用户代理 MUST 对所有提供修改值方式的 `Value` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXIncrementor` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`status`
计算角色	`status`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_STATUSBAR` 对象属性： `container-live:polite` 对象属性：`live:polite` 对象属性： `container-live-role:status`
UIA	控件类型：`Group` 本地化控件类型：`status` LiveSetting：`Polite (1)`
ATK/AT-SPI	角色：`ROLE_STATUSBAR` 对象属性： `container-live:polite` 对象属性：`live:polite` 对象属性： `container-live-role:status`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationStatus`
Android	待定

ARIA 规范	`strong`
计算角色	`strong`
MSAA + IAccessible2	角色：`IA2_ROLE_TEXT_FRAME` 对象属性：`xml-roles:strong`
UIA	控件类型：`Text` 本地化控件类型：`strong`
ATK/AT-SPI	角色：`ROLE_STATIC` 对象属性：`xml-roles:strong`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXStrongStyleGroup`
Android	待定

ARIA 规范	`subscript`
计算角色	`subscript`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_TEXT_FRAME` 文本属性：`text-position:sub`
UIA	控件类型：`Text` 所使用的样式由可访问对象上实现的 `TextRange` 控件模式的 `IsSubscript` 属性暴露。
ATK/AT-SPI	角色：`ROLE_SUBSCRIPT`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXSubscriptStyleGroup`
Android	待定

ARIA 规范	`suggestion`
计算角色	`suggestion`
MSAA + IAccessible2	角色：`IA2_ROLE_SUGGESTION` 对象属性：`xml-roles:suggestion`
UIA	控件类型：`Group` 本地化控件类型：`suggestion`
ATK/AT-SPI	角色：`ROLE_SUGGESTION` 对象属性：`xml-roles:suggestion`
AX API^{[注 1]}	AXRole：`AXGroup` AXAttributedStringForTextMarkerRange：对 `suggestion` 中包含的所有文本，包含 `AXIsSuggestion = 1;`
Android	待定

ARIA 规范	`superscript`
计算角色	`superscript`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 角色：`IA2_ROLE_TEXT_FRAME` 文本属性：`text-position:super`
UIA	控件类型：`Text` 所使用的样式由可访问对象上实现的 `TextRange` 控件模式的 `IsSuperscript` 属性暴露。
ATK/AT-SPI	角色：`ROLE_SUPERSCRIPT`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXSuperscriptStyleGroup`
Android	待定

ARIA 规范	`switch`
计算角色	`switch`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_CHECKBUTTON` 角色：`IA2_ROLE_TOGGLE_BUTTON` 对象属性：`xml-roles:switch` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`Button` 本地化控件类型：`toggleswitch` 控件模式：`Toggle` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_TOGGLE_BUTTON` 对象属性：`xml-roles:switch` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXCheckBox` AXSubrole：`AXSwitch` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

ARIA 规范	`tab`
计算角色	`tab`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_PAGETAB` 状态：如果焦点位于与 `aria-labelledby` 关联的 `tabpanel` 内部，则为 `STATE_SYSTEM_SELECTED`
UIA	控件类型：`TabItem`
ATK/AT-SPI	角色：`ROLE_PAGE_TAB` 状态：如果焦点位于与 `aria-labelledby` 关联的 `tabpanel` 内部，则为 `STATE_SELECTED`
AX API^{[注 1]}	AXRole：`AXRadioButton` AXSubrole：`AXTabButton`
Android	待定

ARIA 规范	`table`
计算角色	`table`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TABLE` 对象属性：`xml-roles:table` 接口：`IAccessibleTable2`
UIA	控件类型：`Table` 控件模式：`Grid` 控件模式：`Table`
ATK/AT-SPI	角色：`ROLE_TABLE` 对象属性：`xml-roles:table` 接口：`Table`
AX API^{[注 1]}	AXRole：`AXTable` AXSubrole：`<nil>` AXColumnHeaderUIElements：指向 columnheader 元素的指针列表 AXHeader：指向包含这些 columnheader 元素的 row 或 group 的指针 AXRowHeaderUIElements：指向 rowheader 元素的指针列表
Android	待定

ARIA 规范	`tablist`
计算角色	`tablist`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_PAGETABLIST` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`Tab` 控件模式：`Selection`
ATK/AT-SPI	角色：`ROLE_PAGE_TAB_LIST` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXTabGroup` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`tabpanel`
计算角色	`tabpanel`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_PANE` 或 `ROLE_SYSTEM_PROPERTYPAGE`
UIA	控件类型：`Pane`
ATK/AT-SPI	角色：`ROLE_SCROLL_PANE`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXTabPanel`
Android	待定

ARIA 规范	`term`
计算角色	`term`
MSAA + IAccessible2	角色：`IA2_ROLE_TEXT_FRAME` 对象属性：`xml-roles:term`
UIA	控件类型：`Text` 本地化控件类型：`term`
ATK/AT-SPI	角色：`ROLE_DESCRIPTION_TERM`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXTerm`
Android	待定

ARIA 规范	`textbox` 当 `aria-multiline` 为 `false` 时
计算角色	`textbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TEXT` 状态：`IA2_STATE_SINGLE_LINE`
UIA	控件类型：`Edit`
ATK/AT-SPI	角色：`ROLE_ENTRY` 状态：`STATE_SINGLE_LINE` 接口：如果 `aria-readonly` 不是 `"true"`，则为 `EditableText`
AX API^{[注 1]}	AXRole：`AXTextField` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`textbox` 当 `aria-multiline` 为 `true` 时
计算角色	`textbox`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TEXT` 状态：`IA2_STATE_MULTI_LINE`
UIA	控件类型：`Edit`
ATK/AT-SPI	角色：`ROLE_ENTRY` 状态：`STATE_MULTI_LINE` 接口：如果 `aria-readonly` 不是 `"true"`，则为 `EditableText`
AX API^{[注 1]}	AXRole：`AXTextArea` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`time`
计算角色	`time`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_GROUPING` 对象属性：`xml-roles:time`
UIA	控件类型：`Text` 本地化控件类型：`time` 注：创建一个单独的 UIA Text 类型控件。这不同于大多数 UIA 文本映射，后者只在页面文本模式中创建范围。
ATK/AT-SPI	角色：`ROLE_STATIC` 对象属性：`xml-roles:time`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXTimeGroup`
Android	待定

ARIA 规范	`timer`
计算角色	`timer`
MSAA + IAccessible2	对象属性：`xml-roles:timer`
UIA	控件类型：`Group` 本地化控件类型：`timer`
ATK/AT-SPI	角色：`ROLE_TIMER`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXApplicationTimer`
Android	待定

ARIA 规范	`toolbar`
计算角色	`toolbar`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TOOLBAR`
UIA	控件类型：`ToolBar`
ATK/AT-SPI	角色：`ROLE_TOOL_BAR`
AX API^{[注 1]}	AXRole：`AXToolbar` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`tooltip`
计算角色	`tooltip`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_TOOLTIP`
UIA	控件类型：`ToolTip`
ATK/AT-SPI	角色：`ROLE_TOOL_TIP`
AX API^{[注 1]}	AXRole：`AXGroup` AXSubrole：`AXUserInterfaceTooltip`
Android	待定

ARIA 规范	`tree`
计算角色	`tree`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_OUTLINE` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`Tree`
ATK/AT-SPI	角色：`ROLE_TREE` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXOutline` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`treegrid`
计算角色	`treegrid`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_OUTLINE` 接口：`IAccessibleTable2` 方法：`IAccessible::accSelect()` 方法：`IAccessible::get_accSelection()`
UIA	控件类型：`DataGrid`
ATK/AT-SPI	角色：`ROLE_TREE_TABLE` 接口：`Table` 接口：`Selection` 由于 WAI-ARIA 不支持通过可访问性 API 修改选择，用户代理 MUST 对所有提供修改选择方式的 `Selection` 方法返回 `false`。
AX API^{[注 1]}	AXRole：`AXTable` AXSubrole：`<nil>`
Android	待定

ARIA 规范	`treeitem`
计算角色	`treeitem`
MSAA + IAccessible2	角色：`ROLE_SYSTEM_OUTLINEITEM` 另见：状态和属性映射表中的 `aria-checked`
UIA	控件类型：`TreeItem` 另见：状态和属性映射表中的 `aria-checked`
ATK/AT-SPI	角色：`ROLE_TREE_ITEM` 另见：状态和属性映射表中的 `aria-checked`
AX API^{[注 1]}	AXRole：`AXRow` AXSubrole：`AXOutlineRow` 另见：状态和属性映射表中的 `aria-checked`
Android	待定

注

^{[注 1]} 用户代理应为 AXRoleDescription 返回用户可呈现的本地化字符串值。

注

^{[注 2]} 本规范当前不包含关于用户代理何时应触发系统警报事件的指南。以后可能会向规范中添加一些指南，但它将是建议（SHOULD），而不是要求（MUST）。

本节描述如何暴露 WAI-ARIA 状态和属性。

用户代理 MUST 计算托管状态 VISIBLE/INVISIBLE、SHOWING/OFFSCREEN 等。这通常以与没有 WAI-ARIA 属性存在的普通元素相同的方式完成。 FOCUSABLE/FOCUSED 状态可能会受 aria-activedescendant 影响。
用户代理 MUST 继续暴露原生语义，此外还要暴露 WAI-ARIA 状态和属性语义，除非宿主语言允许显式的 WAI-ARIA 覆盖。例如，一个 HTML 复选框可以具有 aria-labelledby 属性，但仍必须暴露原生 HTML 语义。
用户代理 MUST 按角色映射表中的定义，为某些角色暴露附加状态。
用户代理 MUST 为相关的 WAI-ARIA 属性计算状态，并按可访问性 API 在状态和属性映射表中所指定的方式进行映射。要确定相关的 WAI-ARIA 属性，请参见角色定义 [WAI-ARIA-1.2]]。当作者没有为必需属性提供值时，用户代理 SHOULD 按照已提供默认值的情况进行处理。
某些 WAI-ARIA 属性不是全局的，并且只在某些角色上受支持。如果在不受支持的位置使用了非全局 WAI-ARIA 状态或属性，用户代理 SHOULD NOT 将给定的 WAI-ARIA 属性映射到平台可访问性 API。例如，如果 aria-checked="true" 被指定在 <div role="grid"> 上，则它不应在 MSAA 实现中暴露为 STATE_SYSTEM_CHECKED。
当显式或继承的 none 或 presentation 角色应用于一个元素时，用户代理 MUST 实现 Accessible Rich Internet Applications（WAI-ARIA）1.2 [WAI-ARIA-1.2]] 中定义的 none 或 presentation 角色规则。

表中有许多地方将给定状态或属性声明为“未映射”。在某些情况下，这发生在状态/属性的默认值上，并且等同于其不存在。用户代理可能会发现直接映射该值比检查它是否为默认值更快。为了计算效率，如果暴露状态或属性值等同于不映射它，则用户代理 MAY 暴露该状态或属性值。这些情况用星号标记。

在其他情况下，强制要求不得映射该状态/属性，因为暴露它意味着存在相关的可供性。一个示例是 aria-grabbed。它的缺失不仅表示该可访问对象未被抓取，还进一步将其定义为不可抓取。这些情况标记为不带星号的“未映射”。

ARIA 规范	`aria-activedescendant`
MSAA + IAccessible2	见焦点更改。
UIA	见焦点更改。
ATK/AT-SPI	见焦点更改。
AX API	见焦点更改。属性：`AXSelectedRows`：指向活动后代节点的指针
Android	待定

ARIA 规范	`aria-atomic`=`true`
MSAA + IAccessible2	对象属性：`atomic:true` 对象属性： `container-atomic:true` 对象属性：所有后代上的 `container-atomic:true` 关系：`IA2_RELATION_MEMBER_OF` 指向此元素（原子根）另见：文档内容或节点可见性的更改
UIA	属性：`AriaProperties.atomic`： `true` 另见：文档内容或节点可见性的更改
ATK/AT-SPI	对象属性：`atomic:true` 对象属性： `container-atomic:true` 对象属性：所有后代上的 `container-atomic:true` 关系：`RELATION_MEMBER_OF` 指向此元素（原子根）另见：文档内容或节点可见性的更改
AX API	属性：`AXARIAAtomic`： `YES` 另见：文档内容或节点可见性的更改
Android	待定

ARIA 规范	`aria-atomic`=`false`
MSAA + IAccessible2	未映射*，但如果映射：对象属性：`atomic:false` 对象属性： `container-atomic:false` 对象属性：所有后代上的 `container-atomic:false` 关系：`IA2_RELATION_MEMBER_OF` 指向此元素（原子根）另见：文档内容或节点可见性的更改
UIA	属性：`AriaProperties.atomic`： `false` 另见：文档内容或节点可见性的更改
ATK/AT-SPI	未映射*，但如果映射：对象属性：`atomic:false` 对象属性： `container-atomic:false` 对象属性：所有后代上的 `container-atomic:false` 关系：`RELATION_MEMBER_OF` 指向此元素（原子根）另见：文档内容或节点可见性的更改
AX API	属性：`AXARIAAtomic`： `NO` 另见：文档内容或节点可见性的更改
Android	待定

ARIA 规范	`aria-autocomplete`=`inline`、 `list` 或 `both`
MSAA + IAccessible2	对象属性： `autocomplete:<value>` 状态：`IA2_STATE_SUPPORTS_AUTOCOMPLETION`
UIA	未映射
ATK/AT-SPI	对象属性： `autocomplete:<value>` 状态：`STATE_SUPPORTS_AUTOCOMPLETION`
AX API	未映射
Android	待定

ARIA 规范	`aria-autocomplete`=`none`
MSAA + IAccessible2	未映射*
UIA	未映射*
ATK/AT-SPI	未映射*
AX API	未映射*
Android	待定

ARIA 规范	`aria-braillelabel`
MSAA + IAccessible2	对象属性： `braillelabel:<value>`
UIA	属性：`AriaProperties.braillelabel`： `<value>`
ATK/AT-SPI	对象属性： `braillelabel:<value>`
AX API	属性：AXBrailleLabel
Android	待定

ARIA 规范	`aria-brailleroledescription`
MSAA + IAccessible2	对象属性： `brailleroledescription:<value>`
UIA	属性：`AriaProperties.brailleroledescription`： `<value>`
ATK/AT-SPI	对象属性： `brailleroledescription:<value>`
AX API	属性：AXBrailleRoleDescription
Android	待定

ARIA 规范	`aria-brailleroledescription` 未定义或为空字符串
MSAA + IAccessible2	未映射
UIA	未映射
ATK/AT-SPI	未映射
AX API	未映射
Android	待定

ARIA 规范	`aria-busy`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_BUSY`
UIA	属性：`AriaProperties.busy`： `true`
ATK/AT-SPI	状态：`STATE_BUSY`
AX API	属性：`AXElementBusy`：`YES`
Android	待定

ARIA 规范	`aria-busy`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_BUSY`
UIA	属性：`AriaProperties.busy`： `false`
ATK/AT-SPI	状态：不暴露 `STATE_BUSY`
AX API	属性：`AXElementBusy`：`NO`
Android	待定

ARIA 规范	`aria-checked`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_CHECKED` 对象属性：`checkable:true`
UIA	属性：`Toggle.ToggleState`： `On (1)` 属性：`SelectionItem.IsSelected`：对于 `radio` 和 `menuitemradio` 为 `True`
ATK/AT-SPI	状态：`STATE_CHECKABLE` 状态：`STATE_CHECKED`
AX API	属性：`AXValue`：`1` 属性：`AXMenuItemMarkChar`：对于 `menuitemcheckbox` 和 `menuitemradio` 为 `✓`
Android	待定

ARIA 规范	`aria-checked`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_CHECKED` 对象属性：`checkable:true`
UIA	属性：`Toggle.ToggleState`： `Off (0)` 属性：`SelectionItem.IsSelected`：对于 `radio` 和 `menuitemradio` 为 `False`
ATK/AT-SPI	状态：`STATE_CHECKABLE` 状态：不暴露 `STATE_CHECKED`
AX API	属性：`AXValue`：`0` 属性：`AXMenuItemMarkChar`：对于 `menuitemcheckbox` 和 `menuitemradio` 为 `<nil>`
Android	待定

ARIA 规范	`aria-checked`=`mixed`
MSAA + IAccessible2	状态：`STATE_SYSTEM_MIXED` 对象属性：`checkable:true`
UIA	属性：`Toggle.ToggleState`： `Indeterminate (2)`
ATK/AT-SPI	状态：`STATE_INDETERMINATE` 状态：`STATE_CHECKABLE` 状态：不暴露 `STATE_CHECKED`
AX API	属性：`AXValue`：`2` 属性：`AXMenuItemMarkChar`：对于 `menuitemcheckbox` 和 `menuitemradio` 为 `<nil>`
Android	待定

ARIA 规范	`aria-checked` 未定义
MSAA + IAccessible2	未映射
UIA	未映射
ATK/AT-SPI	未映射
AX API	未映射
Android	待定

ARIA 规范	`aria-colcount`
MSAA + IAccessible2	对象属性： `colcount:<value>` 方法：`IAccessible2::groupPosition()`：单元格和表头上的 `similarItemsInGroup=<value>`
UIA	属性：`Grid.ColumnCount`： `<value>`
ATK/AT-SPI	对象属性：`colcount` 应包含作者提供的值。方法：`atk_table_get_n_columns()` 应返回实际列数。
AX API	属性：`AXARIAColumnCount`： `<value>`
Android	待定

ARIA 规范	`aria-colindex`
MSAA + IAccessible2	对象属性： `colindex:<value>` 方法：`IAccessible2::groupPosition()`：单元格和表头上的 `positionInGroup=<value>`
UIA	属性：`GridItem.Column`： `<value>`（从零开始）
ATK/AT-SPI	对象属性：`colindex` 应包含作者提供的值。方法：`atk_table_cell_get_position()` 应返回实际的（从零开始的）列索引。
AX API	属性：`AXARIAColumnIndex`： `<value>`
Android	待定

ARIA 规范	`aria-colindextext`
MSAA + IAccessible2	对象属性： `colindextext:<value>`
UIA	属性：`AriaProperties.colindextext`： `<value>`
ATK/AT-SPI	对象属性： `colindextext:<value>`
AX API	属性：`AXColumnIndexDescription`： `<value>`
Android	待定

ARIA 规范	`aria-colspan`
MSAA + IAccessible2	对象属性： `colspan:<value>` 方法：`IAccessibleTableCell::columnExtent()`： `<value>`
UIA	属性：`GridItem.ColumnSpan`： `<value>`
ATK/AT-SPI	对象属性：`colspan` 应包含作者提供的值。方法：`atk_table_cell_get_row_column_span()` 应返回实际列跨度。
AX API	属性：`AXColumnIndexRange.length`： `<value>`
Android	待定

ARIA 规范	`aria-controls`
MSAA + IAccessible2	关系：`IA2_RELATION_CONTROLLER_FOR` 指向与 IDREF 匹配的可访问节点反向关系：`IA2_RELATION_CONTROLLED_BY` 指向元素另见：映射附加关系
UIA	属性：`ControllerFor`：指向与 IDREF 匹配的可访问节点的指针
ATK/AT-SPI	关系：`RELATION_CONTROLLER_FOR` 指向与 IDREF 匹配的可访问节点反向关系：`RELATION_CONTROLLED_BY` 指向元素另见：映射附加关系
AX API	属性：`AXLinkedUIElements`：指向与 IDREF 匹配的可访问节点的指针
Android	待定

ARIA 规范	`aria-current` 为非 `false` 允许值
MSAA + IAccessible2	对象属性：`current:<value>`
UIA	属性：`AriaProperties.current`： `<value>`
ATK/AT-SPI	对象属性： `current:<value>` 状态：`STATE_ACTIVE`
AX API	属性：`AXARIACurrent`： `<value>`
Android	待定

ARIA 规范	`aria-current` 为无法识别的值
MSAA + IAccessible2	对象属性：`current:true`
UIA	属性：`AriaProperties.current`： `true`
ATK/AT-SPI	对象属性：`current:true` 状态：`STATE_ACTIVE`
AX API	属性：`AXARIACurrent`： `true`
Android	待定

ARIA 规范	`aria-current` 为 `false` 或未定义
MSAA + IAccessible2	未映射*
UIA	未映射*
ATK/AT-SPI	未映射*
AX API	未映射*
Android	待定

ARIA 规范	`aria-describedby`
MSAA + IAccessible2	属性：`accDescription`： `<value>` 关系：`IA2_RELATION_DESCRIBED_BY` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`IA2_RELATION_DESCRIPTION_FOR` 指向元素另见：名称计算和映射附加关系
UIA	属性：`FullDescription`： `<value>` 另见：名称计算
ATK/AT-SPI	属性：`Description`： `<value>` 关系：`RELATION_DESCRIBED_BY` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`RELATION_DESCRIPTION_FOR` 指向元素另见：名称计算和映射附加关系
AX API	在 accessibilityCustomContent API 中，暴露为一个 `AXCustomContent` 对象，其中 `{ label: "description" }` 且 ``value`` 设置为描述字符串。 - 另见：名称计算
Android	待定

ARIA 规范	`aria-description`
MSAA + IAccessible2	属性：`accDescription`： `<value>` 另见：名称计算
UIA	属性：`FullDescription`： `<value>` 另见：名称计算
ATK/AT-SPI	属性：`Description`： `<value>` 另见：名称计算
AX API	在 accessibilityCustomContent API 中，暴露为一个 `AXCustomContent` 对象，其中 `{ label: "description" }` 且 ``value`` 设置为描述字符串。另见：名称计算
Android	待定

ARIA 规范	`aria-details`
MSAA + IAccessible2	关系：`IA2_RELATION_DETAILS` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`IA2_RELATION_DETAILS_FOR` 指向元素另见：映射附加关系
UIA	属性：`DescribedBy`：指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中
ATK/AT-SPI	关系：`RELATION_DETAILS` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`RELATION_DETAILS_FOR` 指向元素另见：映射附加关系
AX API	未映射*
Android	待定

ARIA 规范	`aria-disabled`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_UNAVAILABLE` 状态：所有具有 `STATE_SYSTEM_FOCUSABLE` 的后代上的 `STATE_SYSTEM_UNAVAILABLE`
UIA	属性：`IsEnabled`：`false`
ATK/AT-SPI	状态：不暴露 `STATE_ENABLED`
AX API	属性：`AXEnabled`：`NO`
Android	待定

ARIA 规范	`aria-disabled`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_UNAVAILABLE`
UIA	属性：`IsEnabled`：`true`
ATK/AT-SPI	状态：`STATE_ENABLED`
AX API	属性：`AXEnabled`：`YES`
Android	待定

ARIA 规范	`aria-dropeffect`=`copy`、 `move`、`link`、`execute` 或 `popup`
MSAA + IAccessible2	对象属性： `dropeffect:<value>`
UIA	属性：`AriaProperties.dropeffect`： `<value>`
ATK/AT-SPI	对象属性： `dropeffect:<value>`
AX API	`array AXDropEffects`
Android	待定

ARIA 规范	`aria-dropeffect`=`none`
MSAA + IAccessible2	对象属性：如果没有其他有效令牌，则为 `dropeffect:none` 未映射*，如果作者未指定
UIA	未映射*
ATK/AT-SPI	对象属性：如果没有其他有效令牌，则为 `dropeffect:none` 未映射*，如果作者未指定
AX API	未映射*
Android	待定

ARIA 规范	`aria-errormessage`
MSAA + IAccessible2	关系：`IA2_RELATION_ERROR` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`IA2_RELATION_ERROR_FOR` 指向元素另见：映射附加关系
UIA	属性：`ControllerFor`：指向目标可访问对象的指针
ATK/AT-SPI	关系：`RELATION_ERROR_MESSAGE` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`RELATION_ERROR_FOR` 指向元素另见：映射附加关系
AX API	属性：`AXErrorMessageElements`：指向与 IDREF 匹配的可访问节点的指针
Android	待定

ARIA 规范	`aria-expanded`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_EXPANDED`
UIA	属性：`ExpandCollapse.ExpandCollapseState`： `Expanded`
ATK/AT-SPI	状态：`STATE_EXPANDABLE` 状态：`STATE_EXPANDED`
AX API	属性：`AXExpanded`：`YES`
Android	待定

ARIA 规范	`aria-expanded`=`false`
MSAA + IAccessible2	状态：`STATE_SYSTEM_COLLAPSED`
UIA	属性：`ExpandCollapse.ExpandCollapseState`： `Collapsed`
ATK/AT-SPI	状态：`STATE_EXPANDABLE` 状态：不暴露 `STATE_EXPANDED`
AX API	属性：`AXExpanded`：`NO`
Android	待定

ARIA 规范	`aria-expanded` 未定义
MSAA + IAccessible2	未映射
UIA	未映射
ATK/AT-SPI	未映射
AX API	未映射
Android	待定

ARIA 规范	`aria-flowto`
MSAA + IAccessible2	关系：`IA2_RELATION_FLOW_TO` 指向与 IDREF 匹配的可访问节点反向关系：`IA2_RELATION_FLOW_FROM` 指向元素另见：映射附加关系
UIA	属性：`FlowsTo`：指向与 IDREF 匹配的可访问节点的指针
ATK/AT-SPI	关系：`RELATION_FLOWS_TO` 指向与 IDREF 匹配的可访问节点反向关系：`RELATION_FLOWS_FROM` 指向元素另见：映射附加关系
AX API	属性：`AXLinkedUIElements`：指向与 IDREF 匹配的可访问节点的指针
Android	待定

ARIA 规范	`aria-grabbed`=`true`
MSAA + IAccessible2	对象属性：`grabbed:true`
UIA	属性：`AriaProperties.grabbed`： `true`
ATK/AT-SPI	对象属性：`grabbed:true`
AX API	属性：`AXGrabbed`：`YES`
Android	待定

ARIA 规范	`aria-grabbed`=`false`
MSAA + IAccessible2	对象属性：`grabbed:false`
UIA	属性：`AriaProperties.grabbed`： `false`
ATK/AT-SPI	对象属性：`grabbed:false`
AX API	属性：`AXGrabbed`：`NO`
Android	待定

ARIA 规范	`aria-grabbed` 未定义
MSAA + IAccessible2	未映射
UIA	未映射
ATK/AT-SPI	未映射
AX API	未映射
Android	待定

ARIA 规范	`aria-haspopup`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:menu`
UIA	控件模式：`ExpandCollapse` 另见：`aria-expanded`
ATK/AT-SPI	状态：`STATE_HAS_POPUP` 对象属性：`haspopup:menu`
AX API	属性：`AXPopupValue:menu` 动作：`AXShowMenu`
Android	待定

ARIA 规范	`aria-haspopup`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:false`
UIA	未映射*
ATK/AT-SPI	未映射*
AX API	未映射*
Android	待定

ARIA 规范	`aria-haspopup`=`dialog`
MSAA + IAccessible2	状态：`STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:dialog`
UIA	控件模式：`ExpandCollapse` 另见：`aria-expanded`
ATK/AT-SPI	状态：`STATE_HAS_POPUP` 对象属性：`haspopup:dialog`
AX API	属性：`AXPopupValue:dialog` 动作：`AXShowMenu`
Android	待定

ARIA 规范	`aria-haspopup`=`grid`
MSAA + IAccessible2	状态：`STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:grid`
UIA	控件模式：`ExpandCollapse` 另见：`aria-expanded`
ATK/AT-SPI	状态：`STATE_HAS_POPUP` 对象属性：`haspopup:grid`
AX API	属性：`AXPopupValue:grid` 动作：`AXShowMenu`
Android	待定

ARIA 规范	`aria-haspopup`=`listbox`
MSAA + IAccessible2	状态：`STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:listbox`
UIA	控件模式：`ExpandCollapse` 另见：`aria-expanded`
ATK/AT-SPI	状态：`STATE_HAS_POPUP` 对象属性：`haspopup:listbox`
AX API	属性：`AXPopupValue:listbox` 动作：`AXShowMenu`
Android	待定

ARIA 规范	`aria-haspopup`=`menu`
MSAA + IAccessible2	状态：`STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:menu`
UIA	控件模式：`ExpandCollapse` 另见：`aria-expanded`
ATK/AT-SPI	状态：`STATE_HAS_POPUP` 对象属性：`haspopup:menu`
AX API	属性：`AXPopupValue:menu` 动作：`AXShowMenu`
Android	待定

ARIA 规范	`aria-haspopup`=`tree`
MSAA + IAccessible2	状态：`STATE_SYSTEM_HASPOPUP` 对象属性：`haspopup:tree`
UIA	控件模式：`ExpandCollapse` 另见：`aria-expanded`
ATK/AT-SPI	状态：`STATE_HAS_POPUP` 对象属性：`haspopup:tree`
AX API	属性：`AXPopupValue:tree` 动作：`AXShowMenu`
Android	待定

ARIA 规范	`aria-hidden`=`true` 于未聚焦元素上
MSAA + IAccessible2	元素 SHOULD NOT 被暴露另见：WAI-ARIA 规范中的将元素包含进可访问性树
UIA	元素 SHOULD NOT 被暴露另见：WAI-ARIA 规范中的将元素包含进可访问性树
ATK/AT-SPI	元素 SHOULD NOT 被暴露另见：WAI-ARIA 规范中的将元素包含进可访问性树
AX API	元素 SHOULD NOT 被暴露另见：WAI-ARIA 规范中的将元素包含进可访问性树
Android	待定

ARIA 规范	`aria-hidden`=`true` 当元素被聚焦或触发可访问性事件时
MSAA + IAccessible2	对象属性：`hidden:true` 另见：WAI-ARIA 规范中的将元素包含进可访问性树
UIA	属性：`AriaProperties.hidden`： `true` 另见：WAI-ARIA 规范中的将元素包含进可访问性树
ATK/AT-SPI	对象属性：`hidden:true` 另见：WAI-ARIA 规范中的将元素包含进可访问性树
AX API	未映射另见：WAI-ARIA 规范中的将元素包含进可访问性树
Android	待定

ARIA 规范	`aria-hidden`=`false`
MSAA + IAccessible2	未映射
UIA	未映射
ATK/AT-SPI	未映射
AX API	未映射
Android	待定

ARIA 规范	`aria-invalid`=`true`
MSAA + IAccessible2	状态：`IA2_STATE_INVALID_ENTRY` 文本属性：`invalid:true`
UIA	属性：`IsDataValidForForm`： `false`
ATK/AT-SPI	状态：`STATE_INVALID_ENTRY` 文本属性：`invalid:true`
AX API	属性：`AXInvalid`：`true`
Android	待定

ARIA 规范	`aria-invalid`=`false`
MSAA + IAccessible2	状态：不暴露 `IA2_STATE_INVALID_ENTRY`
UIA	属性：`IsDataValidForForm`： `true`
ATK/AT-SPI	状态：不暴露 `STATE_INVALID_ENTRY`
AX API	属性：`AXInvalid`：`false`
Android	待定

ARIA 规范	`aria-invalid`=`spelling` 或 `grammar`
MSAA + IAccessible2	状态：`IA2_STATE_INVALID_ENTRY` 文本属性：`invalid:<value>`
UIA	属性：`IsDataValidForForm`： `<value>`
ATK/AT-SPI	状态：`STATE_INVALID_ENTRY` 文本属性：`invalid:<value>`
AX API	属性：`AXInvalid`： `<value>`
Android	待定

ARIA 规范	`aria-invalid` 为无法识别的值
MSAA + IAccessible2	状态：`IA2_STATE_INVALID_ENTRY` 文本属性：`invalid:true`
UIA	属性：`IsDataValidForForm`： `false`
ATK/AT-SPI	状态：`STATE_INVALID_ENTRY` 文本属性：`invalid:true`
AX API	属性：`AXInvalid`：`true`
Android	待定

ARIA 规范	`aria-keyshortcuts`
MSAA + IAccessible2	属性：`accKeyboardShortcut`： `<value>`
UIA	属性：`AcceleratorKey`： `<value>`
ATK/AT-SPI	对象属性： `keyshortcuts:<value>`
AX API	属性：`AXKeyShortcutsValue`： `<value>`
Android	待定

ARIA 规范	`aria-label`
MSAA + IAccessible2	属性：`accName`： `<value>` 另见：名称计算
UIA	属性：`Name`： `<value>` 另见：名称计算
ATK/AT-SPI	属性：`Name`： `<value>` 另见：名称计算
AX API	属性：`AXTitle`： `<value>` 另见：名称计算
Android	待定

ARIA 规范	`aria-labelledby`
MSAA + IAccessible2	属性：`accName`： `<value>` 关系：`IA2_RELATION_LABELLED_BY` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`IA2_RELATION_LABEL_FOR` 指向元素另见：名称计算和映射附加关系
UIA	属性：`Name`： `<value>` 属性：`LabeledBy`：指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中另见：名称计算
ATK/AT-SPI	属性：`Name`： `<value>` 关系：`RELATION_LABELLED_BY` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`RELATION_LABEL_FOR` 指向元素另见：名称计算和映射附加关系
AX API	属性：`AXTitle`： `<value>` 属性：`AXTitleUIElement` 指向与 IDREF 匹配的可访问节点，如果只有一个被引用元素且该元素在可访问性树中另见：名称计算
Android	待定

ARIA 规范	`aria-level` 在非 `heading` 上
MSAA + IAccessible2	对象属性：`level:<value>` 方法：`IAccessible2::groupPosition()`：在支持 `aria-posinset` 和 `aria-setsize` 的角色上为 `groupLevel=<value>` 另见：`groupPosition()`
UIA	属性：`AriaProperties.level`： `<value>`
ATK/AT-SPI	对象属性：`level:<value>`
AX API	属性：`AXDisclosureLevel`： `<value>`（从零开始），当用于大纲行（如 `treeitem` 或 `group`）时
Android	待定

ARIA 规范	`aria-level` 在 `heading` 上
MSAA + IAccessible2	对象属性：`level:<value>`
UIA	属性：`AriaProperties.level`： `<value>` 属性：`StyleId_Heading`： `<value>`
ATK/AT-SPI	对象属性：`level:<value>`
AX API	属性：`AXValue`： `<value>`
Android	待定

ARIA 规范	`aria-live`=`assertive`
MSAA + IAccessible2	对象属性：`live:assertive` 对象属性： `container-live:assertive` 对象属性：所有后代上的 `container-live:assertive` 另见：文档内容或节点可见性的更改
UIA	属性：`LiveSetting`： `"assertive"` 另见：文档内容或节点可见性的更改
ATK/AT-SPI	对象属性：`live:assertive` 对象属性： `container-live:assertive` 对象属性：所有后代上的 `container-live:assertive` 另见：文档内容或节点可见性的更改
AX API	属性：`AXARIALive`： `"assertive"` 另见：文档内容或节点可见性的更改
Android	待定

ARIA 规范	`aria-live`=`polite`
MSAA + IAccessible2	对象属性：`live:polite` 对象属性： `container-live:polite` 对象属性：所有后代上的 `container-live:polite` 另见：文档内容或节点可见性的更改
UIA	属性：`LiveSetting`： `"polite"` 另见：文档内容或节点可见性的更改
ATK/AT-SPI	对象属性：`live:polite` 对象属性： `container-live:polite` 对象属性：所有后代上的 `container-live:polite` 另见：文档内容或节点可见性的更改
AX API	属性：`AXARIALive`： `"polite"` 另见：文档内容或节点可见性的更改
Android	待定

ARIA 规范	`aria-live`=`off`
MSAA + IAccessible2	对象属性：`live:off` 对象属性：`container-live:off` 对象属性：所有后代上的 `container-live:off`
UIA	属性：`LiveSetting`： `"off"`
ATK/AT-SPI	对象属性：`live:off` 对象属性：`container-live:off` 对象属性：所有后代上的 `container-live:off`
AX API	属性：`AXARIALive`：`"off"`
Android	待定

ARIA 规范	`aria-modal`=`true`
MSAA + IAccessible2	状态：`IA2_STATE_MODAL`
UIA	属性：`Window.IsModal`： `true`
ATK/AT-SPI	状态：`STATE_MODAL`
AX API	剪除可访问性树，使背景内容不再暴露。不在与带有 `aria-modal="true"` 的元素相对应的可访问对象上设置特定属性。只暴露以该模态可访问对象为根的树。
Android	待定

ARIA 规范	`aria-modal`=`false`
MSAA + IAccessible2	状态：不暴露 `IA2_STATE_MODAL`
UIA	属性：`Window.IsModal`： `false`
ATK/AT-SPI	状态：不暴露 `STATE_MODAL`
AX API	扩展可访问性树，使背景内容被暴露。不在与带有 `aria-modal="false"` 的元素相对应的可访问对象上设置特定属性。
Android	待定

ARIA 规范	`aria-multiline`=`true`
MSAA + IAccessible2	状态：`IA2_STATE_MULTI_LINE` 状态：不暴露 `IA2_STATE_SINGLE_LINE`
UIA	属性：`AriaProperties.multiline`： `true`
ATK/AT-SPI	状态：`STATE_MULTI_LINE` 状态：不暴露 `STATE_SINGLE_LINE`
AX API	未映射另见：角色映射表中的 `textbox`
Android	待定

ARIA 规范	`aria-multiline`=`false`
MSAA + IAccessible2	状态：`IA2_STATE_SINGLE_LINE` 状态：不暴露 `IA2_STATE_MULTI_LINE`
UIA	未映射
ATK/AT-SPI	状态：`STATE_SINGLE_LINE` 状态：不暴露 `STATE_MULTI_LINE`
AX API	未映射另见：角色映射表中的 `textbox`
Android	待定

ARIA 规范	`aria-multiselectable`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_MULTISELECTABLE` 状态：`STATE_SYSTEM_EXTSELECTABLE` 另见：选择以了解可访问性事件的详细信息
UIA	属性：`Selection.CanSelectMultiple`： `true` 另见：选择以了解可访问性事件的详细信息
ATK/AT-SPI	状态：`STATE_MULTISELECTABLE` 另见：选择以了解可访问性事件的详细信息
AX API	属性：`AXIsMultiSelectable`： `YES` 另见：选择以了解可访问性事件的详细信息
Android	待定

ARIA 规范	`aria-multiselectable`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_MULTISELECTABLE` 状态：不暴露 `STATE_SYSTEM_EXTSELECTABLE` 另见：选择以了解可访问性事件的详细信息
UIA	未映射*
ATK/AT-SPI	状态：不暴露 `STATE_MULTISELECTABLE`
AX API	未映射*
Android	待定

ARIA 规范	`aria-orientation`=`horizontal`
MSAA + IAccessible2	状态：`IA2_STATE_HORIZONTAL` 状态：不暴露 `IA2_STATE_VERTICAL`
UIA	属性：`Orientation`： `horizontal`
ATK/AT-SPI	状态：`STATE_HORIZONTAL` 状态：不暴露 `STATE_VERTICAL`
AX API	属性：`AXOrientation`： `AXHorizontalOrientation`
Android	待定

ARIA 规范	`aria-orientation`=`vertical`
MSAA + IAccessible2	状态：`IA2_STATE_VERTICAL` 状态：不暴露 `IA2_STATE_HORIZONTAL`
UIA	属性：`Orientation`： `vertical`
ATK/AT-SPI	状态：`STATE_VERTICAL` 状态：不暴露 `STATE_HORIZONTAL`
AX API	属性：`AXOrientation`： `AXVerticalOrientation`
Android	待定

ARIA 规范	`aria-orientation` 未定义
MSAA + IAccessible2	未映射*
UIA	未映射*
ATK/AT-SPI	状态：不暴露 `STATE_VERTICAL` 状态：不暴露 `STATE_HORIZONTAL`
AX API	属性：`AXOrientation`： `AXUnknownOrientation`
Android	待定

ARIA 规范	`aria-owns`
MSAA + IAccessible2	用户代理 MAY 将此属性所引用的元素暴露为当前元素的子项。在这种情况下，如果发现多个 `aria-owns` 关系，则只使用第一个。如果未修改可访问性树，则暴露为：关系：`IA2_RELATION_NODE_PARENT_OF` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`IA2_RELATION_NODE_CHILD_OF` 指向元素另见：映射附加关系
UIA	将此属性所引用的元素暴露为当前元素的子项。如果发现多个 `aria-owns` 关系，则只使用第一个。
ATK/AT-SPI	用户代理 MAY 将此属性所引用的元素暴露为当前元素的子项。在这种情况下，如果发现多个 `aria-owns` 关系，则只使用第一个。如果未修改可访问性树，则暴露为：关系：`RELATION_NODE_PARENT_OF` 指向与 IDREF 匹配的可访问节点，如果被引用对象在可访问性树中反向关系：`RELATION_NODE_CHILD_OF` 指向元素另见：映射附加关系
AX API	属性：`AXOwns`：指向与 IDREF 匹配的可访问节点的指针
Android	待定

ARIA 规范	`aria-placeholder`
MSAA + IAccessible2	对象属性： `placeholder-text:<value>`
UIA	属性：`HelpText`： `<value>`
ATK/AT-SPI	对象属性： `placeholder-text:<value>`
AX API	属性：`AXPlaceholderValue`： `<value>`
Android	待定

ARIA 规范	`aria-posinset`
MSAA + IAccessible2	对象属性： `posinset:<value>` 另见：组位置
UIA	属性：`AriaProperties.posinset`： `<value>` 另见：组位置
ATK/AT-SPI	对象属性： `posinset:<value>` 另见：组位置
AX API	属性：`AXARIAPosInSet`： `<value>` 另见：组位置
Android	待定

ARIA 规范	`aria-pressed`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_PRESSED` 另见：`button` 具有 `aria-pressed` 的已定义值
UIA	属性：`Toggle.ToggleState`： `On (1)`
ATK/AT-SPI	状态：`STATE_PRESSED` 另见：`button` 具有 `aria-pressed` 的已定义值
AX API	属性：`AXValue`：`1` 另见：`button` 具有 `aria-pressed` 的已定义值
Android	待定

ARIA 规范	`aria-pressed`=`mixed`
MSAA + IAccessible2	状态：`STATE_SYSTEM_MIXED` 另见：`button` 具有 `aria-pressed` 的已定义值
UIA	属性：`Toggle.ToggleState`： `Indeterminate (2)`
ATK/AT-SPI	状态：`STATE_INDETERMINATE` 另见：`button` 具有 `aria-pressed` 的已定义值
AX API	属性：`AXValue`：`2` 另见：`button` 具有 `aria-pressed` 的已定义值
Android	待定

ARIA 规范	`aria-pressed`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_PRESSED` 另见：`button` 具有 `aria-pressed` 的已定义值
UIA	属性：`Toggle.ToggleState`： `Off (3)`
ATK/AT-SPI	状态：不暴露 `STATE_PRESSED` 另见：`button` 具有 `aria-pressed` 的已定义值
AX API	属性：`AXValue`：`0` 另见：`button` 具有 `aria-pressed` 的已定义值
Android	待定

ARIA 规范	`aria-pressed` 未定义
MSAA + IAccessible2	未映射*
UIA	未映射*
ATK/AT-SPI	未映射*
AX API	未映射*
Android	待定

ARIA 规范	`aria-readonly`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_READONLY`
UIA	属性：`Value.IsReadOnly`：`true`，如果元素实现 `IValueProvider`。属性：`RangeValue.IsReadOnly`： `true`，如果元素实现 `IRangeValueProvider`。属性：`AriaProperties.readonly`： `true`
ATK/AT-SPI	状态：`STATE_READ_ONLY` 状态：在文本输入角色上不暴露 `STATE_EDITABLE` 状态：在支持 `aria-checked` 的角色上不暴露 `STATE_CHECKABLE` 状态：当用于 `radiogroup` 时，不在 radio 后代上暴露 `STATE_CHECKABLE`
AX API	方法：`AXUIElementIsAttributeSettable(AXValue)`： `NO`
Android	待定

ARIA 规范	`aria-readonly`=`false`
MSAA + IAccessible2	状态：不暴露 `STATE_SYSTEM_READONLY` 状态：`IA2_STATE_EDITABLE`
UIA	属性：`Value.IsReadOnly`：`false`，如果元素实现 `IValueProvider`。属性：`RangeValue.IsReadOnly`： `false`，如果元素实现 `IRangeValueProvider`。属性：`AriaProperties.readonly`： `false`
ATK/AT-SPI	状态：不暴露 `STATE_READ_ONLY`
AX API	方法：`AXUIElementIsAttributeSettable(AXValue)`： `YES`
Android	待定

ARIA 规范	`aria-readonly` 在 `gridcell` 上未指定
MSAA + IAccessible2	`gridcell` MUST 从包含它的 `grid` 或 `treegrid` 继承作者提供的任何 `aria-readonly` 值。按 `aria-readonly="true"` 和 `aria-readonly="false"` 所述，在 `gridcell` 上暴露继承的值。
UIA	`gridcell` MUST 从包含它的 `grid` 或 `treegrid` 继承作者提供的任何 `aria-readonly` 值。按 `aria-readonly="true"` 和 `aria-readonly="false"` 所述，在 `gridcell` 上暴露继承的值。
ATK/AT-SPI	`gridcell` MUST 从包含它的 `grid` 或 `treegrid` 继承作者提供的任何 `aria-readonly` 值。按 `aria-readonly="true"` 和 `aria-readonly="false"` 所述，在 `gridcell` 上暴露继承的值。
AX API	`gridcell` MUST 从包含它的 `grid` 或 `treegrid` 继承作者提供的任何 `aria-readonly` 值。按 `aria-readonly="true"` 和 `aria-readonly="false"` 所述，在 `gridcell` 上暴露继承的值。
Android	待定

ARIA 规范	`aria-relevant`
MSAA + IAccessible2	对象属性： `relevant:<value>` 对象属性： `container-relevant:<value>` 对象属性：所有后代上的 `container-relevant:<value>` 另见：文档内容或节点可见性的更改
UIA	属性：`AriaProperties.relevant`： `<value>` 另见：文档内容或节点可见性的更改
ATK/AT-SPI	对象属性： `relevant:<value>` 对象属性： `container-relevant:<value>` 对象属性：所有后代上的 `container-relevant:<value>` 另见：文档内容或节点可见性的更改
AX API	属性：`AXARIARelevant`： `<value>` 另见：文档内容或节点可见性的更改
Android	待定

ARIA 规范	`aria-required`=`true`
MSAA + IAccessible2	状态：`IA2_STATE_REQUIRED`
UIA	属性：`IsRequiredForForm`： `true`
ATK/AT-SPI	状态：`STATE_REQUIRED`
AX API	属性：`AXRequired`：`YES`
Android	待定

ARIA 规范	`aria-required`=`false`
MSAA + IAccessible2	未映射*
UIA	未映射*
ATK/AT-SPI	未映射*
AX API	未映射*
Android	待定

ARIA 规范	`aria-roledescription`
MSAA + IAccessible2	方法：`localizedExtendedRole()`： `<value>`
UIA	本地化控件类型：`<value>`
ATK/AT-SPI	对象属性： `roledescription:<value>`
AX API	属性：`AXRoleDescription`： `<value>`
Android	待定

ARIA 规范	`aria-roledescription` 未定义或为空字符串
MSAA + IAccessible2	未映射
UIA	本地化控件类型被定义为为元素角色指定的类型：如果提供了 role 属性，则基于显式角色；否则，基于宿主语言的隐式角色。
ATK/AT-SPI	未映射
AX API	AXRoleDescription 被定义为为元素角色指定的内容：如果提供了 role 属性，则基于显式角色；否则，基于宿主语言的隐式角色。
Android	待定

ARIA 规范	`aria-rowcount`
MSAA + IAccessible2	对象属性： `rowcount:<value>` 方法：`IAccessible2::groupPosition()`：在行上为 `similarItemsInGroup=<value>`
UIA	属性：`Grid.RowCount`： `<value>`
ATK/AT-SPI	对象属性：`rowcount` 应包含作者提供的值。方法：`atk_table_get_n_rows()` 应返回实际行数。
AX API	属性：`AXARIARowCount`： `<value>`
Android	待定

ARIA 规范	`aria-rowindex`
MSAA + IAccessible2	对象属性： `rowindex:<value>` 方法：`IAccessible2::groupPosition()`：在行上为 `positionInGroup=<value>`
UIA	属性：`GridItem.Row`： `<value>`（从零开始）
ATK/AT-SPI	对象属性：`rowindex` 应包含作者提供的值。方法：`atk_table_cell_get_position()` 应返回实际的（从零开始的）行索引。
AX API	属性：`AXARIARowIndex`： `<value>`
Android	待定

ARIA 规范	`aria-rowindextext`
MSAA + IAccessible2	对象属性： `rowindextext:<value>`
UIA	属性：`AriaProperties.rowindextext`： `<value>`
ATK/AT-SPI	对象属性： `rowindextext:<value>`
AX API	属性：`AXRowIndexDescription`： `<value>`
Android	待定

ARIA 规范	`aria-rowspan`
MSAA + IAccessible2	对象属性： `rowspan:<value>` 方法：`IAccessibleTableCell::rowExtent()`： `column=<value>`
UIA	属性：`GridItem.RowSpan`： `<value>`
ATK/AT-SPI	对象属性：`rowspan` 应包含作者提供的值。方法：`atk_table_cell_get_row_column_span()` 应返回实际行跨度。
AX API	属性：`AXRowIndexRange.length`： `<value>`
Android	待定

ARIA 规范	`aria-selected`=`true`
MSAA + IAccessible2	状态：`STATE_SYSTEM_SELECTABLE` 状态：`STATE_SYSTEM_SELECTED` 另见：选择以了解可访问性事件的详细信息
UIA	属性：`SelectionItem.IsSelected`： `true`
ATK/AT-SPI	状态：`STATE_SELECTABLE` 状态：`STATE_SELECTED` 另见：选择以了解可访问性事件的详细信息
AX API	属性：`AXSelected`：`YES`
Android	待定

ARIA 规范	`aria-selected`=`false`
MSAA + IAccessible2	状态：`STATE_SYSTEM_SELECTABLE` 状态：不暴露 `STATE_SYSTEM_SELECTED` 另见：选择以了解可访问性事件的详细信息
UIA	属性：`SelectionItem.IsSelected`： `false`
ATK/AT-SPI	状态：`STATE_SELECTABLE` 状态：不暴露 `STATE_SELECTED` 另见：选择以了解可访问性事件的详细信息
AX API	属性：`AXSelected`：`NO`
Android	待定

ARIA 规范	`aria-selected` 未定义
MSAA + IAccessible2	未映射
UIA	未映射
ATK/AT-SPI	未映射
AX API	未映射
Android	待定

ARIA 规范	`aria-setsize`
MSAA + IAccessible2	对象属性： `setsize:<value>` 另见：组位置
UIA	属性：`AriaProperties.setsize`： `<value>` 另见：组位置
ATK/AT-SPI	如果作者提供的 `aria-setsize` 值为 `-1`，则暴露值应基于 DOM 中对象的数量。对象属性： `setsize:<value>` 状态：如果作者提供的值为 `-1`，则为 `STATE_INDETERMINATE` 另见：组位置
AX API	属性：`AXARIASetSize`： `<value>` 另见：组位置
Android	待定

ARIA 规范	`aria-sort`=`ascending`
MSAA + IAccessible2	对象属性：`sort:ascending`
UIA	属性：`AriaProperties.sort`： `ascending` 属性：`ItemStatus`：如果该元素映射到 `HeaderItem` 控件类型，则为 `ascending`
ATK/AT-SPI	对象属性：`sort:ascending`
AX API	属性：`AXSortDirection`： `AXAscendingSortDirection`
Android	待定

ARIA 规范	`aria-sort`=`descending`
MSAA + IAccessible2	对象属性：`sort:descending`
UIA	属性：`AriaProperties.sort`： `descending` 属性：`ItemStatus`：如果该元素映射到 `HeaderItem` 控件类型，则为 `descending`
ATK/AT-SPI	对象属性：`sort:descending`
AX API	属性：`AXSortDirection`： `AXDescendingSortDirection`
Android	待定

ARIA 规范	`aria-sort`=`other`
MSAA + IAccessible2	对象属性：`sort:other`
UIA	属性：`AriaProperties.sort`： `other` 属性：`ItemStatus`：如果该元素映射到 `HeaderItem` 控件类型，则为 `other`
ATK/AT-SPI	对象属性：`sort:other`
AX API	属性：`AXSortDirection`： `AXUnknownSortDirection`
Android	待定

ARIA 规范	`aria-sort`=`none`
MSAA + IAccessible2	对象属性：如果该值不是未指定，则为 `sort:none`
UIA	未映射*
ATK/AT-SPI	对象属性：如果该值不是未指定，则为 `sort:none`
AX API	未映射*
Android	待定

ARIA 规范	`aria-valuemax`
MSAA + IAccessible2	方法：`IAccessibleValue::maximumValue()`： `<value>` 另见：处理状态和属性的作者错误
UIA	属性：`RangeValue.Maximum`： `<value>` 另见：处理状态和属性的作者错误
ATK/AT-SPI	方法：`atk_value_get_maximum_value()`： `<value>` 另见：处理状态和属性的作者错误
AX API	属性：`AXMaxValue`： `<value>` 另见：处理状态和属性的作者错误
Android	待定

ARIA 规范	`aria-valuemin`
MSAA + IAccessible2	方法：`IAccessibleValue::minimumValue()`： `<value>` 另见：处理状态和属性的作者错误
UIA	属性：`RangeValue.Minimum`： `<value>` 另见：处理状态和属性的作者错误
ATK/AT-SPI	方法：`atk_value_get_minimum_value()`： `<value>` 另见：处理状态和属性的作者错误
AX API	属性：`AXMinValue`： `<value>` 另见：处理状态和属性的作者错误
Android	待定

ARIA 规范	`aria-valuenow`
MSAA + IAccessible2	方法：`IAccessibleValue::currentValue()`： `<value>` 方法：如果未定义 `aria-valuetext`，则 `IAccessible::get_accValue()`： `<value>` 另见：处理状态和属性的作者错误
UIA	属性：`RangeValue.Value`： `<value>` 另见：处理状态和属性的作者错误
ATK/AT-SPI	方法：`atk_value_get_current_value()`： `<value>` 另见：处理状态和属性的作者错误
AX API	属性：`AXValue`： `<value>` 另见：处理状态和属性的作者错误
Android	待定

ARIA 规范	`aria-valuetext`
MSAA + IAccessible2	方法：`IAccessible::get_accValue()`： `<value>` 对象属性： `valuetext:<value>` 另见：处理状态和属性的作者错误
UIA	属性：`Value.Value`： `<value>` 另见：处理状态和属性的作者错误
ATK/AT-SPI	对象属性： `valuetext:<value>` 另见：处理状态和属性的作者错误
AX API	属性：`AXValueDescription`： `<value>` 另见：处理状态和属性的作者错误
Android	待定

有关如何计算可访问名称或可访问描述的信息，请参见可访问名称和描述计算规范中标题为可访问名称和描述计算的章节。

在 GUI 中，控件之间通常存在一些关系，这些关系可以通过编程方式暴露给辅助技术。WAI-ARIA 提供了几个关系属性，它们全局适用于任何元素：aria-controls、aria-describedby、aria-flowto、aria-labelledby、aria-owns、aria-posinset 和 aria-setsize。因此，在计算它们之前不需要检查角色。用户代理只需按照标题为可访问性 API 的状态和属性映射章节中的定义，映射这些关系即可。

当一个元素的 ID 被另一个属性中的另一个元素引用时，就存在反向关系。对于支持反向关系的 API，当一个元素的 ID 被另一个元素的关系属性引用，且被引用元素位于可访问性树中时，用户代理 MUST 使用状态和属性映射表中定义的映射。所有 WAI-ARIA 引用都必须指向可访问性树中作为可访问对象暴露的元素。当被引用对象未在可访问性树中暴露时（例如因为它是隐藏的），该引用为空。aria-labelledby 和 aria-describedby 还有一个附加功能，它允许从被引用元素中提取扁平化字符串，以填充可访问性 API 的名称或描述字段。此功能在名称和描述章节中描述。

特殊情况：如果同时使用了 aria-labelledby 和 HTML <label for= … >，则用户代理 MUST 使用 WAI-ARIA 关系，并且 MUST 忽略 HTML 标签关系。

注意，aria-describedby 可能引用结构化或交互式信息，而用户可能希望能够导航到内容的不同部分。用户代理 MAY 提供一种方式，使用户能够导航到 aria-describedby 所引用的结构化信息，并且辅助技术 SHOULD 提供这样的方法。

除了由 WAI-ARIA 属性定义的显式关系之外，在另外两种情况下也会隐含反向关系：具有 role="treeitem" 且祖先没有 aria-owns 属性的元素，以及具有 aria-atomic 属性的元素的后代。

在 role="treeitem" 的情况下，当未使用 aria-owns 时，用户代理 SHOULD 在 API 支持反向关系的地方执行以下操作：

如果当前 treeitem 使用 aria-level，则在树中向后遍历，直到找到具有更低 aria-level 的 treeitem，然后将 RELATION_NODE_CHILD_OF 设置为该元素。如果到达树的顶部，则将 RELATION_NODE_CHILD_OF 设置为树元素本身。
如果 treeitem 的父项具有角色 group，则从 group 向后遍历，直到找到角色为 treeitem 的元素，然后将 RELATION_NODE_CHILD_OF 设置为该元素。

在 aria-atomic 的情况下，在 API 支持反向关系的地方：

用户代理 SHOULD 检查祖先元素链中是否存在 aria-atomic="true"。如果找到，用户代理 SHOULD 将 RELATION_MEMBER_OF 关系设置为指向设置了 aria-atomic="true" 的祖先。

aria-level、 aria-posinset 和 aria-setsize 都是从 1 开始的。当属性不存在或为 "0" 时，表示该属性未计算或不受支持。如果作者将这些属性中的任何一个指定为 "0" 或负数，用户代理 SHOULD 改用 "1"。

如果具有角色 treeitem 或 comment 的元素没有提供或继承 aria-level，则实现 IAccessible2 或 ATK/AT-SPI 的用户代理 MUST 通过遵循显式或计算出的 RELATION_NODE_CHILD_OF 关系来计算它。

如果未提供 aria-posinset 和 aria-setsize，用户代理 MUST 按如下方式计算它们：

对于 role="treeitem" 和 role="comment"，向后和向前遍历树，直到显式或计算出的层级变得小于当前项的层级。只有当项目与当前项目处于同一层级时才计数。
否则，如果该角色支持 aria-posinset 和 aria-setsize，则处理父项（DOM 父项，或由 aria-owns 定义的父项），并对具有相同角色的项目进行计数。
由于这些值是从 1 开始的，因此在计算中包括当前项目。对于 aria-posinset，包括当前项目以及在 DOM 中位于当前项目之前的其他组项目。对于 aria-setsize，再加上 DOM 中当前项目之后同一组中的项目数量。

如果作者提供了 aria-setsize 和 aria-posinset 中的一个或多个，则作者有责任为集合中的所有元素提供它们。用户代理在这种情况下如何校正缺失值未定义。

MSAA/IAccessible2 API 映射涉及一个附加函数 groupPosition() [IAccessible2]，当 aria-level、 aria-posinset 和/或 aria-setsize 存在于某个元素上，或由用户代理计算得出时使用。当发生这种情况时：

aria-level 在 groupPosition() 的 groupLevel 参数中暴露，
aria-setsize 在 similarItemsInGroup 参数中暴露，并且
aria-posinset 在 positionInGroup 参数中暴露。

作为按角色映射中的定义将角色映射到可访问对象的一部分，用户代理会在对象上暴露默认动作。

MSAA：如果 AT 在可访问对象上调用 DoDefaultAction，用户代理 SHOULD 在映射到该可访问对象的 DOM 元素上模拟点击。
IAccessible2：如果 AT 在可访问对象上调用 IAccessibleAction，用户代理 SHOULD 在映射到该可访问对象的 DOM 元素上模拟点击。
UIA Automation：如果 AT 在可访问对象上调用任何 UIA 模式方法，用户代理 SHOULD 在映射到该可访问对象的 DOM 元素上模拟点击。
ATK/AT-SPI：如果 AT 在可访问对象上调用某个动作，用户代理 SHOULD 在映射到该可访问对象的 DOM 元素上模拟点击。
AX API：如果 AT 在可访问对象上触发 AXPress 动作，用户代理 SHOULD 在映射到该可访问对象的 DOM 元素上模拟点击。

注

作者需要为这些点击事件创建处理程序，以相应地更新 WAI-ARIA 状态和属性在 DOM 中的值，从而使这些更新后的状态能够由用户代理填充到可访问性 API 中。

用户代理会为用户动作、WAI-ARIA 状态更改、文档内容或节点可见性更改、选择更改以及菜单操作触发事件，如下列章节所定义。

用户代理 MUST 按下表定义，将状态更改通知给辅助技术；如果可访问性 API为该属性定义了更改事件，则 SHOULD 将属性更改通知给辅助技术；如果可访问性 API 没有为该属性定义更改事件，则 SHOULD NOT 将属性更改通知给辅助技术。例如，IAccessible2 定义了一个在 aria-activedescendant 更改时使用的事件。预期会更改的 WAI-ARIA 属性包括 aria-activedescendant、 aria-valuenow 和 aria-valuetext。

注

在某些 API 中，AT 只会收到其已订阅事件的通知。

为了简单性和性能，用户代理 MAY 剔除辅助技术通常会忽略的状态或属性更改事件，例如发生在当前没有焦点的窗口中的事件。

注

译者：关于以下表格及其切换按钮关联的标签文本，请参见本文档 <head> 节中的 mappingTableLabels 对象。

ARIA 规范	`aria-activedescendant`
MSAA + IAccessible2 事件	见焦点更改。此外： `IA2_EVENT_ACTIVE_DESCENDANT_CHANGED`
UIA 事件	见焦点更改。此外： `PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	见焦点更改。
AX API 通知	见焦点更改。此外：`AXSelectedChildrenChanged`
Android	待定

ARIA 规范	`aria-busy` （状态）
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:state-changed:busy`
AX API 通知	`AXElementBusyChanged`
Android	待定

ARIA 规范	`aria-checked` （状态）
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`，以及作为 `toggle` 模式一部分的 `ToggleState`
ATK/AT-SPI 事件	`object:state-changed:checked`
AX API 通知	`AXValueChanged`
Android	待定

ARIA 规范	`aria-current` （状态）
MSAA + IAccessible2 事件	`IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:state-changed:active`
AX API 通知	`AXCurrentStateChanged`
Android	待定

ARIA 规范	`aria-disabled` （状态）
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`、`IsEnabled`
ATK/AT-SPI 事件	`object:state-changed:enabled` 和 `object:state-changed:sensitive`
AX API 通知	`AXDisabledStateChanged`
Android	待定

ARIA 规范	`aria-describedby`
MSAA + IAccessible2 事件	`EVENT_OBJECT_DESCRIPTIONCHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`DescribedBy`
ATK/AT-SPI 事件	`object:property-change:accessible-description`
AX API 通知	`AXDescribedByChanged`
Android	待定

ARIA 规范	`aria-dropeffect` （属性，已弃用）
MSAA + IAccessible2 事件	`IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:property-change`
AX API 通知	`AXDropEffectChanged`
Android	待定

ARIA 规范	`aria-expanded` （状态）
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`，以及作为 `ExpandCollapse` 模式一部分的 `ExpandCollapseState`
ATK/AT-SPI 事件	`object:state-changed:expanded`
AX API 通知	`AXRowExpanded`、 `AXRowCollapsed`、 `AXRowCountChanged`
Android	待定

ARIA 规范	`aria-grabbed` （状态，已弃用）
MSAA + IAccessible2 事件	`EVENT_OBJECT_SELECTION` `IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:property-change`
AX API 通知	`AXGrabbedStateChanged`
Android	待定

ARIA 规范	`aria-hidden` （状态）
MSAA + IAccessible2 事件	`IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED`
UIA 事件	`StructureChangedEvent` `PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:property-change`
AX API 通知	`AXUIElementDestroyed`、 `AXUIElementCreated`
Android	待定

ARIA 规范	`aria-invalid` （状态）
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`、`IsDataValidForForm`
ATK/AT-SPI 事件	`object:state-changed:invalid_entry`
AX API 通知	`AXInvalidStatusChanged`
Android	待定

ARIA 规范	`aria-label` 和 `aria-labelledby`
MSAA + IAccessible2 事件	`EVENT_OBJECT_NAMECHANGE`
UIA 事件	`PropertyChangedEvent` `aria-label` 的属性：`AriaProperties` `aria-labelledby` 的属性：`LabeledBy`
ATK/AT-SPI 事件	`object:property-change:accessible-name`
AX API 通知	`AXLabelCreated`
Android	待定

ARIA 规范	`aria-pressed` （状态）
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`，以及作为 `toggle` 模式一部分的 `ToggleState`
ATK/AT-SPI 事件	`object:state-changed:pressed`
AX API 通知	`AXPressedStateChanged`
Android	待定

ARIA 规范	`aria-readonly`
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:state-changed:readonly`
AX API 通知	`AXReadOnlyStatusChanged`
Android	待定

ARIA 规范	`aria-required`
MSAA + IAccessible2 事件	`EVENT_OBJECT_STATECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`、`IsRequiredForForm`
ATK/AT-SPI 事件	`object:state-changed:required`
AX API 通知	`AXRequiredStatusChanged`
Android	待定

ARIA 规范	`aria-selected` （状态）
MSAA + IAccessible2 事件	详见选择章节。
UIA 事件	详见选择章节。
ATK/AT-SPI 事件	详见选择章节。
AX API 通知	详见选择章节。
Android	待定

ARIA 规范	`aria-valuenow`
MSAA + IAccessible2 事件	`EVENT_OBJECT_VALUECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`；如果元素映射为带有 `RangeValue` 控件模式，则还包括 `RangeValueValue`
ATK/AT-SPI 事件	`object:property-change:accessible-value`
AX API 通知	`AXValueChanged`
Android	待定

ARIA 规范	`aria-valuetext`
MSAA + IAccessible2 事件	`EVENT_OBJECT_VALUECHANGE`
UIA 事件	`PropertyChangedEvent` 属性：`AriaProperties`
ATK/AT-SPI 事件	`object:property-change:accessible-value`
AX API 通知	`AXValueChanged`
Android	待定

无论是否存在 WAI-ARIA，处理文档更改都很重要。下表描述的事件由用户代理用于通过可访问性树向 AT 告知 DOM 的更改。就符合本标准而言，只要将 WAI-ARIA 属性应用到 Web 页面上的动态内容，用户代理 MUST 实现本节所述行为。

文档更改场景以及各 API 中要触发的事件表
场景	MSAA + IAccessible2 事件	UIA 事件	ATK/AT-SPI 事件	AX API 通知
当文本被移除时	`IA2_EVENT_TEXT_REMOVED`	`EVENT_OBJECT_LIVEREGIONCHANGED`	`text_changed::delete`	如果位于实时区域中， `AXLiveRegionChanged`。如果位于 `aria-errormessage` 中， `AXValidationErrorChanged`。
当文本被插入时	`IA2_EVENT_TEXT_INSERTED`	`EVENT_OBJECT_LIVEREGIONCHANGED`	`text_changed::insert`	如果位于实时区域中， `AXLiveRegionChanged`。如果位于 `aria-errormessage` 中， `AXValidationErrorChanged`。
当文本被更改时	`IA2_EVENT_TEXT_REMOVE` 和 `IA2_EVENT_TEXT_INSERTED`	`EVENT_OBJECT_LIVEREGIONCHANGED`	`text_changed::delete` 和 `text_changed::insert`	如果位于实时区域中， `AXLiveRegionChanged`。如果位于 `aria-errormessage` 中， `AXValidationErrorChanged`。

对于所涉及的节点是元素且具有可访问对象的节点更改，触发以下事件。节点的可访问性子树是它在可访问性树中的可访问对象及其所有可访问性后代。它不包括在该树中通过非父子关系建立关系的对象。例如，除非通过 aria-flowto 链接的对象同时也是可访问性树中的后代，否则它不包括这些对象。

文档更改场景以及各 API 中要触发的事件表
场景	MSAA	Microsoft UIA 事件	ATK/AT-SPI 事件	AX API 通知
当可访问性子树被隐藏时	`EVENT_OBJECT_HIDE` 不使用名为 `EVENT_OBJECT_DESTROY` 的 MSAA 事件，因为它存在稳定性问题的历史，辅助技术会避免使用它。无论如何，从用户角度看，某物被隐藏和被销毁之间没有差别。	`AutomationElement..::.StructureChangedEvent`	`children_changed::remove`	`AXUIElementDestroyed` 如果位于实时区域中，`AXLiveRegionChanged`
当可访问性子树被移除时	`EVENT_OBJECT_REORDER` 不使用名为 `EVENT_OBJECT_DESTROY` 的 MSAA 事件，因为它存在稳定性问题的历史，辅助技术会避免使用它。无论如何，从用户角度看，某物被隐藏和被销毁之间没有差别。	`AutomationElement..::.StructureChangedEvent`	`children_changed::remove`	`AXUIElementDestroyed` 如果位于实时区域中，`AXLiveRegionChanged`
当可访问性子树显示时	`EVENT_OBJECT_SHOW`		`children_changed::add`	`AXUIElementCreated` 如果位于实时区域中，`AXLiveRegionChanged`
当可访问性子树被插入时	`EVENT_OBJECT_REORDER`		`children_changed::add`	`AXUIElementCreated` 如果位于实时区域中，`AXLiveRegionChanged`
当可访问性子树被移动时	将其视为从一个位置移除并插入到另一个位置	将其视为从一个位置移除并插入到另一个位置	将其视为从一个位置移除并插入到另一个位置	`AXUIElementDestroyed`/ `AXUIElementCreated` 如果位于实时区域中，`AXLiveRegionChanged`
当可访问性子树被更改时（例如 replaceNode）	将其视为移除和插入	将其视为移除和插入	将其视为移除和插入	`AXUIElementDestroyed`/ `AXUIElementCreated` 如果位于实时区域中，`AXLiveRegionChanged`

在某些情况下，节点更改可能发生在不是元素或没有可访问对象的节点上。例如，编号列表项目符号（"12."）可能在可访问性树中有一个节点，但在 DOM 树中没有。对于在 HTML 中标记为 <strong> 的段落内文本，<strong> 元素在 DOM 树中有一个节点，但在可访问性树中可能没有节点。文本本身当然会位于可访问性树中，并带有该文本范围被格式化为 strong 的标识。如果上述表格中描述的任何更改发生在这样的节点上，用户代理 SHOULD 按照上文所述计算并触发相关文本更改事件。

用户代理 SHOULD 确保在进程内运行的辅助技术能够在节点被移除之前收到节点将被移除的通知。这允许辅助技术（例如屏幕阅读器）回溯引用正在删除的对应 DOM 节点。这对于移除操作很重要的实时区域尤其重要。例如，屏幕阅读器会希望通知用户另一个用户已离开聊天室。在 MSAA 中，该事件将是 EVENT_OBJECT_HIDE。对于 ATK/AT-SPI，它将是 children_changed::remove。在 macOS 中，该事件是 AXLiveRegionChanged。这还要求用户代理在可访问性 API 通知中提供唯一 ID，以标识正在被移除的唯一节点。

在触发上述任何更改事件时，提供有关该更改是否由用户输入导致的信息非常有用（而不是由页面加载后启动的超时等导致）。这允许辅助技术针对来自真实世界的更改和来自用户动作的更改采用不同的呈现规则。鼠标悬停不被视为显式用户输入，因为它可能由无意碰到鼠标而发生。

要暴露某个更改是否来自用户输入：

在 ATK/AT-SPI 中，如果该更改不是由用户导致的，可以通过向事件名称追加字符串 ":system" 来提供。
在 IAccessible2 中，屏幕阅读器通常在同一线程的进程内访问它，最佳做法是在事件的可访问对象上暴露对象属性 event-from-user-input:true，如果该更改由用户导致。

暴露有关更改上下文的其他有用信息：

在 ATK/AT-SPI 和 IAccessible2 中，可访问事件的目标可访问对象上的 RELATION_MEMBER_OF 关系 SHOULD 指向任何带有 aria-atomic="true" 的祖先（如果有）。
在 ATK/AT-SPI 和 IAccessible2 中， container-live、 container-relevant、container-busy、container-atomic 对象属性 SHOULD 暴露在可访问事件对象上，为相关 WAI-ARIA 属性提供计算值。计算值是最近祖先的值。建议在使用默认值时不暴露该对象属性。

可能还需要其他 MSAA 事件：

如果具有映射的 MSAA 角色 ROLE_SYSTEM_ALERT 的祖先中发生某些更改，则 SHOULD 为该警报触发 EVENT_SYSTEM_ALERT 事件。 alert 角色对 aria-live 属性具有隐含值 "assertive"。
可能需要触发菜单事件。见菜单的特殊事件。

下表定义了可访问性 API 键盘焦点状态和事件。

焦点状态和事件的可访问性 API 表
	MSAA	Microsoft UIA	ATK/AT-SPI	AX API
可聚焦状态	`STATE_SYSTEM_FOCUSABLE`	当前状态反映在 `IUIAutomationElement::CurrentIsKeyboardFocusable` 中，可使用 `UIA_IsKeyboardFocusablePropertyId` 属性标识符通过 `IUIAutomationElement::GetCurrentPropertyValue` 方法检索。	`STATE_FOCUSABLE`	`boolean AXFocused`：`AXUIElementIsAttributeSettable` 方法返回 `YES`。
已聚焦状态	`STATE_SYSTEM_FOCUSED`	当前状态反映在 `IUIAutomationElement::CurrentHasKeyboardFocus` 中，可使用 `UIA_HasKeyboardFocusPropertyId` 属性标识符通过 `IUIAutomationElement::GetCurrentPropertyValue` 方法检索。	`STATE_FOCUSED`	`boolean AXFocused`
焦点事件	`EVENT_OBJECT_FOCUS`	客户端可以使用 `IUIAutomation::AddFocusChangedEventHandler` 订阅，其回调接口是 `IUIAutomationFocusChangedEventHandler`	`object:state-changed:focused`，以及：对于刚刚获得焦点的可访问对象，`detail1 = 1`。对于刚刚失去焦点的可访问对象，`detail1 = 0`。	`AXFocusedUIElementChanged`

选择有两种情况：

单选
多选

在单选情况下，选择跟随焦点（关于焦点事件的信息，请参见“焦点状态和事件表”章节）。用户代理 MUST 在 aria-selected 更改时触发以下事件：

单选事件
场景	MSAA	Microsoft UIA	ATK/AT-SPI	AX API
焦点更改	在新聚焦的项目上触发 `EVENT_OBJECT_SELECTION` 和 `EVENT_OBJECT_STATECHANGE`。	在新聚焦的元素上触发 `UIA_SelectionItem_ElementSelectedEventId`。如果位于 `gridcell`、`row`、`option` 或 `tab` 上，则触发 `UIA_SelectionItem_ElementSelectedEventId`。	在当前容器上触发 `object:selection-changed`，在选择发生更改的后代可访问对象上触发 `object:state-changed:selected`：对于刚刚变为选中的后代，`detail1 = 1`。对于刚刚变为未选中的后代，`detail1 = 0`。	`AXSelectedChildrenChanged`

多选情况发生在支持该属性的角色的元素上设置了 aria-multiselectable="true" 时。用户代理 MUST 在后代上的 aria-selected 如下更改时触发以下事件：

多选情况发生在支持该属性的角色的元素上设置了 aria-multiselectable="true" 时。有几个重要方面：

在 Microsoft UIA 中，Selection 和 SelectionItem 控件模式暴露选择可用性、状态和方法。
用户代理 MUST 在后代上的 aria-selected 如下更改时触发以下事件：

多选事件
场景	MSAA	Microsoft UIA	ATK/AT-SPI	AX API
切换 `aria-selected`	在该项目上触发 `EVENT_OBJECT_SELECTIONADD`/`EVENT_OBJECT_SELECTIONREMOVE`。	`SelectionItem Control Pattern`：在该项目上触发 `UIA_SelectionItem_ElementAddedToSelectionEventId` 或 `UIA_SelectionItem_ElementRemovedFromSelectionEventId`。	在当前容器上触发 `object:selection-changed`，在选择发生更改的任何后代可访问对象上触发 `object:state-changed:selected`：对于任何刚刚变为选中的后代，`detail1 = 1`。对于任何刚刚变为未选中的后代，`detail1 = 0`。	`AXSelectedChildrenChanged`
选择跟随焦点	在新聚焦的项目上触发 `EVENT_OBJECT_SELECTION` 和 `EVENT_OBJECT_STATECHANGE`。	`FocusChangedEvent` 应被触发，但单独的选择事件可能不会发生，以避免冗余。	在当前容器上触发 `object:selection-changed`，在选择发生更改的任何后代可访问对象上触发 `object:state-changed:selected`：对于任何刚刚变为选中的可访问对象，`detail1 = 1`。对于任何刚刚变为未选中的可访问对象，`detail1 = 0`。	`AXSelectedChildrenChanged`
一次选择或取消选择多个项目	用户代理 MAY 触发 `EVENT_OBJECT_SELECTIONWITHIN`。如果触发此事件，则为了性能，上述其他事件 MAY 被剔除。	对于每个被选中或取消选中的元素，在当前容器上触发 `SelectionItem` 控件模式：`UIA_SelectionItem_ElementAddedToSelectionEventId` 或 `UIA_SelectionItem_ElementRemovedFromSelectionEventId`。用户代理 MAY 选择触发 Selection 控件模式 Invalidated 事件，它表示容器中的选择发生了重大变化，需要发送的添加和移除事件数量超过 `InvalidateLimit` 常量允许的数量。	为了性能，用户代理 MAY 在容器上触发单个 `object:selection-changed` 事件，而不是多个事件，在选择发生更改的任何后代可访问对象上触发 `object:state-changed:selected`：对于任何刚刚变为选中的可访问对象，`detail1 = 1`。对于任何刚刚变为未选中的可访问对象，`detail1 = 0`。	`AXSelectedChildrenChanged`

某些 API 会在菜单打开或关闭时提供特殊事件。用户代理 SHOULD 按下表所述提供这些事件。如果提供这些事件，由于菜单可以通过多种技术变为可见或隐藏，用户代理 MUST 确保这些事件是嵌套且对称的。

通常，menubar 用于组织菜单层次结构。在这些情况下，menubar MUST 是关联 menuitem 的 DOM 父项，或者是由 aria-owns 定义的父项。在其他情况下，不涉及 menubar；例如，当 menu 与工具栏按钮关联，或是上下文菜单时。尽管如此，仍会按下表所述提供相关菜单事件。

菜单事件
场景	MSAA	Microsoft UIA	AX API
Menubar 当前未激活，用户从其他位置将焦点移动到 menubar，从而激活它。因此，menubar 中的一个 menuitem 获得焦点。	激活 menubar，并在 menubar 的可访问对象上触发 `EVENT_SYSTEM_MENUSTART`。	在 menu 的可访问对象上触发 `MenuModeStartEvent`。	`AXMenuOpenedNotification`
在 menubar 被激活时聚焦 menuitem，或聚焦 menu 中的 menuitem。	`EVENT_OBJECT_FOCUS`	`AutomationFocusChangedEvent`	`AXMenuItemSelectedNotification`
菜单弹出项变为可见（菜单被打开）。在菜单关闭并再次打开之前，应只触发一次。	`EVENT_SYSTEM_MENUPOPUPSTART`	`MenuOpenedEvent`，然后在 menuitem 上触发 `focus` 事件。	`AXMenuOpenedNotification`
菜单弹出项被隐藏（菜单被关闭）。	仅在可访问 menu 对象上触发一次 `EVENT_SYSTEM_MENUPOPUPEND`，且仅当已为其触发过 `EVENT_SYSTEM_MENUPOPUPSTART` 时。	`MenuClosedEvent`	`AXMenuClosedNotification`
所有打开的菜单（包括子菜单）都被关闭，且用户将焦点从 menubar 移走；menubar 被停用。	在 menubar 上触发 `EVENT_SYSTEM_MENUEND`，并停用 menubar。	`MenuClosedEvent`，然后触发 `MenuModeEndEvent`	`AXMenuClosedNotification`

某些 API 提供了需要遵循特定算法的方法。以下章节提供这些方法的算法映射表。

ARIANotifyMixin 提供了一种向辅助技术通告内容的方法。以下算法映射指定这些通告如何在不同的可访问性 API 中实现，以确保辅助技术用户获得一致的行为。

给定 node、announcement 和 priority，要执行 aria notify：

ARIA 规范	`aria notify`
前置条件	如果 `node` 被排除在可访问性树之外，则中止这些步骤。
语言	用户代理和辅助技术 MUST 通过从以下来源获取第一个有效的 BCP 47 语言标记来确定通告的语言： `node` 的最近祖先元素的 `lang` 属性（包括 `node` 本身）。文档元素的 `lang` 属性（包括在 document 上调用时）。用户代理或平台默认值。辅助技术 MUST 使用该语言呈现通告（例如语音、发音规则、盲文表）。
MSAA + IAccessible2	未指定实现（见回退注释）。
UIA	如果 `priority` 为 "high"，则令 `mapped_priority` 为 `NotificationProcessing_ImportantAll`，否则为 `NotificationProcessing_All`。使用 `node`、`NotificationKind_ActionCompleted`、 `mapped_priority`、`announcement` 和空字符串调用 `UiaRaiseNotificationEvent`。注如果平台可访问性实现确定 `node` 未在 UIA Control view 或 Content view 中表示，则用户代理 SHOULD 改为在被表示为 UIA Control 的最近祖先上触发通知事件。如果不存在这样的祖先，则用户代理 SHOULD 在文档根上触发该事件（预期它会在这些视图之一中），以确保忽略不在 Control 或 Content view 中的元素上的事件的辅助技术能够收到该通知。
ATK	如果 `priority` 为 "high"，则令 `mapped_priority` 为 `Atk.Live.ATK_LIVE_ASSERTIVE`，否则为 `Atk.Live.ATK_LIVE_POLITE`。使用 `node`、 `"notification"`、`announcement` 和 `mapped_priority` 调用 `g_signal_emit_by_name`。在 ATK 2.50.0 之前的较旧 Linux 可访问性栈上，用户代理 MAY 使用回退；见回退注释。
AT-SPI	如果 `priority` 为 "high"，则令 `mapped_priority` 为 `ATSPI_LIVE_ASSERTIVE`，否则为 `ATSPI_LIVE_POLITE`。使用 `node`、`"announcement"`、 `announcement` 和 `mapped_priority` 发送 DBUS 信号 `ATSPI_DBUS_INTERFACE_EVENT_OBJECT`。
AX API	如果 `priority` 为 "high"，则令 `mapped_priority` 为 `NSAccessibilityPriorityHigh`，否则为 `NSAccessibilityPriorityMedium`。令 `userInfo` 为带有以下键的 `NSDictionary`： `NSAccessibilityAnnouncementKey` 作为 `announcement` `NSAccessibilityPriorityKey` 作为 `mapped_priority` 使用 `node`、 `NSAccessibilityAnnouncementRequestedNotification` 和 `userInfo` 调用 `NSAccessibilityPostNotificationWithUserInfo`。

注

当没有合适的平台通知 API 可用时（例如，缺少较新 notification signal 的 ATK 2.50.0 之前的较旧 Linux 可访问性栈，或在 Windows 上用户代理无法使用 UIA 时），用户代理 MAY 在其可访问性树中合成一个临时的、仅面向辅助技术的实时区域，以传达 aria notify 通告。这类回退节点不会暴露给 Web 内容，也不能被 Web 内容检测到，并且此行为不是必需的。

根据 Web 平台设计原则，本规范不提供任何可通过编程方式确定信息是否正被辅助技术使用的接口。然而，本规范确实允许作者向辅助技术用户呈现与不使用辅助技术的用户可获得的信息不同的信息。与使用 Web 技术栈的许多其他部分一样，这可以通过 ARIA 和 CORE-AAM 规范的许多特性实现。这种内容差异可能被滥用来对辅助技术用户执行主动指纹识别。

本规范未引入新的安全考虑。

2022 年 11 月 14 日：为 colindextext/rowindextext 添加新的 AX API 映射
2024 年 1 月 4 日：修复：treegrid row 的错误计算角色
2023 年 10 月 31 日：更新 UIA aria-readonly 映射
2023 年 10 月 31 日：添加 aria-haspopup='grid' 映射
2023 年 10 月 31 日：更正 AXAPI 通知
2023 年 10 月 26 日：从 aria-describedby UIA 映射中移除 UIA_DescribedBy 属性
2023 年 10 月 12 日：使 haspopup='true' 映射与 haspopup='menu' 相同
2023 年 9 月 1 日：修复 AX API aria-haspopup 映射
2023 年 8 月 25 日：添加 role=image（img 的同义词）的映射
2023 年 8 月 17 日：为 computedrole 添加规范性预期和示例
2023 年 8 月 16 日：更新 aria-errormessage 的映射
2023 年 5 月 15 日：添加计算角色章节和映射
2023 年 5 月 8 日：更新 UIA ins/del
2023 年 4 月 13 日：添加 aria-braillelabel 和 aria-brailleroledescription 的映射
2023 年 4 月 9 日：更新注释角色 AXAPI 映射
2023 年 4 月 6 日：更新 aria-describedby 和 aria-description AXAPI
2023 年 4 月 6 日：更新 AXAPI 的 role='meter' subrole
2023 年 2 月 1 日：移除 AXAPI 特定的“group 中的 menuitem”指南
2023 年 2 月 1 日：更新 aria-keyshortcuts 的 AXAPI 映射
2023 年 2 月 1 日：更新 IA2 role='blockquote' 映射
2023 年 2 月 1 日：更新 paragraph 和 time 以及 caption 的 MSAA 映射

2022 年 11 月 1 日：起草隐私和安全章节
2022 年 10 月 13 日：修复：移除 label 和 legend
2022 年 10 月 12 日：移除 label 和 legend 的映射。
2021 年 4 月 5 日：更新 ATK 针对 aria-colindex、aria-colspan、aria-colcount、 aria-rowindex、aria-rowspan 和 aria-rowcount 的映射。
2020 年 4 月 6 日：更新 ATK 针对 alert 和 alertdialog 的映射。
2020 年 2 月 25 日：添加 comment、mark 和 suggestion 角色的映射。将 comment 纳入 aria-label 和组位置的计算。
2020 年 2 月 25 日：添加 aria-description 的映射。
2019 年 11 月 3 日：移除 AX API 的显式 AXRoleDescription 值。用户代理应遵循注释中描述的指南。
2019 年 10 月 22 日：为 AX API 添加 strong 和 emphasis 角色的映射。
2019 年 10 月 22 日：为 AX API 添加 code 角色的映射。
2019 年 10 月 21 日：为 ATK、IA2 和 UIA 添加 aria-colindextext 和 aria-rowindextext 角色的映射。
2019 年 10 月 21 日：为 ATK、IA2 和 UIA 添加 strong 和 emphasis 角色的映射。
2019 年 10 月 21 日：为 ATK、IA2 和 UIA 添加 code 角色的映射。
2019 年 9 月 18 日：更新 MSAA 针对 subscript 和 superscript 的映射
2019 年 9 月 10 日：添加 generic 角色的映射。
2019 年 7 月 9 日：添加 insertion 和 deletion 角色的映射。
2019 年 5 月 14 日：添加 legend 角色的映射。
2019 年 5 月 14 日：添加 label 角色的映射。
2019 年 5 月 14 日：添加 time 角色的映射。
2019 年 4 月 25 日：添加 subscript 和 superscript 角色的映射。
2019 年 2 月 25 日：添加 meter 角色的映射。
2019 年 2 月 5 日：更新 UIA 状态和属性更改事件。
2018 年 6 月 6 日：更新 UIA 针对 aria-placeholder 的映射。
2018 年 6 月 4 日：添加 blockquote、caption 和 paragraph 角色的映射。
2018 年 3 月 5 日：添加关于为 AXAPI 暴露渲染标签时使用 AXTitle 的说明。
2018 年 3 月 5 日：添加 aria-label、aria-labelledby 和 aria-describedby 的事件。

本节是非规范性的。

以下人员为本文档的开发做出了贡献。

Rahim Abdi (Apple Inc.)
NAVYA AGARWAL (Adobe)
Joey Arhar (Google LLC)
Benjamin Beaudry (Microsoft Corporation)
Curt Bellew (Oracle Corporation)
Zoë Bijl (W3C Invited Experts)
Gautier Chomel (EDRLab)
Aleksandar Cindrikj (Netcetera)
Keith Cirkel (Mozilla Foundation)
Daniel Clark (Microsoft Corporation)
Sydney Coleman (Google LLC)
James Craig (Apple Inc.)
Chris Cuellar (Bocoup)
Diego Della Rossa (UsableNet)
Joanmarie Diggs (Igalia)
Tamsin Ewing (W3C)
Mayuri Faldu (Navy Federal Credit Union)
Betsy Fanning (PDF Association)
Steve Faulkner (TetraLogical Services Ltd)
Patrick Foster (axes4 GmbH)
Jane Fulton (Cisco)
Bryan Garaventa (W3C Invited Experts)
Matt Garrish (DAISY Consortium)
Doug Geoffray (Microsoft Corporation)
Ariella Gilmore (IBM Corporation)
Taylore Givens (Microsoft Corporation)
David Grogan (Google LLC)
Shirisha Gubba (Google LLC)
Jon Gunderson (University of Illinois)
Oliver Habersetzer (SAP SE)
Sunny Hardasani (Adobe)
Matthew Hardy (Adobe)
Chris Harrelson (Google LLC)
Sarah Higley (Microsoft Corporation)
Hans Hillen (TPGi)
Isabel Holdsworth (TPGi)
Stanley Hon (Microsoft Corporation)
Michael Jackson (Microsoft Corporation)
Jilin Jiang (Ant Group Co., Ltd.)
Duff Johnson (PDF Association)
Summer Jones (Thomson Reuters Corp.)
Yuki Kamahori (Cybozu)
William Kilian (Kilian Codes LLC)
Matthew King (Meta)
Zachary Kinsey (TargetStream Technologies)
Daisuke Kobayashi (Cybozu)
Peter Krautzberger (krautzource UG)
Nina Krauß (SAP SE)
JaEun Jemma Ku (University of Illinois)
Joe Lamyman (TetraLogical Services Ltd)
Christopher Land (Oracle Corporation)
Charles LaPierre (Benetech)
Patrick Lauke (TetraLogical Services Ltd)
Philip Lazarevic (Level Access)
Leo Lee (Microsoft Corporation)
Brett Lewis (TPGi)
Alison Maher (Microsoft Corporation)
Gurpreet Kaur Mangera (Rakuten Group, Inc.)
Mark McCarthy (University of Illinois)
Eduardo Meza Etienne (Navy Federal Credit Union)
Clay Miller (Microsoft Corporation)
Hirotaka Minamida (Cybozu)
Daniel Montalvo (W3C)
Baldino Morelli (UsableNet)
Jacques Newman (Microsoft Corporation)
James Nurthen (Evinced Inc.)
Scott O'Hara (Microsoft Corporation)
Lola Odelola (W3C Invited Experts)
Neil Osman (Evinced Inc.)
Yusuke Oyama (Cybozu)
Adam Page (Hilton)
Michael Pennisi (Bocoup)
Giacomo Petri (UsableNet)
Noah Praskins (TPGi)
Lucas Radaelli (Google LLC)
Paul Rayius (PDFix-US)
Mark Rogers (Powermapper Software)
Priti Rohra (BarrierBreak Solutions Private Limited)
Adrian Roselli (W3C Invited Experts)
Marco Sabidussi (UsableNet)
Trisha Salas (Level Access)
Stefan Schnabel (SAP SE)
Harris Schneiderman (Deque Systems, Inc.)
Raymond Schwartz (Navy Federal Credit Union)
Davis Shaver (The Washington Post)
Cynthia Shelly (W3C Invited Experts)
Tzviya Siegman (W3C)
Avneesh Singh (DAISY Consortium)
Michael[tm] Smith (sideshowbarker) (W3C)
Francis Storr (Intel Corporation)
Nobukiyo Sugisaki (Cybozu)
Melanie Sumner (IBM Corporation)
Alexander Surkov (Igalia)
James Teh (Mozilla Foundation)
Roman Toda (Foxit software)
David Tseng (Google LLC)
Cybozu W3C (Cybozu)
Jan Williams (TPGi)
Peter Wyatt (PDF Association)
Valerie Young (Igalia)

本出版物部分由美国教育部、国家残障、独立生活与康复研究所（NIDILRR）的美国联邦资金资助，最初合同编号为 ED-OSE-10-C-0067，随后合同编号为 HHSP23301500054C，现在合同编号为 HHS75P00120P00168。本出版物的内容不一定反映美国教育部的观点或政策，提及商品名、商业产品或组织也不意味着美国政府认可。

[HTML-AAM]: HTML Accessibility API Mappings 1.0. Scott O'Hara; Rahim Abdi. W3C. 24 April 2026. W3C Working Draft. URL: https://www.w3.org/TR/html-aam-1.0/
[IAccessible2]: IAccessible2. Linux Foundation. URL: https://wiki.linuxfoundation.org/accessibility/iaccessible2/
[infra]: Infra Standard. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/
[RFC2119]: Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]: Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174
[wai-aria]: Accessible Rich Internet Applications (WAI-ARIA) 1.0. James Craig; Michael Cooper et al. W3C. 20 March 2014. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria/
[WAI-ARIA-1.2]: Accessible Rich Internet Applications (WAI-ARIA) 1.2. Joanmarie Diggs; James Nurthen; Michael Cooper; Carolyn MacLeod. W3C. 6 June 2023. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria-1.2/

[accname-1.2]: Accessible Name and Description Computation 1.2. Bryan Garaventa; Melanie Sumner. W3C. 24 April 2026. W3C Working Draft. URL: https://www.w3.org/TR/accname-1.2/
[Android-Accessibility-API]: Android Accessibility API. Google. URL: https://developer.android.com/guide/topics/ui/accessibility
[AT-SPI]: Assistive Technology Service Provider Interface. The GNOME Project. URL: https://gnome.pages.gitlab.gnome.org/at-spi2-core/libatspi/
[ATK]: ATK - Accessibility Toolkit. The GNOME Project. URL: https://developer.gnome.org/atk/stable/
[AXAPI]: The NSAccessibility Protocol for macOS. Apple, Inc. URL: https://developer.apple.com/documentation/appkit/nsaccessibility
[CORE-AAM-1.1]: Core Accessibility API Mappings 1.1. Joanmarie Diggs; Joseph Scheuhammer; Richard Schwerdtfeger; Michael Cooper; Andi Snow-Weaver; Aaron Leventhal. W3C. 14 December 2017. W3C Recommendation. URL: https://www.w3.org/TR/core-aam-1.1/
[dom]: DOM Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/
[UI-AUTOMATION]: UI Automation. Microsoft Corporation. URL: https://docs.microsoft.com/en-us/windows/win32/winauto/ui-automation-specification
[UIA-EXPRESS]: The IAccessibleEx Interface. Microsoft Corporation. URL: https://docs.microsoft.com/en-us/windows/win32/winauto/iaccessibleex
[WAI-ARIA-ROADMAP]: Roadmap for Accessible Rich Internet Applications (WAI-ARIA Roadmap). Richard Schwerdtfeger. W3C. 4 February 2008. W3C Working Draft. URL: https://www.w3.org/TR/wai-aria-roadmap/

核心可访问性 API 映射 1.2

摘要

本文档的状态

1. 介绍

1.1 可访问性 API

1.2 比较可访问性 API

1.2.1 ATK/AT-SPI

1.2.2 UIA（UI Automation）

1.2.3 Android 可访问性 API

1.2.4 可访问名称 和描述

2. 一致性

2.1 WAI-ARIA 中已弃用的特性

3. 将 WAI-ARIA 映射到可访问性 API

3.1 暴露 WAI-ARIA 语义的一般规则

3.2 原生标记语义与 WAI-ARIA 之间的冲突

3.3 暴露不直接映射到可访问性 API 属性的属性

3.4 角色映射

3.4.1 一般规则

3.4.2 计算角色

3.4.3 角色映射表

3.4.3.1 alert

3.4.3.2 alertdialog

3.4.3.3 application

3.4.3.4 article

3.4.3.5 banner

3.4.3.6 blockquote

3.4.3.7 button，其 aria-pressed 和 aria-haspopup 为默认值

3.4.3.8 button，其 aria-haspopup 为非 false 值

3.4.3.9 button，其 aria-pressed 具有已定义值

3.4.3.10 caption

3.4.3.11 cell

3.4.3.12 checkbox

3.4.3.13 code

3.4.3.14 columnheader

3.4.3.15 combobox

3.4.3.16 comment

3.4.3.17 complementary

3.4.3.18 contentinfo

3.4.3.19 definition

3.4.3.20 deletion

3.4.3.21 dialog

3.4.3.22 directory （已弃用）

3.4.3.23 document

3.4.3.24 emphasis

3.4.3.25 feed

3.4.3.26 figure

3.4.3.27 具有可访问 名称的 form

3.4.3.28 没有可访问 名称的 form

3.4.3.29 generic

3.4.3.30 grid

3.4.3.31 gridcell

3.4.3.32 group

3.4.3.33 heading

3.4.3.34 image

3.4.3.35 img

3.4.3.36 insertion

3.4.3.37 link

3.4.3.38 list

3.4.3.39 没有 combobox 可访问性父项的 listbox

3.4.3.40 具有 combobox 可访问性父项的 listbox

3.4.3.41 listitem

3.4.3.42 log

3.4.3.43 main

3.4.3.44 mark

3.4.3.45 marquee

3.4.3.46 math

3.4.3.47 menu

3.4.3.48 menubar

3.4.3.49 menuitem

3.4.3.50 menuitemcheckbox

3.4.3.51 menuitemradio

3.4.3.52 meter

3.4.3.53 navigation

3.4.3.54 none

3.4.3.55 note

3.4.3.56 不在 combobox 内部的 option

3.4.3.57 在 combobox 内部的 option

3.4.3.58 paragraph

3.4.3.59 presentation

3.4.3.60 progressbar

1.2.4 可访问名称和描述

3.4.3.1 `alert`

3.4.3.2 `alertdialog`

3.4.3.3 `application`

3.4.3.4 `article`

3.4.3.5 `banner`

3.4.3.6 `blockquote`

3.4.3.7 `button`，其 `aria-pressed` 和 `aria-haspopup` 为默认值

3.4.3.8 `button`，其 `aria-haspopup` 为非 `false` 值

3.4.3.9 `button`，其 `aria-pressed` 具有已定义值

3.4.3.10 `caption`

3.4.3.11 `cell`

3.4.3.12 `checkbox`

3.4.3.13 `code`

3.4.3.14 `columnheader`

3.4.3.15 `combobox`

3.4.3.16 `comment`

3.4.3.17 `complementary`

3.4.3.18 `contentinfo`

3.4.3.19 `definition`

3.4.3.20 `deletion`

3.4.3.21 `dialog`

3.4.3.22 `directory` （已弃用）

3.4.3.23 `document`

3.4.3.24 `emphasis`

3.4.3.25 `feed`

3.4.3.26 `figure`

3.4.3.27 具有可访问名称的 `form`

3.4.3.28 没有可访问名称的 `form`

3.4.3.29 `generic`

3.4.3.30 `grid`

3.4.3.31 `gridcell`

3.4.3.32 `group`

3.4.3.33 `heading`

3.4.3.34 `image`

3.4.3.35 `img`

3.4.3.36 `insertion`

3.4.3.37 `link`

3.4.3.38 `list`

3.4.3.39 没有 `combobox` 可访问性父项的 `listbox`

3.4.3.40 具有 `combobox` 可访问性父项的 `listbox`

3.4.3.41 `listitem`

3.4.3.42 `log`

3.4.3.43 `main`

3.4.3.44 `mark`

3.4.3.45 `marquee`

3.4.3.46 `math`

3.4.3.47 `menu`

3.4.3.48 `menubar`

3.4.3.49 `menuitem`

3.4.3.50 `menuitemcheckbox`

3.4.3.51 `menuitemradio`

3.4.3.52 `meter`

3.4.3.53 `navigation`

3.4.3.54 `none`

3.4.3.55 `note`

3.4.3.56 不在 `combobox` 内部的 `option`

3.4.3.57 在 `combobox` 内部的 `option`

3.4.3.58 `paragraph`

3.4.3.59 `presentation`

3.4.3.60 `progressbar`

3.4.3.61 `radio`

3.4.3.62 `radiogroup`

3.4.3.63 具有可访问名称的 `region`

3.4.3.64 没有可访问名称的 `region`

3.4.3.65 不在 `treegrid` 内部的 `row`

3.4.3.66 在 `treegrid` 内部的 `row`

3.4.3.67 `rowgroup`

3.4.3.68 `rowheader`

3.4.3.69 `scrollbar`

3.4.3.70 `search`

3.4.3.71 `searchbox`

3.4.3.72 `sectionfooter`

3.4.3.73 `sectionheader`

3.4.3.74 `separator` （不可聚焦）

3.4.3.75 `separator` （可聚焦）

3.4.3.76 `slider`

3.4.3.77 `spinbutton`

3.4.3.78 `status`

3.4.3.79 `strong`