HTML 可访问性 API 映射 1.0

W3C 工作草案

关于本文档的更多详细信息
此版本:
https://www.w3.org/TR/2026/WD-html-aam-1.0-20260430/
最新发布版本:
https://www.w3.org/TR/html-aam-1.0/
最新编辑草案:
https://w3c.github.io/html-aam/
历史:
https://www.w3.org/standards/history/html-aam-1.0/
提交历史
编辑:
Scott O'Hara (Microsoft)
Rahim Abdi (Apple)
前任编辑:
Steve Faulkner (TPGi)(至 2023 年 5 月)
Alexander Surkov (Mozilla Foundation)(至 2018 年 8 月)
Bogdan Brinza (Microsoft)(至 2018 年 7 月)
Jason Kiss (受邀专家) (至 2018 年 6 月)
Cynthia Shelly (Microsoft)(至 2013 年 9 月)
反馈:
GitHub w3c/html-aam (拉取 请求新建议题开放议题)

摘要

HTML 可访问性 API 映射(HTML-AAM)定义了 用户代理 如何将 HTML [HTML] 元素和属性映射到平台 可访问性应用程序编程 接口(API。它利用并扩展了 Core Accessibility API Mappings 1.2Accessible Name and Description Computation 1.2 以用于 HTML 宿主语言。记录这些 映射可促进由可访问性 API 实现的角色、状态、属性和事件的互操作暴露, 并有助于确保这些信息以符合作者意图的方式呈现。

HTML-AAM 是 WAI-ARIA 概述中所述的 WAI-ARIA 套件的一部分。

本文档的状态

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

注记

本文档如有变更,恕不另行通知。

本文档最初由 HTML 可访问性任务组在其批准下开发,该任务组是 协议和格式工作组HTML 工作 组的联合任务组。工作随后由继任工作组继续开展: 可访问富互联网应用工作组Web 应用工作组。本文档现在仅由 可访问富互联网 应用工作组维护。

本文档由 可访问富互联网 应用工作组作为 工作草案发布,并使用 推荐 标准轨道

发布为 工作草案并不意味着获得 W3C 及其成员的认可。

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

本文档由一个依据 W3C 专利 政策运作的工作组制作。 W3C 维护一份与该工作组 交付物相关的任何专利披露的公开列表; 该页面还包括 披露专利的说明。任何实际 知悉某项专利且认为该专利包含 必要权利要求的个人, 必须根据 W3C 专利政策第 6 节披露该信息。

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

1. 引言

本节是非规范性的。

本规范定义了 HTML 用户代理如何响应并暴露为 Web 内容提供的角色状态属性信息。 除非另有说明,具有默认 Accessible Rich Internet Applications (WAI-ARIA) 1.2 语义的 HTML 元素或属性,必须根据 Core Accessibility API Mappings 1.2 规范中定义的相关 WAI-ARIA 映射,暴露给平台可访问性 API

在某些情况下,通常是由于 HTML 宿主语言的特性, 或相关可访问性 API 的特性, 元素或属性的映射会不同于 [core-aam-1.2] 中指定的对应 ARIA 映射。 当 HTML 元素或属性没有任何默认 WAI-ARIA 语义时,每个平台可访问性 API 的适用映射 由本规范定义。

本文档还改编了 Accessible Name and Description Computation 1.2 规范,用于推导 [HTML] 元素的可访问名称可访问描述, 并为特定 HTML 元素和 特性提供可访问的实现示例。

用户通常使用辅助技术访问 HTML 内容, 这些辅助技术依赖平台可访问性 API 来获取并 与页面中的信息交互。本文档是以下可访问性 API 映射规范套件的一部分,这些规范用于由用户 代理渲染的内容:

1.1 可访问性 API

本文档涵盖的可访问性 API 包括:

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

有关可访问性 API 的更多信息,请参阅 Core Accessibility API Mappings 1.2第 1.1 节 可访问性 API

2. 一致性

除标记为非规范性的章节外,本规范中的所有编写指南、图示、示例和注记都是非规范性的。本规范中的其他所有内容都是规范性的。

本文档中的关键词 MAYMUSTMUST NOTSHOULD 应按照 BCP 14 [RFC2119] [RFC8174] 中的描述进行解释,但仅限于它们以本文所示的全 大写形式出现时。

规范性章节提供用户代理和辅助技术 MUST 遵循的要求,只有这样实现才符合本规范。

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

2.1 已弃用

目前没有已弃用的要求。

3. HTML 映射到可访问性 API

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

注记

WAI-ARIA 支持最初是在 [HTML5] 中引入 HTML 的。

用户代理MUST 以符合 Core Accessibility API Mappings 1.2暴露 WAI-ARIA 语义的一般规则的方式,将具有默认 WAI-ARIA 语义的 HTML 元素或 属性暴露给平台可访问性 API

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

当宿主语言是 [HTML] 时,用户代理 MUST 符合 Core Accessibility API Mappings 1.2 中的 原生标记语义与 WAI-ARIA 之间的冲突

3.3 暴露不直接映射到可访问性 APIHTML 特性

HTML 可以包含在发布时尚未由可访问性 API支持的特性。并非所有特性与 平台可访问性 API 之间都存在一一对应关系。当 HTML 角色、状态和属性不直接映射到某个 可访问性 API,且该 API 中有用于暴露文本字符串的方法时,用户代理 MUST 通过该方法暴露未定义的角色、状态和属性。

对于具有默认 WAI-ARIA 语义的 HTML 元素或属性,用户代理 MUST 符合 [core-aam-1.2] 中 暴露不直接映射到可访问性 API 属性的属性

3.4 暴露需要最低角色的 HTML 特性

最低角色 是一种等价的 WAI-ARIA 角色:如果某元素没有更具体的隐式角色或平台角色映射,例如 非 generic 角色,则该元素会映射到此角色。这有助于确保辅助技术用户针对常用且有效的 HTML 标记获得尽可能好的体验,而在其他情况下可能不会暴露 角色。

当以下所有条件都为真时,会提供最低角色:

HTML 属性状态和属性映射一节 标识了会要求元素映射 到最低角色的特定全局属性。

当满足这些条件时,用户代理 MUST 使用 CORE-AAM 中为指定最低角色定义的映射来暴露对象。如果元素指定了多个 要求将最低角色作为该元素的计算角色返回的属性,则优先采用 ARIA 分类体系中更具体的 角色。

3.5 HTML 元素角色映射

3.5.1 平台 API 映射要求

  • HTML 元素没有精确或 等价的映射可映射到有效的、非抽象的 WAI-ARIA 角色时,会指定一个唯一的 computedrole 字符串,作为互操作性测试用途的返回值。 例如,用户代理 MAY 以 "html-video" 作为 computedrole 来暴露 video 元素。 作者 MUST NOT 在 role 属性中使用任何以 html- 为前缀的计算角色字符串(例如 html-video)。用户代理 MUST 忽略任何抽象或 无效的角色标记。
    <video> <!-- computedrole 返回 'html-video' --> <main role="html-video"> <!-- 作者错误。计算角色返回 'main' -->
  • IAccessible2:
    • 所有具有可访问对象的元素 SHOULD 实现 IAccessible、IAccessible2 和 IAccessible2_2 接口。
  • UIA:
    • 可标记 元素label 元素的 for 属性引用,或作为 label 元素的后代时,该可标记 元素的 UIA LabeledBy 属性指向该 label 元素的 UIA 元素。
    • 映射到 Text 控件类型的元素通常不会在 可访问对象 中作为 可访问性 树中的对象表示,而只是作为为整个 HTML 文档实现的 Text 控件模式的一部分。但是,如果它们 具有任何 aria- 属性或指定了显式 tabindex,则映射到 Text 控件类型的元素将在 可访问对象 中作为 可访问性 树中的对象表示。
  • AXAPI:
    • 用户代理 SHOULD 为 Mac Accessibility AXRoleDescription 返回用户可呈现的本地化字符串 值。

3.5.3 a (无 href 属性)

HTML 规范 a (无 href 属性)
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.4 abbr

HTML 规范 abbr
[wai-aria-1.2] 无对应角色
计算角色
html-abbr
MSAA + IAccessible2
角色: ROLE_SYSTEM_TEXTIA2_ROLE_TEXT_FRAME
对象属性: 如果是单个子级,则在包含它的 td 上设置 "abbr" 属性, 文本内容用作值
UIA
控件类型: Text
[ATK]
角色: ATK_ROLE_STATIC
对象属性: 如果是单个子级,则在包含它的 td 上设置 "abbr" 属性, 文本内容用作值
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释

3.5.5 address

HTML 规范 address
[wai-aria-1.2] group 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.7 area (无 href 属性)

HTML 规范 area (无 href 属性)
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果作者为元素指定了交互行为,用户代理 MAY 仍可将缺少 href 属性的 a 元素以 link 角色暴露。例如,使用 事件 处理器属性时。

3.5.8 article

HTML 规范 article
[wai-aria-1.2] article 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.9 aside(限定作用域为 bodymain 元素)

HTML 规范 aside (限定作用域为 bodymain 元素)
[wai-aria-1.2] complementary 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.10 aside(限定作用域为分节内容 元素)

HTML 规范 aside (限定作用域为分节 内容元素)
[wai-aria-1.2] 如果 aside 元素具有 可访问名称,则为 complementary 角色。 否则,为 generic 角色。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.11 audio

HTML 规范 audio
[wai-aria-1.2] 无对应角色
计算角色
html-audio
MSAA + IAccessible2
角色: ROLE_SYSTEM_GROUPING
UIA
控件类型: Group
本地化控件类型: "audio"
注记:如果存在 controls 属性,则 UI 控件(例如播放、音量)会作为 audio 元素在可访问性 树中的子级暴露,并根据控件类型进行适当映射(例如 buttonslider)。
用户代理 MAY 将以下内容包含在可访问性 树中,并将它们标记为隐藏或屏幕外:
  • 加载消息或错误消息
  • 当前未显示的 UI 控件
[ATK]
角色: ATK_ROLE_AUDIO
AX
AXRole: AXGroup
AXSubrole: AXAudio
AXRoleDescription: "audio playback"
注记:如果存在 controls 属性,则 UI 控件(例如播放、音量)会作为一个 角色为 toolbar可访问 对象的后代暴露, 并根据控件类型进行适当映射(例如 buttonslider)。
注释

3.5.12 自治自定义元素

HTML 规范 自治 自定义元素
[wai-aria-1.2] 如果作者使用 role 属性分配了符合要求的 ARIA 角色,则映射 到该角色。否则,映射到 generic 角色。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.13 b

HTML 规范 b
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 通过平台特定的粗体字重文本样式暴露。

3.5.14 base

HTML 规范 base
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.15 bdi

HTML 规范 bdi
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 IA2/ATK:可能影响其文本容器上的 "writing-mode" 文本属性。

3.5.16 bdo

HTML 规范 bdo
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 IA2/ATK:作为其文本容器上的 "writing-mode" 文本属性暴露。

3.5.17 blockquote

HTML 规范 blockquote
[wai-aria-1.2] blockquote 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.18 body

HTML 规范 body
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果在 body 元素上指定了 aria-hidden 属性, 用户代理 MUST 忽略该属性。

3.5.19 br

HTML 规范 br
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 平台接口可能会将其作为 '\n' 字符暴露。

3.5.20 button

HTML 规范 button
[wai-aria-1.2] button 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果指定了 aria-pressedaria-haspopup 属性,button 的映射将会发生变化。

3.5.21 canvas

HTML 规范 canvas
[wai-aria-1.2] 无对应角色
计算角色
html-canvas
MSAA + IAccessible2
角色: ROLE_SYSTEM_GRAPHICIA2_ROLE_CANVAS
UIA
控件类型: Image
canvas 元素的后代会被 单独映射。
[ATK]
角色: ATK_ROLE_CANVAS
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: ""
注释

3.5.22 caption

HTML 规范 caption
[wai-aria-1.2] caption 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
关系: 与父级 table 之间存在 IA2_RELATION_LABEL_FOR
UIA
使用 WAI-ARIA 映射
其他属性: 父级 table 元素的 LabeledBy 属性指向 caption 元素的 UIA 元素。
[ATK]
使用 WAI-ARIA 映射
关系: 与父级 table 之间存在 ATK_RELATION_LABEL_FOR
AX
使用 WAI-ARIA 映射
关系: 与父级 table 之间存在 ATK_RELATION_LABEL_FOR
注释
注记

如果 caption 元素从 可访问性树中隐藏, 则它不会为其父级 table 元素提供可访问名称。

3.5.23 cite

HTML 规范 cite
[wai-aria-1.2] 无对应角色
计算角色
html-cite
MSAA + IAccessible2
无可访问对象。所使用的样式会映射为其文本容器 上的文本属性。
UIA
无可访问对象。所使用的样式会通过父级 可访问对象上实现的 TextRange 控件模式的 UIA 文本 属性暴露。
[ATK]
无可访问对象。所使用的样式会映射为其文本容器 上的文本属性。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释

3.5.24 code

HTML 规范 code
[wai-aria-1.2] code 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.25 col

HTML 规范 col
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.26 colgroup

HTML 规范 colgroup
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
角色: ROLE_SYSTEM_GROUPING
UIA
控件类型: Group
本地化控件类型: "colgroup"
[ATK]
未映射
AX
未映射
注释

3.5.27 data

HTML 规范 data
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.28 datalist(表示 input 元素的预定义选项)

HTML 规范 datalist (表示 input 元素的预定义选项)
[wai-aria-1.2] listbox 角色,并且如果 datalist 的选择模型允许一次选择多个 option 元素,则将 aria-multiselectable 属性设置为 "true", 否则设置为 "false"
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果 datalist 未链接到适当的 input 元素,则 datalist 元素不会映射到可访问性 API

3.5.29 dd

HTML 规范 dd
[wai-aria-1.2] definition 角色
计算角色
使用 WAI-ARIA 映射
注记
编辑注记:此值可能会在 ARIA #1662 解决后发生变化。
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.30 del

HTML 规范 del
[wai-aria-1.2] deletion 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.31 details

HTML 规范 details
[wai-aria-1.2] group 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
本地化控件类型:"details"
[ATK]
使用 WAI-ARIA 映射
关系:"ATK_RELATION_DETAILS_FOR"
AX
使用 WAI-ARIA 映射
注释

3.5.32 dfn

HTML 规范 dfn
[wai-aria-1.2] term 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.33 dialog

HTML 规范 dialog
[wai-aria-1.2] dialog 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 另请参阅 dialog 元素的 open 属性。

3.5.34 dir(已废弃)

HTML 规范 dir
[wai-aria-1.2] list 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
ATK
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 dir 元素在 HTML 中被标记为已废弃,并且作者不应使用。

3.5.35 div

HTML 规范 div
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.36 dl

HTML 规范 dl
[wai-aria-1.2] list 角色
计算角色
list
注记
编辑注记:此值可能会在 ARIA #1662 解决后发生变化。
MSAA + IAccessible2
角色: ROLE_SYSTEM_LIST
状态: STATE_SYSTEM_READONLY
UIA
控件类型: List
[ATK]
角色: ATK_ROLE_DESCRIPTION_LIST
AX
AXRole: AXList
AXSubrole: AXDefinitionList
AXRoleDescription: "definition list"
注释

3.5.37 dt

HTML 规范 dt
[wai-aria-1.2] term 角色
计算角色
使用 WAI-ARIA 映射
注记
编辑注记:此值可能会在 ARIA #1662 解决后发生变化。
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.38 em

HTML 规范 em
[wai-aria-1.2] emphasis 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.39 embed

HTML 规范 embed
[wai-aria-1.2] 无对应角色
计算角色
html-embed
MSAA + IAccessible2
角色: ROLE_SYSTEM_CLIENTIA2_ROLE_EMBEDDED_OBJECT
状态: 对于无窗口插件,为 STATE_SYSTEM_UNAVAILABLE
UIA
控件类型: Pane
[ATK]
角色: ATK_ROLE_EMBEDDED
AX 取决于数据文件的格式
注释

3.5.40 fieldset

HTML 规范 fieldset
[wai-aria-1.2] group 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
角色: 使用 WAI-ARIA 映射
关系: 与第一个已渲染的子 legend 元素之间存在 IA2_RELATION_LABELLED_BY
UIA
角色: 使用 WAI-ARIA 映射
[ATK]
角色: 使用 WAI-ARIA 映射
关系: 与第一个已渲染的子 legend 元素之间存在 ATK_RELATION_LABELLED_BY
AX
角色: 使用 WAI-ARIA 映射
AXSubrole: AXFieldset
AXDescription: 值来自第一个已渲染的子 legend 元素
注释
注记

如果 legend 元素从 可访问性树中隐藏, 则它不会为其父级 fieldset 元素提供可访问名称。

3.5.41 figcaption

HTML 规范 figcaption
[wai-aria-1.2] caption 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
角色: 使用 WAI-ARIA 映射
UIA
角色: 使用 WAI-ARIA 映射
[ATK]
角色: 使用 WAI-ARIA 映射
AX
角色: 使用 WAI-ARIA 映射
注释

3.5.42 figure

HTML 规范 figure
[wai-aria-1.2] figure 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
角色: 使用 WAI-ARIA 映射
UIA
角色: 使用 WAI-ARIA 映射
[ATK]
角色: 使用 WAI-ARIA 映射
AX
AXRole: 使用 WAI-ARIA 映射
注释

3.5.45 form

HTML 规范 form
[wai-aria-1.2] form 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
如果 form 没有可访问 名称
角色: ATK_ROLE_FORM
AX
使用 WAI-ARIA 映射
注释 如果 form 没有可访问名称,则不要将该元素作为地标暴露。

3.5.46 表单关联自定义 元素

HTML 规范 表单关联 自定义元素
[wai-aria-1.2] 如果作者使用 role 属性分配了符合要求的 ARIA 角色,则映射 到该角色。否则,映射到 generic 角色。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.47 h1, h2, h3, h4, h5, and h6

HTML 规范 h1, h2, h3, h4, h5, and h6
[wai-aria-1.2] heading 角色,并将 aria-level 属性设置为元素标签 名称中的数字。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.49 header(限定作用域为 body 元素)

HTML 规范 header (限定作用域为 body 元素)
[wai-aria-1.2] banner 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.50 header(限定作用域为 main 元素,或分节内容元素)

HTML 规范 header (限定作用域为 main 元素,或分节 内容元素)
[wai-aria-1.2] sectionheader 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
控件类型: Group
本地化控件类型: "header"
[ATK]
角色: ATK_ROLE_HEADER
AX
使用 WAI-ARIA 映射
注释 如果元素符合以下条件,用户代理和辅助技术 MAY 不暴露 sectionheader 角色:

3.5.51 hgroup

HTML 规范 hgroup
[wai-aria-1.2] group 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果一个 hgroup 包含多个标题元素,则用户代理 MAY 将具有最高优先级的标题元素 作为该 hgroup 的唯一标题来处理。用户代理 MAY 将所有其他标题元素暴露为如同它们是 p 元素。参见 Core AAM 上的 paragraph 角色

3.5.52 hr

HTML 规范 hr
[wai-aria-1.2] separator 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

如果 hr 元素是 select 元素的后代,用户 代理 MAYnone 角色暴露该元素。

3.5.53 html

HTML 规范 html
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

如果在 html 元素上指定了 aria-hidden 属性,用户代理 MUST 忽略该属性。

注记

网页的 document 角色不是由 html 元素暴露的,而是由用户代理创建的父级 document node 暴露的。

3.5.54 i

HTML 规范 i
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 通过平台特定的斜体文本样式暴露。

3.5.55 iframe

HTML 规范 iframe
[wai-aria-1.2] 无对应角色
计算角色
html-iframe
MSAA + IAccessible2
角色: IA2_ROLE_INTERNAL_FRAME
UIA
控件类型: Pane
[ATK]
角色: ATK_ROLE_INTERNAL_FRAME
AX
未映射
注释

3.5.56 img

HTML 规范 img
[wai-aria-1.2] imageimg 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释
注记

ARIA 1.3 添加了 image 角色,作为 ARIA 1.0 img 角色的首选同义词。具名 img 元素的预期计算角色现在是 "image"。

3.5.57 img alt 属性值在去除空白后为空 字符串,即 alt=""alt=" ",或标记中无值的 alt

HTML 规范 img alt 属性值在去除空白后为空 字符串,即 alt=""alt=" ", 或标记中无值的 alt
[wai-aria-1.2]
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释
注记

如果 img 具有空 alt,但已根据 本规范的命名步骤通过另一种有效命名机制提供了 可访问 名称,则用户代理将以其隐式 image 角色 暴露该元素。

3.5.58 input type 属性处于 Button 状态)

HTML 规范 input type 属性处于 Button 状态)
[wai-aria-1.2] button 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.59 input type 属性处于 Checkbox 状态)

HTML 规范 input type 属性处于 Checkbox 状态)
[wai-aria-1.2] checkbox 角色,并且如果元素的 aria-checked 状态在 indeterminate IDL 属性为 true 时设为 "mixed",或在元素的 选中性 为 true 时设为 "true",否则设为 "false"
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.60 input type 属性处于 Color 状态)

HTML 规范 input type 属性处于 Color 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-color
MSAA + IAccessible2
如果实现为文本框:
角色: ROLE_SYSTEM_TEXT
如果实现为颜色选择器:
角色: IA2_ROLE_COLOR_CHOOSER
UIA
如果实现为文本框:
控件类型: Edit
本地化控件类型: "edit"
如果实现为颜色选择器:
控件类型: button
本地化控件类型: "color picker"
[ATK]
如果实现为按钮,则对 button 使用 WAI-ARIA 映射。
如果实现为文本框,则对 textbox 使用 WAI-ARIA 映射。
AX
如果实现为文本框:
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
如果实现为颜色选择器:
AXRole: AXColorWell
AXSubrole: (nil)
AXRoleDescription: "color well"
注释
如果实现为颜色选择器,则为选择颜色而呈现的任何 UI 控件 会暴露在可访问性 树中,与 input 元素关联, 并根据控件类型进行适当映射(例如按钮或滑块)。

3.5.61 input type 属性处于 Date 状态)

HTML 规范 input type 属性处于 Date 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-date
MSAA + IAccessible2
如果实现为文本框:
角色: ROLE_SYSTEM_TEXT
对象属性: text-input-type:date
如果实现为日期选择器:
角色: IA2_ROLE_DATE_EDITOR
UIA
取决于实现的 UI 设计。例如,Windows 10 Edge 中的 UI 是多个微调器的组合。
[ATK]
角色: ATK_ROLE_CALENDAR
AX
AXRole: AXDateField
AXSubrole: (nil)
AXRoleDescription: "date field"
注释

3.5.62 input type 属性处于 Local Date and Time 状态)

HTML 规范 input type 属性处于 Local Date and Time 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-datetime-local
MSAA + IAccessible2
角色: IA2_ROLE_DATE_EDITOR
UIA
取决于实现的 UI 设计。例如,Windows 10 Edge 中的 UI 是多个微调器的组合。
[ATK]
角色: ATK_ROLE_CALENDAR
AX
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
注释

3.5.63 input type 属性处于 E-mail 状态且没有建议 来源元素)

HTML 规范 input type 属性处于 E-mail 状态且没有 建议 来源元素
[wai-aria-1.2] textbox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
对象属性: text-input-type:email
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.64 input type 属性处于 File Upload 状态)

HTML 规范 input type 属性处于 File Upload 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-file
MSAA + IAccessible2
取决于实现。如果表示为一个包含 按钮和文本标签的容器,则:
角色: IA2_ROLE_TEXT_FRAME
子级: 对于按钮和文本标签元素,分别为 ROLE_SYSTEM_PUSHBUTTONIA2_ROLE_LABEL
UIA
可以渲染为单个按钮控件,或渲染为 带有文本输入字段的按钮控件。
按钮控件:
控件类型: Button
文本输入字段:
控件类型: Edit
本地化控件类型: "file"
[ATK]
角色: ATK_ROLE_STATIC
子级: 按下时为 ATK_ROLE_PUSH_BUTTON,并显示 ATK_ROLE_FILE_CHOOSER 对话框
AX
AXRole: AXButton
AXSubrole: AXFileUploadButton
AXRoleDescription: file upload button
注释

3.5.65 input type 属性处于 Hidden 状态)

HTML 规范 input type 属性处于 Hidden 状态)
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.66 input type 属性处于 Image Button 状态)

HTML 规范 input type 属性处于 Image Button 状态)
[wai-aria-1.2] button 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.67 input type 属性处于 Month 状态)

HTML 规范 input type 属性处于 Month 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-month
MSAA + IAccessible2
角色: IA2_ROLE_DATE_EDITOR
UIA
取决于实现的 UI 设计。例如,Windows 10 Edge 中的 UI 是多个微调器的组合。
[ATK]
角色: ATK_ROLE_DATE_EDITOR
AX
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
注释

3.5.68 input type 属性处于 Number 状态)

HTML 规范 input type 属性处于 Number 状态)
[wai-aria-1.2] spinbutton 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
如果实现为微调按钮,则对 spinbutton 使用 WAI-ARIA 映射。
如果实现为文本输入,则对 textbox 使用 WAI-ARIA 映射。
对象属性: text-input-type:number
UIA
使用 WAI-ARIA 映射
[ATK]
如果实现为微调按钮,则对 spinbutton 使用 WAI-ARIA 映射。
如果实现为文本输入,则对 textbox 使用 WAI-ARIA 映射。
对象属性: text-input-type:number
AX
使用 WAI-ARIA 映射
注释

3.5.69 input type 属性处于 Password 状态)

HTML 规范 input type 属性处于 Password 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-password
MSAA + IAccessible2
角色: ROLE_SYSTEM_TEXT
状态: STATE_SYSTEM_PROTECTEDIA2_STATE_SINGLE_LINE; 如果 readonly,则为 STATE_SYSTEM_READONLY,否则为 IA2_STATE_EDITABLE
UIA
控件类型: Edit
其他属性: isPassword=true
[ATK]
角色: ATK_ROLE_PASSWORD_TEXT
状态: ATK_STATE_SINGLE_LINE;如果 readonly,则为 ATK_STATE_READ_ONLY, 否则为 ATK_STATE_EDITABLE
AX
AXRole: AXTextField
AXSubrole: AXSecureTextField
AXRoleDescription: "secure text field"
注释

3.5.70 input type 属性处于 Radio Button 状态)

HTML 规范 input type 属性处于 Radio Button 状态)
[wai-aria-1.2] radio 角色,并且如果元素的 aria-checked 状态在元素的 选中性 为 true 时设为 "true",否则设为 "false"。同时, aria-setsize 值反映 单选 按钮组type=radio input 元素的数量, 而 aria-posinset 值反映元素在 单选 按钮组中的位置。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.71 input type 属性处于 Range 状态)

HTML 规范 input type 属性处于 Range 状态)
[wai-aria-1.2] slider 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.72 input type 属性处于 Reset Button 状态)

HTML 规范 input type 属性处于 Reset Button 状态)
[wai-aria-1.2] button 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释
HTML 规范 input type 属性处于 Search 状态 且没有建议 来源元素
[wai-aria-1.2] searchbox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.74 inputtype 属性处于 Submit Button 状态)

HTML 规范 input type 属性处于 Submit Button 状态)
[wai-aria-1.2] button 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.75 inputtype 属性处于 Telephone 状态且没有建议来源 元素)

HTML 规范 input type 属性处于 Telephone 状态且没有 建议 来源元素
[wai-aria-1.2] textbox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
对象属性: text-input-type:telephone
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.76 inputtype 属性处于 Text 状态且没有建议来源元素)

HTML 规范 input type 属性处于 Text 状态且 没有建议 来源元素
[wai-aria-1.2] textbox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.77 inputtype 属性处于 Text、Search、Telephone、URL 或 E-mail 状态且具有建议来源元素)

HTML 规范 input type 属性处于 TextSearchTelephoneURLE-mail 状态且具有 建议 来源元素
[wai-aria-1.2] combobox 角色,并将 aria-controls 属性设置为与 list 属性相同的值
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
对象属性: text-input-type:按 input 类型
UIA
使用 WAI-ARIA 映射
其他属性: ControllerFor 指向建议来源元素
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.78 input type 属性处于 Time 状态)

HTML 规范 input type 属性处于 Time 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-time
MSAA + IAccessible2
角色: 如果实现为简单微件,则为 ROLE_SYSTEM_SPINBUTTON; 如果实现为复杂微件,则为 ROLE_SYSTEM_GROUPING, 并根据需要映射子控件
对象属性: text-input-type:time
UIA
取决于实现的 UI 设计。例如,Windows 10 Edge 中的 UI 是多个微调器的组合。
[ATK]

角色: 如果实现为简单微件,则为 ATK_ROLE_SPINBUTTON
如果实现为复杂微件,则使用:
角色: ROLE_PANEL,并根据需要映射子控件。

AX
AXRole: AXTimeField
AXSubrole: (nil)
AXRoleDescription: "time field"
注释

3.5.79 input type 属性处于 URL 状态且没有建议来源 元素)

HTML 规范 input type 属性处于 URL 状态且没有 建议 来源元素
[wai-aria-1.2] textbox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
对象属性: text-input-type:url
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.80 inputtype 属性处于 Week 状态)

HTML 规范 input type 属性处于 Week 状态)
[wai-aria-1.2] 无对应角色
计算角色
html-input-week
MSAA + IAccessible2
角色: IA2_ROLE_DATE_EDITOR
对象属性: text-input-type:week
UIA
取决于实现的 UI 设计。例如,Windows 10 Edge 中的 UI 是多个微调器的组合。
[ATK]
角色: ATK_ROLE_CALENDAR
AX
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
注释

3.5.81 ins

HTML 规范 ins
[wai-aria-1.2] insertion 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.82 kbd

HTML 规范 kbd
[wai-aria-1.2] 无对应角色
计算角色
html-kbd
MSAA + IAccessible2
无可访问对象。
文本属性: 在文本容器上设置 font-family:monospace
UIA
无可访问对象。所使用的样式通过父级 可访问对象上实现的 TextRange 控件模式的 UIA 文本属性 标识符暴露。
[ATK]
无可访问对象。映射为其文本容器上的 "font-family:monospace" 文本 属性。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释

3.5.83 label

HTML 规范 label
[wai-aria-1.2] 无对应角色
计算角色
html-label
MSAA + IAccessible2
角色: ROLE_SYSTEM_STATICTEXTIA2_ROLE_LABEL
关系: 与作为 label 子级或由 label 元素的 for 属性引用的可标记 元素之间存在 IA2_RELATION_LABEL_FOR。关联的可标记 元素具有指向 labelIA2_RELATION_LABELLED_BY
UIA
控件类型: Group
关系:
label 元素包含一个可标记 元素时,该元素的 LabeledBy 属性指向 label 元素的 UIA 元素。
label 元素具有引用某个for 属性引用的可标记 元素时,被引用元素的 LabeledBy 属性指向 label 元素的 UIA 元素。
[ATK]
角色: ATK_ROLE_LABEL
关系: 对于子可标记 元素或由 for 属性引用的可标记元素,存在 ATK_RELATION_LABEL_FOR。注意,相关的可标记 元素会提供指向 labelATK_RELATION_LABELLED_BY
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释
注记

如果 label 元素从 可访问性树中隐藏, 则它不会为与之关联的 可标记 元素提供可访问名称。

3.5.84 legend

HTML 规范 legend
[wai-aria-1.2] 无对应角色
计算角色
html-legend
MSAA + IAccessible2
角色: ROLE_SYSTEM_STATICTEXTIA2_ROLE_LABEL
关系: 与父级 fieldset 之间存在 IA2_RELATION_LABEL_FOR
UIA
控件类型: Text
其他属性: 父级 fieldsetLabeledBy 属性指向 legend 元素的 UIA 元素。
[ATK]
角色: ATK_ROLE_LABEL
关系: 与父级 fieldset 元素之间存在 ATK_RELATION_LABEL_FOR
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释

3.5.85 li

HTML 规范 li
[wai-aria-1.2] listitem 角色,并且 aria-setsize 值反映父级 olmenuulli 元素的数量,aria-posinset 值反映 li 元素在该集合中的位置。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果 li 元素不是 olmenuul 的子级, 或者包含它的列表元素不再以 list 角色暴露, 则以 generic 角色暴露该 li 元素。

3.5.87 main

HTML 规范 main
[wai-aria-1.2] main 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.88 map

HTML 规范 map
[wai-aria-1.2] 无对应角色
计算角色
html-map
MSAA + IAccessible2
如果用作图像映射,则不映射。否则,
角色: IA2_ROLE_TEXT_FRAME
UIA
未映射
[ATK]
如果用作图像映射,则不映射,否则:
角色: ATK_ROLE_STATIC
AX
角色: 如果用作图像映射,则为 AXImageMap。 否则,
角色: 如果与没有 altimg 关联,则为 AXGroup。否则,
如果未与 img 关联,则不映射。
注释

3.5.89 mark

HTML 规范 mark
[wai-aria-1.2] mark 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.90 math

HTML 规范 math
[wai-aria-1.2] 见注释
计算角色
见注释
MSAA + IAccessible2 见注释
UIA 见注释
[ATK] 见注释
AX 见注释
注释 math 的映射由 MathML AAM 1.0 定义。

3.5.92 meta

HTML 规范 meta
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.93 meter

HTML 规范 meter
[wai-aria-1.2] meter 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.95 noscript

HTML 规范 noscript
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.96 object

HTML 规范 object
[wai-aria-1.2] 无对应角色
计算角色
html-object
MSAA + IAccessible2
取决于数据文件的格式。如果其中包含插件,则:
角色: IA2_ROLE_EMBEDDED_OBJECT
状态: 对于无窗口插件,为 STATE_SYSTEM_UNAVAILABLE
UIA
取决于数据文件的格式。
[ATK]
取决于数据文件的格式。如果包含插件,则
角色: ATK_ROLE_EMBEDDED
AX 取决于数据文件的格式。
注释

3.5.97 ol

HTML 规范 ol
[wai-aria-1.2] list 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.98 optgroup

HTML 规范 optgroup
[wai-aria-1.2] group 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.99 option (位于 选项列表中或表示 datalist 中的建议)

HTML 规范 option (位于选项 列表中或表示 datalist 中的建议)
[wai-aria-1.2] option 角色,并且如果元素的 aria-selected 状态在元素的 选中性 为 true 时设为 "true",否则设为 "false"。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.100 output

HTML 规范 output
[wai-aria-1.2] status 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
关系: 与关联的 label 元素之间存在 IA2_RELATION_LABELLED_BY
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
关系: 与关联的 label 元素之间存在 ATK_RELATION_LABELLED_BY
AX
使用 WAI-ARIA 映射
注释 AXDescription:值来自关联的 label 元素子树。
未定义

3.5.101 p

HTML 规范 p
[wai-aria-1.2] paragraph 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.102 param

HTML 规范 param
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 paramHTML 中已废弃

3.5.103 picture

HTML 规范 picture
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.104 pre

HTML 规范 pre
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.105 progress

HTML 规范 progress
[wai-aria-1.2] progressbar 角色,并且如果进度条是确定的,则将 aria-valuemax 属性设置为进度条的最大值,将 aria-valuemin 属性设置为零,并将 aria-valuenow 属性设置为进度条的 当前值
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.106 q

HTML 规范 q
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 平台使用 ::before::after CSS 伪内容 来渲染该元素的引号。

3.5.107 rp

HTML 规范 rp
[wai-aria-1.2] 无对应角色
计算角色
html-rp
MSAA + IAccessible2
无可访问对象。如果浏览器支持 ruby,则不暴露子元素。
UIA
无可访问对象。
[ATK]
无可访问对象。如果浏览器支持 ruby,则不暴露子元素。
AX 未映射
注释

3.5.108 rt

HTML 规范 rt
[wai-aria-1.2] 无对应角色
计算角色
html-rt
MSAA + IAccessible2
无可访问对象。如果浏览器支持 ruby,则不暴露子元素。
UIA
无可访问对象。
[ATK]
无可访问对象。
AX
AXRole: AXGroup
AXSubrole: AXRubyText
AXRoleDescription: "group"
注释

3.5.109 ruby

HTML 规范 ruby
[wai-aria-1.2] 无对应角色
计算角色
html-ruby
MSAA + IAccessible2
角色: ROLE_SYSTEM_TEXTIA2_ROLE_TEXT_FRAME
UIA
控件类型: Text
本地化控件类型: "ruby"
[ATK]
角色: ATK_ROLE_STATIC
AX
AXRole: AXGroup
AXSubrole: AXRubyInline
AXRoleDescription: "group"
注释

3.5.110 s

HTML 规范 s
[wai-aria-1.2] deletion 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.111 samp

HTML 规范 samp
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.112 script

HTML 规范 script
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.114 section

HTML 规范 section
[wai-aria-1.2] 如果 section 元素具有可访问名称,则为 region 角色。否则,为 generic 角色。
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.115 select(具有 multiple 属性,或 size 属性 的值大于 1

HTML 规范 select (具有 multiple 属性,或 size 属性的 值大于 1
[wai-aria-1.2] listbox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.116 select(没有 multiple 属性,并且没有 size 属性的值大于 1

HTML 规范 select (没有 multiple 属性,并且没有 size 属性的 值大于 1
[wai-aria-1.2] combobox 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.117 slot

HTML 规范 slot
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.118 small

HTML 规范 small
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 通过平台特定的字体大小样式暴露。

3.5.119 source

HTML 规范 source
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.120 span

HTML 规范 span
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.121 strong

HTML 规范 strong
[wai-aria-1.2] strong 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.122 style

HTML 规范 style
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释
注记: 有些情况下,CSS 属性会影响可访问性 API 所暴露的内容。例如, display: nonevisibility: hidden 会将 一个元素 从可访问性 树中移除,并对辅助技术隐藏其存在。

3.5.123 sub

HTML 规范 sub
[wai-aria-1.2] subscript 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.124 summary

HTML 规范 summary
[wai-aria-1.2] 无对应角色
计算角色

如果该元素是父级 details 元素中其类型的第一个子元素:html-summary

否则,如果它不是父级 details 元素中其类型的第一个子元素,或不是 details 元素的子元素: generic 角色

MSAA + IAccessible2
角色: ROLE_SYSTEM_PUSHBUTTON
状态: STATE_SYSTEM_EXPANDED / STATE_SYSTEM_COLLAPSED
动作: expand / collapse
UIA
控件类型: Button
控件模式: ExpandCollapse
[ATK]
角色: ROLE_TOGGLE_BUTTON
关系: ATK_RELATION_DETAILS
AX
AXRole: AXDisclosureTriangle
AXSubrole: (nil)
AXRoleDescription: "disclosure triangle"
注释 如果 summary 元素不是 details 元素的子元素,或者 它不是父级 details 的第一个 summary 元素,则 用户代理 MUSTgeneric 角色暴露该 summary 元素。

3.5.125 sup

HTML 规范 sup
[wai-aria-1.2] superscript 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.126 svg

HTML 规范 svg
[wai-aria-1.2] 见注释
计算角色
见注释
MSAA + IAccessible2 见注释
UIA 见注释
[ATK] 见注释
AX 见注释
注释 svg 的映射由 SVG 可访问性 API 映射 定义。另请参阅 图形可访问性 API 角色映射

3.5.127 table

HTML 规范 table
[wai-aria-1.2] table 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
关系: 与第一个已渲染的子 caption 元素之间存在 IA2_RELATION_LABELLED_BY
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
关系: 与第一个已渲染的子 caption 元素之间存在 ATK_RELATION_LABELLED_BY
AX
使用 WAI-ARIA 映射
AXDescription: 值来自第一个 已渲染的子 caption 元素
注释

3.5.128 tbody

HTML 规范 tbody
[wai-aria-1.2] rowgroup 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2 使用 WAI-ARIA 映射
UIA 使用 WAI-ARIA 映射
[ATK] 使用 WAI-ARIA 映射
AX 使用 WAI-ARIA 映射
注释

3.5.129 td(祖先 table 元素 具有 table 角色)

HTML 规范 td (祖先 table 元素具有 table 角色)
[wai-aria-1.2] cell 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.130 td(祖先 table 元素具有 gridtreegrid 角色)

HTML 规范 td (祖先 table 元素具有 gridtreegrid 角色)
[wai-aria-1.2] gridcell 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.131 template

HTML 规范 template
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.132 textarea

HTML 规范 textarea
[wai-aria-1.2] textbox 角色,并将 aria-multiline 属性设置为 "true"
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.133 tfoot

HTML 规范 tfoot
[wai-aria-1.2] rowgroup 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.134 th (不是列 标头、行标头、列组标头或行组标头,并且祖先 table 元素具有 table 角色)

HTML 规范 th (不是列 标头行 标头列 组标头行 组标头,并且祖先 table 元素具有 table 角色)
[wai-aria-1.2] cell 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.135 th (不是列标头、行标头、列组 标头或行组标头,并且祖先 table 元素具有 gridtreegrid 角色)

HTML 规范 th (不是列 标头行 标头列 组标头行 组标头,并且祖先 table 元素具有 gridtreegrid 角色)
[wai-aria-1.2] gridcell 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.136 th (是列标头或列组标头)

HTML 规范 th (是列 标头列 组标头
[wai-aria-1.2] columnheader 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.137 th (是行标头或行组标头)

HTML 规范 th (是行 标头行 组标头
[wai-aria-1.2] rowheader 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.138 thead

HTML 规范 thead
[wai-aria-1.2] rowgroup 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.139 time

HTML 规范 time
[wai-aria-1.2] time 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.140 title

HTML 规范 title
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 title 元素为其文档提供可访问名称

3.5.141 tr

HTML 规范 tr
[wai-aria-1.2] row 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.142 track

HTML 规范 track
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.5.143 u

HTML 规范 u
[wai-aria-1.2] generic 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 通过平台特定的下划线文本样式暴露。

3.5.144 ul

HTML 规范 ul
[wai-aria-1.2] list 角色
计算角色
使用 WAI-ARIA 映射
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.5.145 var

HTML 规范 var
[wai-aria-1.2] 无对应角色
计算角色
html-var
MSAA + IAccessible2
无可访问对象。所使用的样式映射为其文本容器上的 文本属性。
UIA
无可访问对象。所使用的样式通过父级可访问对象上 实现的 TextRange 控件模式的 UIA 文本属性标识符暴露。
[ATK]
无可访问对象。所使用的样式映射为其文本容器上的 文本属性。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释

3.5.146 video

HTML 规范 video
[wai-aria-1.2] 无对应角色
计算角色
html-video
MSAA + IAccessible2
角色: ROLE_SYSTEM_GROUPING
UIA
控件类型: Group
本地化控件类型: "group"
注记: 如果存在 controls 属性,则 UI 控件(例如,播放、音量)作为 video 元素在可访问性 树中的子级暴露,并按控件类型适当地映射(例如, buttonslider)。
用户代理 MAY可访问性 树中包含以下内容,并将其标记为隐藏或屏幕外:
  • 加载消息或错误消息
  • 当前未显示的 UI 控件
[ATK]
角色: ATK_ROLE_VIDEO
AX
AXRole: AXGroup
AXSubrole: AXVideo
AXRoleDescription: "video playback"
注记: 如果存在 controls 属性,则 UI 控件(例如,播放、音量)作为具有 可访问对象(其角色为 toolbar) 的后代暴露,并按控件类型适当地映射(例如, buttonslider)。
注释

3.5.147 wbr

HTML 规范 wbr
[wai-aria-1.2] 无对应角色
计算角色
未映射
MSAA + IAccessible2
如果添加了换行,则在文本容器上通过 IAccessibleText 暴露
UIA
未映射
[ATK]
如果添加了换行,则通过其文本容器上的 Text 接口暴露
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
注释

3.6 HTML 属性状态和属性映射

3.6.1 abbr

HTML 规范 abbr
元素 th
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: "abbr",直到提供子 abbr 元素为止
UIA
未映射
[ATK]
对象属性: "abbr",直到提供子 abbr 元素为止
AX AXDescription: <value>
注释

3.6.2 accept

HTML 规范 accept
元素 input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.3 accept-charset

HTML 规范 accept-charset
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.4 accesskey

HTML 规范 accesskey
元素 HTML elements
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
可通过 accKeyboardShortcutIAccessibleAction::keyBinding 访问的按键绑定
UIA
属性: AccessKey: <value>
[ATK]
atk_action_get_keybinding
AX AXAccessKey: <value>
注释

3.6.5 action

HTML 规范 action
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.6 allow

HTML 规范 allow
元素 iframe
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.7 allowfullscreen

HTML 规范 allowfullscreen
元素 iframe
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.8 alt

HTML 规范 alt
元素 area; img; input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2 用于可访问 名称,通过 accName 暴露
UIA
属性: Name
[ATK]
用于可访问 名称,通过 atk_object_get_name 暴露
AX AXDescription: <value>
注释

3.6.9 as

HTML 规范 as
元素 link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.10 async

HTML 规范 async
元素 script
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.11 autocapitalize

HTML 规范 autocapitalize
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.12 autocomplete

HTML 规范 autocomplete
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释
注记

注记:aria-autocomplete 属性和 HTML autocomplete 属性具有不同的特性。aria-autocomplete 属性 不支持用于 HTML form 元素或具有显式 ARIA form 角色的元素。

注记

当用于 form 元素时,autocomplete 属性标识该表单拥有的表单控件是否会默认将其 自动填充 字段名称设置为 "on" 或 "off"。 请参阅 inputselecttextareaautocomplete 以了解控件映射。

3.6.13 autocomplete

HTML 规范 autocomplete
元素 input, selecttextarea
[WAI-ARIA-1.2]

如果指定了 autocomplete=off 或该控件由一个 autocomplete=offform 拥有 - aria-autocomplete=none

否则,为 aria-autocomplete

注记

注记:aria-autocomplete 属性和 HTML autocomplete 属性具有不同的特性,但它们 作为用户代理暴露该控件支持自动补全的 机制是重叠的。

MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

如果表单控件既被指定为 autocomplete=off (无论是因为显式使用该属性,还是从具有 autocomplete=off 的父 form 元素继承了 off 状态),又具有带有效值的 aria-autocomplete 属性,则用户代理 MUST 仅暴露 aria-autocomplete 属性值。

否则,如果表单控件具有一个用有效标记值指定的 autocomplete 属性, 并且具有 aria-autocomplete 属性,则用户 代理 MUST 仅暴露 autocomplete 属性值。

3.6.14 autofocus

HTML 规范 autofocus
元素 HTML 元素
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 提供 最小角色 group

3.6.15 autoplay

HTML 规范 autoplay
元素 audiovideo
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.16 blocking

HTML 规范 blocking
元素 link; script; style
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.17 charset

HTML 规范 charset
元素 meta
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.18 checked(如果存在)

HTML 规范 checked(如果存在)
元素 input type=checkboxtype=radio
[WAI-ARIA-1.2] aria-checked="true"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA 属性:Toggle.ToggleState: On (1)
[ATK]
使用 WAI-ARIA 映射
AX AXValue: 1
注释 如果处于 checkboxradio 状态的 input 元素同时包含 checked 属性和具有有效值的 aria-checked 属性,则用户代理 MUST 仅暴露 checked 属性值。

3.6.19 checked(如果不存在)

HTML 规范 checked(如果不存在)
元素 input type=checkboxtype=radio
[WAI-ARIA-1.2] aria-checked="false"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA 属性:Toggle.ToggleState: Off (0)
[ATK]
使用 WAI-ARIA 映射
AX AXValue: 0
注释 处于 checkboxradio 状态且没有 checked 属性的 input 元素具有隐式的 "false" 状态。用户代理 MUST 忽略与原生元素的隐式 checked 状态 冲突的 aria-checked 属性。

3.6.20 cite

HTML 规范 cite
元素 blockquote; delins; q
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX AXURL: <value>
注释

3.6.21 class

HTML 规范 class
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: class: <value>
UIA
属性: UIA_ClassNamePropertyId
[ATK]
对象属性: class: <value>
AX
属性: AXDOMClassList
注释

3.6.22 color

HTML 规范 color
元素 link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.23 cols

HTML 规范 cols
元素 textarea
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX AXRangeForLine: <value>
注释
未映射

3.6.24 colspan

HTML 规范 colspan
元素 tdth
[WAI-ARIA-1.2] aria-colspan
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.25 command (处于切换、显示和隐藏 popover 状态)

HTML 规范 command
元素 buttoncommand 处于 Toggle popover 状态 Show popover 状态Hide popover 状态
[WAI-ARIA-1.2]

如果关联元素显示为 popover: aria-expanded=true

如果关联元素被隐藏: aria-expanded=false

如果关联元素是具有 command 属性的元素的可访问性祖先,或不存在于 DOM 中: aria-expanded=undefined

如果关联元素不是有效的 popover 元素:没有 aria-expanded 映射。

MSAA + IAccessible2
使用 WAI-ARIA 映射
对象属性: details-roles:popover
UIA
使用 WAI-ARIA 映射
ATK
使用 WAI-ARIA 映射
对象属性: details-roles:popover
AX
使用 WAI-ARIA 映射
注释

用户代理 MUST 暴露与关联元素(通过指定的 commandfor 属性标识)之间的 aria-details 关系,除非处于以下情况:

  • 关联的 popover 元素是调用元素的下一个直接可访问性同级元素,
  • 该元素是它所关联的 popover 的后代。
注记

表示 提交 按钮的按钮,或具有 表单 拥有者且处于 reset 状态的按钮,不能调用命令。

3.6.26 command (处于 Close 和 Show Modal 状态)

HTML 规范 command
元素 button command 处于 Close 状态)和 Show Modal 状态
[WAI-ARIA-1.2]
处于 closeshow-modal 状态的 command 属性不会为 button 元素提供额外的可访问性映射。
MSAA + IAccessible2
未映射
UIA
未映射
ATK
未映射
AX
未映射
注释
注记

表示 提交 按钮的按钮,或具有 表单 拥有者且处于 reset 状态的按钮,不能调用命令。

3.6.27 commandfor

HTML 规范 commandfor
元素 button
[WAI-ARIA-1.2]
见注释
MSAA + IAccessible2
见注释
UIA
见注释
ATK
见注释
AX
见注释
注释

commandfor 属性标识 button 元素的关联元素。

指定的 command 状态将决定是否需要在 button 与其以编程方式关联的元素之间 暴露关系映射。

3.6.28 content

HTML 规范 content
元素 meta
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.29 contenteditable

HTML 规范 contenteditable
元素 HTML 元素
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2

如果该元素处于可编辑状态,则以下映射适用于该元素 和每个嵌套的可访问对象,但已被指定为 false 状态的对象除外。

状态: IA2_STATE_EDITABLEIA2_STATE_MULTI_LINE
接口: IAccessibleEditableText

如果该元素处于 false 状态:未映射。

如果该元素处于 inherit 状态:匹配其 父元素的可编辑状态。

UIA

如果该元素处于可编辑状态,则以下映射适用于该元素 和每个嵌套的可访问对象,但已被指定为 false 状态的对象除外。

控件模式: TextEdit
属性: AriaProperties.multiline:true

如果该元素处于 false 状态:未映射。

如果该元素处于 inherit 状态:匹配其 父元素的可编辑状态。

[ATK]

如果该元素处于可编辑状态,则以下映射适用于该元素 和每个嵌套的可访问对象,但已被指定为 false 状态的对象除外。

状态: ATK_STATE_EDITABLEATK_STATE_MULTI_LINE
接口: AtkEditableText

如果该元素处于 false 状态:未映射。

如果该元素处于 inherit 状态:匹配其 父元素的可编辑状态。

AX 角色: AXTextArea
使用 WAI-ARIA 映射
注释 如果元素被设置为 contenteditable,并且 aria-readonly="true",则用户代理 MUST 仅暴露 contenteditable 状态。

3.6.30 controls

HTML 规范 controls
元素 audiovideo
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX 控件暴露为 AXToolbar
注释

3.6.31 coords

HTML 规范 coords
元素 area
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
定义可访问对象的尺寸 (IAccessible::accLocation)
UIA
定义可访问对象的尺寸 (BoundingRectangle)
[ATK]
定义可访问对象的尺寸,通过 atk_component_get_positionatk_component_get_size 暴露
AX
定义可访问对象的尺寸,通过 Frame 属性暴露
注释

3.6.32 crossorigin

HTML 规范 crossorigin
元素 audio; img; link; script; video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.33 data

HTML 规范 data
元素 object
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.34 datetime

HTML 规范 datetime
元素 delins
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: datetime: <value>
UIA
未映射
[ATK]
对象属性: datetime: <value>
AX AXDateTimeValue: <value>
注释

3.6.35 datetime

HTML 规范 datetime
元素 time
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: datetime: <value>
UIA
属性: FullDescription: <value>
[ATK]
对象属性: datetime: <value>
AX AXDateTimeValue: <value>
注释

3.6.36 decoding

HTML 规范 decoding
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.37 default

HTML 规范 default
元素 track
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.38 defer

HTML 规范 defer
元素 script
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.39 dir

HTML 规范 dir
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
作为文本容器上的 "writing-mode" 文本属性暴露。
UIA
通过父级可访问对象上实现的 TextRange 控件模式的 TextFlowDirections 属性暴露。
[ATK]
作为文本容器上的 "writing-mode" 文本属性暴露。
AX
未映射
注释

3.6.40 dir

HTML 规范 dir
元素 bdo
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
作为文本容器上的 "writing-mode" 文本属性暴露。
UIA
通过父级可访问对象上实现的 TextRange 控件模式的 TextFlowDirections 属性暴露。
[ATK]
作为文本容器上的 "writing-mode" 文本属性暴露。
AX
未映射
注释

3.6.41 dirname

HTML 规范 dirname
元素 inputtextarea
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.42 disabled

HTML 规范 disabled
元素 button; input; optgroup; option; select; textarea; 表单关联的 自定义元素
[WAI-ARIA-1.2] aria-disabled="true"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果元素同时具有 disabled 属性和带有效值的 aria-disabled 属性,则用户代理 MUST 仅暴露 disabled 属性值。

3.6.43 disabled

HTML 规范 disabled
元素 fieldset
[WAI-ARIA-1.2] aria-disabled="true"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

具有 disabled 属性的 fieldset 中, 有效的 legend 子元素内的表单控件不会变为禁用。

如果元素同时具有 disabled 属性和带有效值的 aria-disabled 属性,则用户代理 MUST 仅暴露 disabled 属性值。

HTML 规范 disabled
元素 link
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2 未映射
UIA 未映射
[ATK] 未映射
AX 未映射
注释

3.6.45 download

HTML 规范 download
元素 aarea
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.46 draggable

HTML 规范 draggable
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: draggable:true
UIA
未映射
[ATK]
对象属性: draggable:true
AX
未映射
注释 提供 最小角色 group

3.6.47 enctype

HTML 规范 enctype
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.48 enterkeyhint

HTML 规范 enterkeyhint
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 修改要在虚拟键盘上为 enter 键呈现的动作标签(或图标)。

3.6.49 fetchpriority

HTML 规范 fetchpriority
元素 img; link; script
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.50 for

HTML 规范 for
元素 label
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
关系: IA2_RELATION_LABEL_FORIA2_RELATION_LABEL_BY 关系, 位于 label 和被引用的可标记 元素之间
UIA
label 元素具有引用另一个可标记 元素for 属性时,被引用 元素的 LabeledBy 属性指向 label 元素的 UIA 元素。
[ATK]
关系: ATK_RELATION_LABEL_FORATK_RELATION_LABEL_BY 关系, 位于 label 和被引用的可标记 元素之间
AX
注释

3.6.51 for

HTML 规范 for
元素 output
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
关系: 与该属性所指向的元素存在 IA2_RELATION_CONTROLLED_BY。 成对元素暴露 IA2_RELATION_CONTROLLER_FOR 关系。
UIA
未映射
[ATK]
关系: 与该属性所指向的元素存在 ATK_RELATION_CONTROLLED_BY。 成对元素暴露 ATK_RELATION_CONTROLLER_FOR 关系。
AX
未映射
注释

3.6.52 form

HTML 规范 form
元素 button; fieldset; input; label; object; output; select; textarea; 表单关联的 自定义元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.53 formaction

HTML 规范 formaction
元素 button; input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.54 formenctype

HTML 规范 formenctype
元素 button; input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.55 formmethod

HTML 规范 formmethod
元素 button; input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.56 formnovalidate

HTML 规范 formnovalidate
元素 button; input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.57 formtarget

HTML 规范 formtarget
元素 button; input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.58 headers

HTML 规范 headers
元素 td; th
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
将单元格链接到其标头单元格。通过 IAccessibleTableCell::rowHeaderCellsIAccessibleTableCell::columnHeaderCells 暴露。
UIA
将单元格链接到其标头单元格。通过 Table.ItemColumnHeaderItemsTable.ItemRowHeaderItems 暴露。
[ATK]
将单元格链接到其行标头和列 标头单元格(注意,由于 API 限制,只能暴露一个行标头单元格和一个列标头单元格)。参见 atk_table_get_row_headeratk_table_get_column_header
AX 通过 AXColumnHeaderUIElementsAXRowHeaderUIElements 暴露
注释

3.6.59 height

HTML 规范 height
元素 canvas; embed; iframe; img; input; object; source (在 picture 中); video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
定义可访问对象的高度 (IAccessible::accLocation)
UIA
定义可访问对象的高度 (BoundingRectangle)
[ATK]
定义可访问对象的高度 (atk_component_get_size)
AX
定义可访问对象的高度(AXSize 属性)
注释

3.6.60 hidden

HTML 规范 hidden
元素 HTML 元素
[WAI-ARIA-1.2] 如果该元素保留其用户代理默认样式 display: none,则为 aria-hidden="true"。 否则,如果没有使用其他隐藏内容的方法 (例如,visibility: hidden),则不映射。
MSAA + IAccessible2 使用 WAI-ARIA 映射
UIA 使用 WAI-ARIA 映射
[ATK] 使用 WAI-ARIA 映射
AX 使用 WAI-ARIA 映射
注释

3.6.61 high

HTML 规范 high
元素 meter
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
未映射
UIA RangeValue.Maximum
[ATK]
未映射
AX
未映射
注释

3.6.62 href

HTML 规范 href
元素 a; area
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
创建一个链接可访问对象。有关详细信息,请参阅 aarea 元素映射。
UIA 创建一个链接可访问对象。有关详细信息,请参阅 aarea 元素 映射。href 属性的值存储在 Value.Value UIA 属性中。
[ATK]
创建一个链接可访问对象。有关详细信息,请参阅 aarea 元素映射。
AX AXURL: <value>
注释
HTML 规范 href
元素 link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.64 hreflang

HTML 规范 hreflang
元素 a; link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.65 http-equiv

HTML 规范 http-equiv
元素 meta
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.66 id

HTML 规范 id
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: id: <value>
UIA
属性: UIA_AutomationIdPropertyId
[ATK]
对象属性: id: <value>
AX
属性: AXDOMIdentifier
注释

3.6.67 inert

HTML 规范 inert
元素 HTML 元素
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2 见注释
UIA 见注释
[ATK] 见注释
AX 见注释
注释

惰性 节点不会暴露给可访问性 API

注记

注记:惰性节点可以具有并非惰性的后代。例如, 模态 对话框 可以脱离惰性子树。

3.6.68 indeterminate [IDL]

HTML 规范 indeterminate [IDL]
元素 HTML 元素; input
[WAI-ARIA-1.2] aria-checked (state)="mixed"
MSAA + IAccessible2 使用 WAI-ARIA 映射
UIA 使用 WAI-ARIA 映射
[ATK] 使用 WAI-ARIA 映射
AX 使用 WAI-ARIA 映射
注释 如果元素设置了 indeterminate [IDL] 并且设置了 aria-checked 属性,则用户代理 MUST 仅暴露 indeterminate [IDL] 状态。

3.6.69 ismap

HTML 规范 ismap
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.70 itemid

HTML 规范 itemid
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.71 itemprop

HTML 规范 itemprop
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.72 itemref

HTML 规范 itemref
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.73 itemscope

HTML 规范 itemscope
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.74 itemtype

HTML 规范 itemtype
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.75 kind

HTML 规范 kind
元素 track
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2 未映射
UIA 未映射
[ATK] 未映射
AX 未映射
注释

3.6.76 label

HTML 规范 label
元素 optgroup; option; track
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
UIA label 属性的目标元素具有一个 LabeledBy 属性,该属性指向具有 label 属性的元素。参与 名称计算。
[ATK]
AX AXTitle: <value>
注释 另见:可访问名称 和描述:计算及 API 映射

3.6.77 lang

HTML 规范 lang
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
作为文本容器上的 "language" 文本属性暴露
UIA
lang 属性的值作为区域设置标识符暴露: 通过表示 HTML 元素的 UIA 元素的 Culture 属性,以及通过父级可访问对象上实现的 TextRange 控件模式的 Culture 属性暴露。
[ATK]
作为文本容器上的 "language" 文本属性暴露
AX AXLanguage: <value>
注释

3.6.78 list

HTML 规范 list
元素 input
[WAI-ARIA-1.2] aria-controls
MSAA + IAccessible2
IA2_RELATION_CONTROLLER_FOR 指向 list 属性的 IDREF 值所引用的 datalist 元素。
UIA
ControllerFor 指向 list 属性的 IDREF 值所引用的 datalist 元素。
[ATK]
ATK_RELATION_CONTROLLER_FOR 指向 list 属性的 IDREF 值所引用的 datalist 元素。
AX
属性:AXLinkedUIElements:指向 list 属性的 IDREF 值所引用的 datalist 元素。
注释 参见 datalistinput 元素映射。

3.6.79 loop

HTML 规范 loop
元素 audio; video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.80 low

HTML 规范 low
元素 meter
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
未映射
UIA
RangeValue.Minimum
[ATK]
未映射
AX
未映射
注释

3.6.81 max

HTML 规范 max
元素 input
[WAI-ARIA-1.2] aria-valuemax
MSAA + IAccessible2
如果该元素实现该接口,则作为 IAccessibleValue::maximumValue 暴露
UIA RangeValue.Maximum
[ATK]
如果该元素实现 AtkValue 接口,则作为 atk_value_get_maximum_value 暴露
AX AXMaxValue: <value>
注释

3.6.82 max

HTML 规范 max
元素 meter; progress
[WAI-ARIA-1.2] aria-valuemax
MSAA + IAccessible2
如果该元素实现该接口,则作为 IAccessibleValue::maximumValue 暴露
UIA RangeValue.Maximum
[ATK]
如果该元素实现 AtkValue 接口,则作为 atk_value_get_maximum_value 暴露
AX AXMaxValue: <value>
注释

3.6.83 maxlength

HTML 规范 maxlength
元素 input; textarea
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.84 media

HTML 规范 media
元素 link; meta; source (在 picture 中); style
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.85 method

HTML 规范 method
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.86 min

HTML 规范 min
元素 input
[WAI-ARIA-1.2] aria-valuemin
MSAA + IAccessible2
如果该元素实现该接口,则作为 IAccessibleValue::minimumValue 暴露
UIA RangeValue.Minimum
[ATK]
如果该元素实现 AtkValue 接口,则作为 atk_value_get_minimum_value 暴露
AX AXMinValue: <value>
注释

3.6.87 min

HTML 规范 min
元素 meter
[WAI-ARIA-1.2] aria-valuemin
MSAA + IAccessible2
如果该元素实现该接口,则作为 IAccessibleValue::minimumValue 暴露
UIA RangeValue.Minimum
[ATK]
如果该元素实现 AtkValue 接口,则作为 atk_value_get_minimum_value 暴露
AX AXMinValue: <value>
注释

3.6.88 minlength

HTML 规范 minlength
元素 input; textarea
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
状态: 如果值不满足指定的最小长度值,则为 IA2_STATE_INVALID_ENTRY
UIA
状态: 如果值不满足指定的最小长度值,则为 IsDataValidForForm
[ATK]
状态: 如果值不满足指定的最小长度值,则为 ATK_STATE_INVALID_ENTRY
AX
属性: 如果值不满足指定的最小长度值,则 AXInvalid: true
注释

3.6.89 multiple

HTML 规范 multiple
元素 input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.90 multiple

HTML 规范 multiple
元素 select
[WAI-ARIA-1.2] aria-multiselectable="true"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.91 muted

HTML 规范 muted
元素 audio; video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.92 name

HTML 规范 name
元素 button; fieldset; input; output; select; textarea; 表单关联的 自定义元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.93 name

HTML 规范 name
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.94 name

HTML 规范 name
元素 iframe; object
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.95 name

HTML 规范 name
元素 map
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.96 name

HTML 规范 name
元素 meta
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.97 name

HTML 规范 name
元素 slot
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.98 nomodule

HTML 规范 nomodule
元素 script
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.99 nonce

HTML 规范 nonce
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.100 novalidate

HTML 规范 novalidate
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.101 open

HTML 规范 open
元素 details
[WAI-ARIA-1.2] aria-expanded="true | false"
MSAA + IAccessible2 STATE_SYSTEM_EXPANDED
STATE_SYSTEM_COLLAPSED
UIA ExpandCollapsePattern
[ATK]
状态: ATK_STATE_COLLAPSEDATK_STATE_EXPANDED,取决于 属性值
AX AXExpanded: YES|NO
注释 summary 元素上设置属性。

3.6.102 open

HTML 规范 open
元素 dialog
[WAI-ARIA-1.2]
如果 open 属性是通过 showModal() 方法设置的, 则为 aria-modal="true"aria-hidden="false"
否则,如果 open 属性是通过 show() 方法设置的,或由作者显式指定,则为 aria-modal="false"aria-hidden="false"
MSAA + IAccessible2 使用 WAI-ARIA 映射
UIA 使用 WAI-ARIA 映射
[ATK] 使用 WAI-ARIA 映射
AX 使用 WAI-ARIA 映射
注释

open 属性的值无关紧要。当未指定 open 属性时,dialog 的默认用户代理样式为 display: none

作者可以通过样式层修改其 display 属性来显示 dialog。如果以这种方式显示,则该 dialogaria-modal="false"aria-hidden="false"

3.6.103 optimum

HTML 规范 optimum
元素 meter
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.104 pattern

HTML 规范 pattern
元素 input
[WAI-ARIA-1.2]
如果值与该模式不匹配:aria-invalid="true"; 否则, aria-invalid="false"
MSAA + IAccessible2 使用 WAI-ARIA 映射
UIA 使用 WAI-ARIA 映射
[ATK] 使用 WAI-ARIA 映射
AX 使用 WAI-ARIA 映射
注释

3.6.105 ping

HTML 规范 ping
元素 aarea
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.106 placeholder

HTML 规范 placeholder
元素 input; textarea
[WAI-ARIA-1.2] aria-placeholder
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释
placeholderaria-placeholder 属性 同时存在,并且 placeholder 属性的值非空时,用户 代理 MUST 暴露 placeholder 属性的值,并忽略 aria-placeholder。如果 placeholder 属性的值为空,则用户代理 MUST 暴露 aria-placeholder 属性的值。

3.6.107 playsinline

HTML 规范 playsinline
元素 video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.108 popover

HTML 规范 popover
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2 关系: IA2_RELATION_DETAILS_FOR 指向 调用元素。参见注释
对象属性: ispopup: <value>,其中 <value> 反映 popover 类型。
UIA 如果存在满足需要 details 关系条件的调用元素,则与该调用元素建立 details 关系。 参见注释
[ATK]

关系: RELATION_DETAILS_FOR 指向 调用元素。参见注释

对象属性: ispopup: <value>,其中 <value> 反映 popover 类型。
AX 待定
注释

在以下条件下,用户代理 MUST NOTpopover 与其调用元素之间暴露 details 关系:

  • popover 是调用元素的下一个直接可访问性同级元素时,
  • 当该元素具有 popovertargetaction=hide 属性值时,
  • 或当该元素是 popover 的后代,并且其 popovertarget 是 "auto" 状态时。

如果在具有 generic 隐式角色的元素上指定,则该 元素的角色改为映射到 group, 适用于所有 popover 状态

注记

不同的 popover 状态没有唯一映射。popover 元素的任何 可访问性映射变更都将由作者负责。例如,使用 不同的基础 HTML 元素、 属性或 ARIA 属性来进行此类变更。

3.6.109 popovertarget

HTML 规范 popovertarget
元素 button; input type=button, image, reset, submit
[WAI-ARIA-1.2]

如果关联元素显示为 popover: aria-expanded=true

如果关联元素被隐藏: aria-expanded=false

如果关联元素是具有 command 属性的元素的可访问性祖先,或不存在于 DOM 中: aria-expanded=undefined

如果关联元素不是有效的 popover 元素:没有 aria-expanded 映射。

MSAA + IAccessible2
使用 WAI-ARIA 映射
对象属性: details-roles:popover
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
对象属性: details-roles:popover
AX
使用 WAI-ARIA 映射
注释

用户代理 MUST 暴露与关联 popover 元素之间的 aria-details 关系,除非处于以下 条件:

  • 元素的 popovertargetaction 属性值为 "hide"
  • 关联的 popover 元素是调用元素的下一个直接可访问性同级元素,
  • 元素的隐式或显式 popovertargetaction 是 "auto" 状态,并且该元素是它所关联的 popover 的后代。
注记

表示具有 提交 按钮且具有 表单 拥有者的按钮,不能调用 popover。

3.6.110 popovertargetaction

HTML 规范 popovertargetaction
元素 button; input type=button, image, reset, submit
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 此属性的值可能影响其相关 popovertarget 属性的映射。

3.6.111 poster

HTML 规范 poster
元素 video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.112 preload

HTML 规范 preload
元素 audiovideo
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.113 readonly

HTML 规范 readonly
元素 input; textarea; 表单关联的 自定义元素
[WAI-ARIA-1.2] aria-readonly="true"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果元素同时包含 readonly 属性和具有有效值的 aria-readonly 属性,则用户代理 MUST 仅暴露 readonly 属性值。

3.6.114 referrerpolicy

HTML 规范 referrerpolicy
元素 a; area; iframe; img; link; script
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.115 rel

HTML 规范 rel
元素 a; area; link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.116 required

HTML 规范 required
元素 input; select; textarea
[WAI-ARIA-1.2] aria-required
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

如果元素同时包含 required 属性和具有有效值的 aria-required 属性,则用户代理 MUST 仅暴露 required 属性值。

如果元素是必填的, 用户代理 MUST NOT 以初始 invalid 状态(aria-invalid="true") 暴露该元素。 用户代理 SHOULD 仅在 1) 用户有意与必填元素交互,或 尝试提交表单,并且 2) 该元素或这些元素不满足约束 验证之后,才暴露 invalid 状态。

在满足这些条件之前,用户代理 MUST 将这些 元素暴露为(aria-invalid="false")。

3.6.117 reversed

HTML 规范 reversed
元素 ol
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
反转子列表项标记的数字或字母顺序。
UIA
反转子列表项标记的数字或字母顺序。
[ATK]
反转子列表项标记的数字或字母顺序。
AX
反转子列表项标记的数字或字母顺序。
注释

3.6.118 rows

HTML 规范 rows
元素 textarea
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.119 rowspan

HTML 规范 rowspan
元素 td; th
[WAI-ARIA-1.2] aria-rowspan
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.120 sandbox

HTML 规范 sandbox
元素 iframe
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.121 scope

HTML 规范 scope
元素 th
[WAI-ARIA-1.2]
如果 scope="row",则将 th 映射到 rowheader
如果 scope="col",则将 th 映射到 columnheader
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.122 selected

HTML 规范 selected
元素 option
[WAI-ARIA-1.2] aria-selected="true"
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 如果元素同时包含 selected 属性和具有有效值的 aria-selected 属性,则用户代理 MUST 仅暴露 selected 属性值。

3.6.123 shape

HTML 规范 shape
元素 area
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.124 size

HTML 规范 size
元素 input; select
[WAI-ARIA-1.2]
input 元素未映射。
如果大于 1,则创建 listbox 可访问对象。有关详细信息, 请参阅 select 元素。
MSAA + IAccessible2
input 元素未映射。
对于 select 元素,使用 WAI-ARIA 映射。
UIA
input 元素未映射。
对于 select 元素,使用 WAI-ARIA 映射。
[ATK]
input 元素未映射。
对于 select 元素,使用 WAI-ARIA 映射。
AX
input 元素未映射。
对于 select 元素,使用 WAI-ARIA 映射。
注释 对于允许 size 属性的 input 元素,该 属性将修改其默认宽度。由 CSS 提供的宽度会抵消 size 属性对这些 input 元素的影响。

3.6.125 sizes

HTML 规范 sizes
元素 link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.126 sizes

HTML 规范 sizes
元素 img; source
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.127 slot

HTML 规范 slot
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.128 span

HTML 规范 span
元素 col; colgroup
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
在该列的所有单元格上作为 IAccessibleTableCell::columnExtent 暴露
UIA
在该列的所有单元格上作为 GridItem.ColumnSpan 暴露
[ATK]
通过 atk_table_get_column_extent_at 暴露
AX
AXColumnIndexRange.length: <value>
注释

3.6.129 spellcheck

HTML 规范 spellcheck
元素 HTML 元素
[WAI-ARIA-1.2] aria-invalid="spelling"grammar
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.130 src

HTML 规范 src
元素 audio; embed; iframe; img; input; script; source (在 audiovideo 中); track; video
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
对象属性: 仅在 img 上为 src
UIA
未映射
[ATK]
对象属性: 仅在 img 上为 src
AX AXURL: <value>,在 imginput type="image"
注释

3.6.131 srcdoc

HTML 规范 srcdoc
元素 iframe
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.132 srclang

HTML 规范 srclang
元素 track
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.133 srcset

HTML 规范 srcset
元素 img; source
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.134 start

HTML 规范 start
元素 ol
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
更改子列表项可访问对象的第一个编号, 以匹配 start 属性的值。
UIA
更改子列表项可访问对象的第一个编号, 以匹配 start 属性的值。
[ATK]
更改子列表项可访问对象的第一个编号, 以匹配 start 属性的值。
AX
更改子列表项可访问对象的第一个编号, 以匹配 start 属性的值。
注释

3.6.135 step

HTML 规范 step
元素 input
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA 如果 input 处于 Range 状态,则将 RangeValue.SmallChangeRangeValue.LargeChange 都设置为 step 的值。
[ATK]
如果该元素实现 AtkValue 接口,则作为 atk_value_get_minimum_increment 暴露。
AX 未映射
注释

3.6.136 style

HTML 规范 style
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.137 tabindex

HTML 规范 tabindex
元素 HTML 元素
[WAI-ARIA-1.2] 参见焦点状态 与事件表
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.138 target

HTML 规范 target
元素 a; area
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.139 target

HTML 规范 target
元素 base
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.140 target

HTML 规范 target
元素 form
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.141 title

HTML 规范 title
元素 HTML 元素
[WAI-ARIA-1.2]
要么是可访问 名称,要么是可访问 描述,要么未 映射(见注释)。
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释
可访问名称和 描述计算一节规定 title 属性是否会被映射,如果会, 则通过什么 [WAI-ARIA] 属性映射。

3.6.142 title

HTML 规范 title
元素 abbr; dfn
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
UIA
[ATK]
AX AXExpandedTextValue: <value>
注释
HTML 规范 title
元素 link
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2 未映射
UIA 未映射
[ATK] 未映射
AX 未映射
注释

3.6.144 title

HTML 规范 title
元素 link; style
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释 提供 CSS 样式表的名称。

3.6.145 translate

HTML 规范 translate
元素 HTML 元素
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释
HTML 规范 type
元素 a; link
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.147 type

HTML 规范 type
元素 button
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
submit 类型可以是 表单中的默认按钮。
UIA
submit 类型可以是 表单中的默认按钮。
[ATK]
submit 类型可以是 表单中的默认按钮。
AX
submit 类型可以是 表单中的默认按钮。
注释

3.6.148 type

HTML 规范 type
元素 embed; object; script; source
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.149 type

HTML 规范 type
元素 input
[WAI-ARIA-1.2] 对于具有已定义 ARIA 角色的 input 类型,请参阅 WAI-ARIA 映射。
MSAA + IAccessible2
定义可访问角色、状态和其他属性,请参阅 type="text"type="password"type="button" 等。
UIA
定义可访问角色、状态和其他属性,请参阅 type="text"type="password"type="button" 等。
[ATK]
定义可访问角色、状态和其他属性,请参阅 type="text"type="password"type="button" 等。
AX
定义可访问角色、状态和其他属性,请参阅 type="text"type="password"type="button" 等。
注释

3.6.150 type

HTML 规范 type
元素 ol
[WAI-ARIA-1.2] 未映射
MSAA + IAccessible2
定义列表项标记,该标记没有可访问 对象,但作为内容暴露在关联列表项的可访问文本中。
接口: IAccessibleText2
UIA
定义列表项标记,该标记没有可访问 对象,但作为内容暴露在关联列表项的可访问文本中。
控件模式: Text
[ATK]
定义列表项标记,该标记没有可访问 对象,但作为内容暴露在关联列表项的可访问文本中。
接口: ATKText
AX
定义列表项标记,该标记作为内容暴露在 AXValue 中,并呈现为一个可访问 对象
AXRole: AXListMarker
AXSubrole: (nil)
AXRoleDescription: "list marker"
注释
一些平台(IAccessible2、ATK、UIA)不为列表项标记暴露可访问 对象,无论该对象是创建后又从 可访问性 树中修剪掉,还是一开始就没有创建。相反,它们将列表 项标记作为关联列表项可访问文本的一部分暴露。在 这些情况下,实现者需要考虑诸如为更新后的列表 项文本调整偏移量(例如,用于插入符移动事件、文本选择事件等),因为该文本现在 还包含列表项标记作为内容,而不能只是不加修改地采用列表项渲染器中的偏移量。

3.6.151 usemap

HTML 规范 usemap
元素 img
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
负责图像映射的创建。
UIA
负责图像映射的创建。
[ATK]
负责图像映射的创建。
AX
负责图像映射的创建。
注释 请参阅 img 元素。

3.6.152 value

HTML 规范 value
元素 button; option
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.153 value

HTML 规范 value
元素 data
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
[ATK]
未映射
AX
未映射
注释

3.6.154 value

HTML 规范 value
元素 input; input type=date; input type=datetime-local; input type=email; input type=month; input type=number; input type=password; input type=range input type=search; input type=tel; input type=text; input type=url; input type=week;
[WAI-ARIA-1.2] aria-valuenow
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.155 value

HTML 规范 value
元素 input type=button; input type=reset; input type=submit
[WAI-ARIA-1.2] 贡献给 input可访问名称
MSAA + IAccessible2
见注释
UIA
见注释
ATK
见注释
AX
见注释
注释 如果已指定,则该属性的值将是在 可访问 名称计算中用于处于 buttonresetsubmit 状态的 input 元素的宿主语言 标签

3.6.156 value

HTML 规范 value
元素 input type=checkbox; input type=hidden; input type=radio
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
未映射
UIA
未映射
ATK
未映射
AX
未映射
注释
注记

这些 input 状态的 value 属性不会 直接传达给用户。

3.6.157 value

HTML 规范 value
元素 input type=color
[WAI-ARIA-1.2] aria-valuenow & aria-valuetext
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
ATK
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释 用户代理 MAY 使用 value 属性的确切文本值,或使用指定文本的本地化变体, 以呈现颜色值的人类友好表示。

3.6.158 value

HTML 规范 value
元素 input type=image
[WAI-ARIA-1.2] 贡献给 input可访问名称
MSAA + IAccessible2
见注释
UIA
见注释
ATK
见注释
AX
见注释
注释 如果已指定,并且处于 image 状态的 input 没有 指定 alt 属性,则该属性的值将是在 宿主语言 标签中使用的 可访问 名称计算,并且如果图像来源 损坏,则会渲染为文本。否则,该属性被忽略。

3.6.159 value

HTML 规范 value
元素 li
[WAI-ARIA-1.2]
未映射
MSAA + IAccessible2
作为 li 的可访问对象的第一个文本节点暴露。
UIA
value 属性的值作为列表项中的第一个文本节点暴露。 如果 value 属性的值是整数,则将 UIA PositionInSet 属性设置为该 整数值。
[ATK]
作为 li 的可访问对象的第一个文本节点暴露。
AX
以具有可访问对象的 AXValue: <value> 形式 暴露:
AXRole: AXListMarker
AXSubrole: (nil)
AXRoleDescription: list marker
注释

3.6.160 value

HTML 规范 value
元素 meter; progress
[WAI-ARIA-1.2] aria-valuenow
MSAA + IAccessible2
使用 WAI-ARIA 映射
UIA
使用 WAI-ARIA 映射
[ATK]
使用 WAI-ARIA 映射
AX
使用 WAI-ARIA 映射
注释

3.6.161 width

HTML 명세 width
요소 canvas; embed; iframe; img; input; object; source (picture 안); video
[WAI-ARIA-1.2]
매핑되지 않음
MSAA + IAccessible2
접근 가능 객체의 너비를 정의함 (IAccessible::accLocation)
UIA
접근 가능 객체의 너비를 정의함 (BoundingRectangle)
[ATK]
접근 가능 객체의 너비를 정의함 (atk_component_get_size)
AX AXSize: w=n
주석

3.6.162 wrap

HTML 명세 wrap
요소 textarea
[WAI-ARIA-1.2]
매핑되지 않음
MSAA + IAccessible2
매핑되지 않음
UIA
매핑되지 않음
[ATK]
매핑되지 않음
AX
매핑되지 않음
주석

4. 접근 가능한 이름 및 설명 계산

접근 가능한 이름접근 가능한 설명이라는 용어는 모든 접근성 API에서 제공되는 프로퍼티이다. 프로퍼티 이름은 API마다 다를 수 있지만 같은 기능을 수행한다. 즉, 짧은 (이름) 또는 더 긴(설명) 텍스트 문자열의 컨테이너 역할을 한다.

텍스트 대체 계산접근 가능한 이름접근 가능한 설명을 모두 생성하는 데 사용된다. 여러 다른 유형의 요소, 노드, 그리고 마크업 조합에 대해 서로 다른 규칙이 제공된다.

참고

사용자 에이전트는 관련 접근성 정보가 변경될 때 보조 기술에 알린다. 때로는 접근성 객체를 파괴하고 다시 생성하는 방식으로, 때로는 지정된 이름 변경 이벤트 매핑설명 변경 이벤트 매핑에 따라 객체의 변경을 알리는 방식으로 처리한다.

4.1 HTML 요소별 접근 가능한 이름 계산

4.1.1 input type="text", input type="password", input type="number", input type="search", input type="tel", input type="email", input type="url"textarea 요소 접근 가능한 이름 계산

  1. 컨트롤에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있는 경우: 연결된 label 요소 서브트리의 텍스트 등가 계산을 사용한다. 둘 이상의 label이 연결되어 있으면, DOM 순서로 각 서브트리를 공백으로 구분하여 연결한다.

    컨트롤이 자신의 label 요소로 캡슐화되어 있는 경우, 컨트롤의 작성자 지정 값 또는 사용자가 입력한 값을 계산된 접근 가능한 이름에서 제외한다.

  3. 접근 가능한 이름이 여전히 비어 있는 경우: 컨트롤의 title 속성 값을 사용한다.
  4. 접근 가능한 이름이 여전히 비어 있는 경우: 컨트롤의 placeholder 속성 값을 사용한다.
  5. 그렇지 않으면, 요소의 aria-placeholder 속성 값을 사용한다.
  6. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.2 input type="button", input type="submit"input type="reset" 요소 접근 가능한 이름 계산

  1. 컨트롤에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있는 경우: 연결된 label 요소 서브트리의 텍스트 등가 계산을 사용한다. 둘 이상의 label이 연결되어 있으면, DOM 순서로 각 서브트리를 공백으로 구분하여 연결한다.

    컨트롤이 자신의 label 요소로 캡슐화되어 있고, 컨트롤에 작성자가 지정한 value가 있거나 value가 없어서 렌더링할 구현 정의 문자열이 생성된 경우, 둘 중 하나를 컨트롤의 계산된 접근 가능한 이름에서 제외한다.

  3. 접근 가능한 이름이 여전히 비어 있는 경우: 컨트롤의 value 속성 값을 사용한다.
  4. input type=submittype=reset의 경우: 접근 가능한 이름이 여전히 비어 있고 value 속성이 지정되지 않은 경우, input 타입에 각각 해당하는 구현 정의 문자열을 사용한다. 예를 들어, input 타입에 따라 "submit" 또는 "reset"이라는 단어의 지역화된 문자열이 될 수 있다.
  5. 그렇지 않으면: 컨트롤의 title 속성 값을 사용한다.
  6. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.3 input type="image" 요소 접근 가능한 이름 계산

  1. 컨트롤에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있는 경우: 연결된 label 요소 서브트리의 텍스트 등가 계산을 사용한다. 둘 이상의 label이 연결되어 있으면, DOM 순서로 각 서브트리를 공백으로 구분하여 연결한다.

    컨트롤이 자신의 label 요소로 캡슐화되어 있고 컨트롤에 alt 속성이 있는 경우, 해당 속성의 값을 컨트롤의 계산된 접근 가능한 이름에서 제외한다.

  3. 접근 가능한 이름이 여전히 비어 있는 경우: 컨트롤의 alt 속성이 존재하고 그 값이 공백을 제거했을 때 빈 문자열이 아니면 해당 값을 사용한다.
  4. 접근 가능한 이름이 여전히 비어 있는 경우: 컨트롤의 title 속성이 존재하고 그 값이 빈 문자열이 아니면 해당 값을 사용한다.
  5. 그렇지 않고 이전 단계들이 사용할 수 있는 텍스트 문자열을 산출하지 않으면: input 타입에 해당하는 구현 정의 문자열을 사용한다(image 상태의 inputsubmit button을 나타낸다). 예를 들어, "submit"이라는 단어 또는 "Submit Query"라는 단어들의 지역화된 문자열이 될 수 있다.
  6. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.4 button 요소 접근 가능한 이름 계산

  1. button 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있는 경우: 연결된 label 요소 서브트리의 텍스트 등가 계산을 사용한다. 둘 이상의 label이 연결되어 있으면, DOM 순서로 각 서브트리를 공백으로 구분하여 연결한다.

    button 요소가 자신의 label 요소로 캡슐화되어 있는 경우, button 요소의 서브트리를 계산된 접근 가능한 이름에서 무시한다.

  3. 접근 가능한 이름이 여전히 비어 있는 경우: 요소 서브트리의 텍스트 등가 계산을 사용한다.
  4. 그렇지 않으면: 요소의 title 속성 값을 사용한다.
  5. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.5 fieldset 요소 접근 가능한 이름 계산

  1. fieldset 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있으면: fieldset 요소에 legend 요소인 자식이 있는 경우, 그러한 첫 번째 요소의 서브트리를 사용한다.
  3. 접근 가능한 이름이 여전히 비어 있으면:, fieldset 요소에 title 속성이 있는 경우, 그 속성을 사용한다.
  4. 그렇지 않으면 접근 가능한 이름은 없다.

4.1.6 output 요소 접근 가능한 이름 계산

  1. output 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 연결된 label 요소 또는 요소들의 접근 가능한 이름을 사용한다. 둘 이상의 label이 연결되어 있으면 DOM 순서로 공백으로 구분하여 연결한다.
  3. 그렇지 않으면 title 속성을 사용한다.
  4. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.7 기타 form 요소 접근 가능한 이름 계산

  1. 컨트롤에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 label 요소를 사용한다.
  3. 그렇지 않으면 title 속성을 사용한다.
  4. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.8 summary 요소 접근 가능한 이름 계산

  1. details 요소의 직접 자식인 첫 번째 summary 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우, 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 summary 요소 서브트리를 사용한다.
  3. 그렇지 않으면 title 속성을 사용한다.
  4. details 요소의 직접 자식인 summary 요소가 없으면, 사용자 에이전트는 "details"라는 단어의 지역화된 문자열을 포함하는 서브트리를 가진 하나를 제공해야 SHOULD 한다.
  5. details 요소의 직접 자식인 summary 요소가 있지만, 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면, 접근 가능한 이름은 없다.

4.1.9 figure 요소 접근 가능한 이름 계산

figcaption은 부모 figure 요소와 관련된 추가 정보를 제공한다. figcaption은 작성자가 명시적으로 참조하지 않는 한 접근 가능한 이름 또는 접근 가능한 설명 계산에 참여하지 않는다.

  1. figure 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 title 속성을 사용한다.
  3. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.10 img 요소 접근 가능한 이름 계산

  1. img 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있는 경우: alt 속성을 사용한다. 그 값이 공백을 제거했을 때 빈 문자열이어도 사용한다.
    참고
    alt 속성이 있고 그 값이 공백을 제거했을 때 빈 문자열인 imgpresentation 역할로 매핑된다. 접근 가능한 이름은 없다.
  3. 접근 가능한 이름이 여전히 비어 있고 alt 속성이 없는 경우, title 속성을 사용한다.
  4. 접근 가능한 이름이 여전히 비어 있고 alt 또는 title 속성이 없으며, img가 자식 figcaption을 가진 figure 요소의 자손이지만 다른 비-공백 flow content 자손이 없는 경우, figcaption 요소 서브트리의 텍스트 등가 계산을 사용한다.
  5. 그렇지 않으면 접근 가능한 이름은 없다.

4.1.11 table 요소 접근 가능한 이름 계산

  1. table 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 접근 가능한 이름이 여전히 비어 있으면: table 요소에 caption 요소인 자식이 있는 경우, 그러한 첫 번째 요소의 서브트리를 사용한다.
  3. 접근 가능한 이름이 여전히 비어 있으면: table 요소에 title 속성이 있는 경우, 그 속성을 사용한다.
  4. 그렇지 않으면 접근 가능한 이름은 없다.

4.1.12 tr, td, th 요소 접근 가능한 이름 계산

  1. 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 title 속성을 사용한다.
  3. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.13 a 요소 접근 가능한 이름 계산

  1. a 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 a 요소 서브트리를 사용한다.
  3. 그렇지 않으면 title 속성을 사용한다.
  4. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.14 area 요소 접근 가능한 이름 계산

  1. area 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 area 요소의 alt 속성을 사용한다.
  3. 그렇지 않으면 title 속성을 사용한다.
  4. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.15 iframe 요소 접근 가능한 이름 계산

  1. 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 title 속성을 사용한다.
  3. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.
참고

iframe 요소의 src가 참조하는 문서는 다른 문서와 마찬가지로 해당 문서의 title 요소에서 이름을 얻는다. 제공된 title이 없으면 접근 가능한 이름은 없다.

4.1.16 섹션 및 그룹화 요소 접근 가능한 이름 계산

  1. 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 title 속성을 사용한다.
  3. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.1.17 텍스트 수준 요소 접근 가능한 이름 계산

abbr, b, bdi, bdo, br, cite, code, dfn, em, i, kbd, mark, q, rp, rt, ruby, s, samp, small, strong, subsup, time, u, var, wbr

  1. 요소에 aria-label 또는 aria-labelledby 속성이 있는 경우 접근 가능한 이름Accessible Name and Description: Computation and API Mappings에 정의된 알고리즘을 사용하여 계산되어야 한다.
  2. 그렇지 않으면 title 속성을 사용한다.
  3. 위 항목 중 어느 것도 사용할 수 있는 텍스트 문자열을 산출하지 않으면 접근 가능한 이름은 없다.

4.2 접근 가능한 설명 계산

작성자는 body 요소의 유효한 자식인 모든 HTML 요소에 대해 접근 가능한 설명을 제공할 MAY 있다. 다음 목록은 사용자 에이전트가 요소의 접근 가능한 설명을 계산할 때 적용하는 우선순위를 나타낸다. Accessible Name and Description Computation: Description Computation 에 정의된 것처럼, 사용자 에이전트MUST 그 사용 결과가 빈 설명이 되더라도 첫 번째로 적용 가능한 설명 출처를 사용해야 한다.

  1. 요소에 aria-describedby 또는 aria-description 속성이 있는 경우, Accessible Name and Description: Computation and API Mappings에 정의된 계산 조건을 참조하라.
  2. 그렇지 않고 접근 가능한 설명이 여전히 비어 있으며 요소가 다음 중 하나인 경우:
    • 자식 caption 요소를 가진 table 요소인 경우, 첫 번째 caption 요소의 서브트리에 대한 텍스트 등가 계산을 사용한다. 단, 그것이 접근 가능한 이름으로 사용되지 않았어야 한다.
    • summary 요소인 경우, 그 서브트리에 대한 텍스트 등가 계산을 사용한다. 단, 그것이 접근 가능한 이름으로 사용되지 않았어야 한다.
    • type 속성이 button, submit 또는 reset 상태인 input 요소이고, value 속성이 있는 경우, 해당 속성의 평탄 문자열을 사용한다. 단, 그것이 접근 가능한 이름으로 사용되지 않았어야 한다.
  3. 그렇지 않으면, title 속성이 해당 요소의 접근 가능한 이름으로 사용되지 않은 경우 그 속성의 평탄 문자열을 사용한다.
  4. 위 항목 중 어느 것도 적용할 수 없으면 접근 가능한 설명은 없다.

5. 隐私注意事项

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

6. 安全注意事项

本规范没有引入新的安全注意事项。

A. 附录

A.1 变更日志

查看本文档在 GitHub 上的提交历史

A.1.1 自迁移到 可访问富互联网应用工作组以来的实质性变更 (2019 年 11 月 03 日)

  • 2025 年 4 月 2 日:添加 commandcommandfor 属性映射。参见 GitHub ARIA PR 2354
  • 2024 年 7 月 11 日:用户代理会忽略 bodyhtml 元素上的 aria-hidden=true。参见 GitHub PR 516
  • 2024 年 6 月 06 日:添加最小角色的概念。参见 GitHub PR 454
  • 2024 年 6 月 06 日:添加 popoverpopovertargetpopovertargetaction 映射。参见 GitHub PR 481
  • 2023 年 10 月 09 日:确认在 select 元素中使用 hr 元素。参见 GitHub PR 504
  • 2023 年 10 月 03 日:更新图像映射,以引用主要同义角色(imagenone)。参见 GitHub PR 498
  • 2023 年 10 月 03 日:阐明何时将必填字段暴露为 invalid。参见 GitHub PR 429
  • 2023 年 6 月 06 日:为所有 HTML 元素添加计算角色。参见 GitHub PR 465
  • 2023 年 3 月 28 日:添加 inert 属性映射。参见 GitHub PR 410
  • 2023 年 3 月 24 日:添加 search 元素及其映射。参见 GitHub PR 355
  • 2023 年 3 月 08 日:更新 hgroup 元素,将其映射到 role=group。参见 GitHub PR 398
  • 2023 年 3 月 08 日:阐明 output 元素的命名算法。参见 GitHub PR 402
  • 2022 年 12 月 12 日:修订 s 元素映射为 role=deletion。参见 GitHub PR 442
  • 2022 年 11 月 28 日:简化可访问描述计算一节。参见 GitHub PR 444
  • 2022 年 7 月 19 日:更新 address 元素,将其映射到 role=group。参见 GitHub PR 420
  • 2022 年 4 月 03 日:根据 aside 的嵌套上下文更新其映射。参见 GitHub PR 350
  • 2022 年 3 月 06 日:更新以下元素,使其映射到 generic 角色: a no href、未限定到 bodyfooter、未限定到 bodyheadersampspan。参见 GitHub PR 364
  • 2022 年 2 月 06 日:更新 mark,使其指向 Core AAM 中该角色的映射。参见 GitHub Issue 316
  • 2021 年 11 月 02 日:将 blockquotecaptioncodedeleminsmeterparagraphstrongsubsuptime 更新到 Core AAM 中的 ARIA 1.2 映射。修正 body 映射到 generic,并修正 html 映射到 document。修正 hgroup 映射到 generic。更新 details,使其映射到 group,并带有特定于 ATK、UIA 的附加信息。参见 GitHub issue #348
  • 2021 年 5 月 12 日:向属性表添加 FACES 引用——readonlynameformdisabled。参见 Issue 257
  • 2019 年 12 月 12 日:添加 hgroupslot、自治自定义元素和表单 关联自定义元素。参见 GitHub issue #189
  • 2019 年 11 月 26 日:更新 disabledscopespellchecktabindex 的映射,使其指向 WAI-ARIA。添加 AX patternreversedrowssizespansrcstartsteptype 属性映射。添加 min-lengthpingplaysinlinereferrerpolicysizessrcsetdata[value] 属性映射。参见 GitHub pull request #245
自迁移到 Web 应用工作组(原 Web 平台工作组)以来的实质性变更 (2016 年 10 月 01 日)
  • 2019 年 9 月 30 日:移除 rbrtc 元素的映射,因为它们在 HTML 中被标记为过时。参见 GitHub issue #115pull request #253
  • 2019 年 9 月 23 日:更新 highlowmaxmin 以及 meterprogressvalue 属性映射。参见 GitHub pull request #244
  • 2019 年 9 月 18 日:更新 mark 元素的 UIA LocalizedControlType 和 AX AXRoleDescription。参见 GitHub issue #236
  • 2019 年 9 月 18 日:更新 summarydetails 元素的 ATK 映射。参见 GitHub issue #142GitHub issue #147
  • 2019 年 9 月 18 日:更新 MSAAsubsup 的映射。参见 GitHub pull request #252
  • 2019 年 9 月 11 日:更新 menu 的映射,以匹配 HTML Living Standard。移除不适用于 menumenuitem 的元素和属性映射。更新 menu 的映射到 role="list"。参见 GitHub issue #188
  • 2019 年 7 月 10 日:进一步更新 insdel 元素的映射。 参见 GitHub pull request #219
  • 2019 年 6 月 13 日:更新 insdel 元素的映射。参见 GitHub issue #141
  • 2019 年 6 月 10 日:更新未限定到 bodyheaderfooter 的 ATK 映射。参见 GitHub issue #129
  • 2019 年 5 月 21 日:更新 map 元素的 AXAPI 映射。添加 area 的可访问名称和描述计算。参见 GitHub issue #176
  • 2019 年 4 月 11 日:更新 subsup 元素的 UIA 映射。参见 Pull request #177
  • 2019 年 3 月 20 日:更新 supsub 元素的 IA2 映射。参见 GitHub issue #174
  • 2019 年 2 月 26 日:更新 address 元素的映射。参见 GitHub issue #170
  • 2019 年 2 月 19 日:将 placeholder 属性添加到各种 input 元素的可访问名称计算中。参见 GitHub issue #167
  • 2018 年 2 月 07 日:添加 rbrtc 元素条目,并 更新 rbrtruby 元素的 AXAPI 映射。参见 GitHub issue #115
  • 2018 年 2 月 07 日:更新 svg 元素的映射。参见 GitHub issue #43
  • 2018 年 2 月 07 日:更新 delins 元素以及 datetime 属性的 AXAPI 映射。
  • 2018 年 2 月 07 日:在适当情况下,使限定到 body 时的 headerfooterasideoutput 的映射与 CORE-AAM 保持一致。参见 GitHub issue #119
  • 2018 年 2 月 07 日:更新 input 元素上 multiple 属性的 ATK 和 AX 映射。参见 GitHub issue #96
  • 2018 年 2 月 07 日:更新 subsup 元素的 ATK 映射。 参见 GitHub issue #121
  • 2018 年 2 月 07 日:更新 body 元素的映射。参见 GitHub issue #117
  • 2018 年 2 月 01 日:更新 meter 元素的 IA2 映射。参见 GitHub issue #2
  • 2018 年 1 月 29 日:更新标题映射以反映实现。参见 GitHub issue #116
  • 2018 年 1 月 23 日:添加关于某些 CSS 属性影响的注记。参见 GitHub issue #234
  • 2018 年 1 月 23 日:更新 address 元素的映射。参见 GitHub issue #33
  • 2018 年 1 月 23 日:更新 dt 元素的映射。参见 GitHub issue #78
  • 2018 年 1 月 23 日:更新 mark 元素的 AXAPI 映射。
  • 2018 年 1 月 08 日:更新处于 Color 状态且带有 type 属性的 input 元素映射。参见 GitHub issue #48
  • 2018 年 1 月 06 日:更新 preqruby 元素,以及 input 元素的 multiple 属性的 IA2 映射。参见 GitHub issue #94
  • 2017 年 12 月 18 日:重写“介绍”中的第一段,以更好地反映 HTML-AAM 与 CORE-AAM 规范之间的关系。参见 GitHub issue #66
  • 2017 年 12 月 18 日:更新 readonly 属性,使其使用 aria-readonly="true" WAI-ARIA 映射。参见 GitHub issue #93
  • 2017 年 12 月 08 日:将 canvas 元素的 AXAPI 映射从 AXImage 改为 AXGroup
  • 2017 年 12 月 01 日:更新 dfn 元素的映射。参见 GitHub issue #6
  • 2017 年 11 月 30 日:更新 meter 元素的映射。参见 GitHub issue #2
  • 2017 年 11 月 24 日:更新 audiovideo 元素的映射。 参见 GitHub issue #80
  • 2017 年 11 月 23 日:更新 figure 元素映射,以反映 WAI-ARIA figure 角色映射
  • 2017 年 11 月 23 日:基于是否存在可访问名称更新 form 元素的映射。参见 GitHub issue #106
  • 2017 年 11 月 23 日:移除在 img 元素的 alt 属性为空时,要求可访问名称计算忽略该元素的 title 属性的要求。参见 GitHub issue #99
  • 2017 年 11 月 23 日:添加注记,说明除非元素也具有符合规范的 role 属性值,否则不要暴露 aria-roledescription。参见 GitHub issue #98
  • 2017 年 8 月 09 日:更新 ol 元素上 type 属性的映射。参见 GitHub issue #91
  • 2017 年 7 月 25 日:更新多个元素和属性的 UIA 映射。参见 GitHub issue #95GitHub pull request #101
  • 2017 年 6 月 02 日:更新 abbr 元素上 title 属性,以及 th 元素上 abbr 属性的 AXAPI 映射。参见 GitHub issue #16
  • 2017 年 5 月 31 日:更新 hidden 属性的映射。参见 GitHub issue #38
  • 2017 年 5 月 24 日:更新 selected 属性的映射。参见 GitHub issue #92
  • 2017 年 5 月 01 日:更新 time 元素的 AXAPI 映射。参见 GitHub issue #88
  • 2017 年 4 月 27 日:更新 langdir 属性的 UIA 映射。参见 GitHub issue #19
  • 2017 年 4 月 19 日:更新 colspanrowspan 属性的映射。 参见 GitHub issue #56issue #57
  • 2017 年 4 月 03 日:更新 section 元素的映射。参见 GitHub issue #79
  • 2016 年 12 月 23 日:如果 datalist 元素未与 input 元素关联,则没有映射。参见 GitHub issue #26
  • 2016 年 12 月 23 日:更新 list 属性的 IA2 映射。参见 GitHub issue #21
  • 2016 年 12 月 22 日:同步 footerheader 元素的映射。参见 GitHub issue #59
  • 2016 年 12 月 22 日:更新 input@type='date' 属性的 IA2 映射。参见 GitHub issue #61
  • 2016 年 12 月 22 日:更新 input@type='file' 元素的 IA2 映射。参见 GitHub issue #62
  • 2016 年 12 月 22 日:更新 summary 元素的 IA2 映射。参见 GitHub issue #64
  • 2016 年 12 月 14 日:更新措辞,以区分 headerfooter 元素何时是或不是 ARIA 地标。参见 GitHub issue #65
  • 2016 年 12 月 07 日:修改 datalistaria-multiselectable 映射, 以反映 listbox 选择模型。参见 GitHub issue #71
  • 2016 年 12 月 07 日:inputselect 元素上 multiple 属性的映射。参见 GitHub issue #72
  • 2016 年 11 月 27 日:添加 checkedcontenteditabledisabledindeterminate 属性的实现规则。
  • 2016 年 11 月 21 日:从各种 input 元素的可访问描述 计算中移除 placeholder 属性。

A.2 致谢

本节是非规范性的。

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

A.2.1 发布时的 ARIA WG 参与者

  • 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)

A.2.2 资助方

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

B. 参考文献

B.1 规范性参考文献

[accname-1.2]
Accessible Name and Description Computation 1.2. Bryan Garaventa; Melanie Sumner. W3C. 2026 年 4 月 24 日. W3C 工作草案. URL: https://www.w3.org/TR/accname-1.2/
[core-aam-1.2]
Core Accessibility API Mappings 1.2. Valerie Young; Cynthia Shelly. W3C. 2026 年 4 月 24 日. CRD. URL: https://www.w3.org/TR/core-aam-1.2/
[HTML]
HTML Standard. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/
[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. 1997 年 3 月. 最佳当前实践. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]
Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. 2017 年 5 月. 最佳当前实践. URL: https://www.rfc-editor.org/rfc/rfc8174
[svg-aam-1.0]
SVG Accessibility API Mappings. Cynthia Shelly; Mark Rogers. W3C. 2026 年 4 月 24 日. W3C 工作草案. URL: https://www.w3.org/TR/svg-aam-1.0/
[WAI-ARIA]
Accessible Rich Internet Applications (WAI-ARIA) 1.0. James Craig; Michael Cooper et al. W3C. 2014 年 3 月 20 日. W3C 推荐标准. 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. 2023 年 6 月 6 日. W3C 推荐标准. URL: https://www.w3.org/TR/wai-aria-1.2/

B.2 资料性参考文献

[AT-SPI]
Assistive Technology Service Provider Interface. GNOME 项目. URL: https://gnome.pages.gitlab.gnome.org/at-spi2-core/libatspi/
[ATK]
ATK - Accessibility Toolkit. GNOME 项目. URL: https://developer.gnome.org/atk/stable/
[AXAPI]
The NSAccessibility Protocol for macOS. Apple, Inc. URL: https://developer.apple.com/documentation/appkit/nsaccessibility
[dom]
DOM Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/
[HTML5]
HTML5. Ian Hickson; Robin Berjon; Steve Faulkner; Travis Leithead; Erika Doyle Navara; Theresa O'Connor; Silvia Pfeiffer. W3C. 2018 年 3 月 27 日. W3C 推荐标准. URL: https://www.w3.org/TR/html5/
[IAccessible2]
IAccessible2. Linux Foundation. URL: https://wiki.linuxfoundation.org/accessibility/iaccessible2/
[UI-AUTOMATION]
UI Automation. Microsoft Corporation. URL: https://docs.microsoft.com/en-us/windows/win32/winauto/ui-automation-specification