数字出版无障碍 API 映射 1.1

W3C 推荐标准

关于本文档的更多详细信息
此版本：
https://www.w3.org/TR/2025/REC-dpub-aam-1.1-20250612/
最新发布版本：
https://www.w3.org/TR/dpub-aam-1.1/
最新编辑草案：
https://w3c.github.io/dpub-aam/
历史：
https://www.w3.org/standards/history/dpub-aam-1.1/
提交历史
实现报告：
https://www.w3.org/2021/04/wpt-fyi-snapshot.html
编辑：
Matt Garrish (DAISY Consortium)
Tzviya Siegman (W3C)
前任编辑：
(Igalia, S.L.)
(Knowbility)
反馈：
GitHub w3c/dpub-aam (拉取请求， 新问题， 未解决问题)
public-aria@w3.org 主题行为 [dpub-aam-1.1] … 消息主题 …（存档）
勘误：
已有勘误。

另请参阅 翻译。

Copyright © 2015-2025 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.

摘要

数字出版无障碍 API 映射 (DPUB-AAM) 定义了 用户 代理 如何将数字出版 WAI-ARIA 模块 [dpub-aria-1.1] 标记映射到平台 无障碍 API。它面向在其用户代理中 负责无障碍的开发者，以便他们能够支持为数字出版生成的无障碍内容。

本文档状态

本节描述本文档在其 发布时的状态。当前 W3C 出版物列表以及本技术报告的最新修订版可在 位于 W3C 标准和草案 索引中找到，网址为 https://www.w3.org/TR/。

本规范的未来更新可能会纳入 新特性。

本文档由 无障碍富互联网 应用工作组 作为 推荐标准发布，使用 推荐标准轨道。

W3C 建议将本规范作为 Web 标准广泛部署。

W3C 推荐标准是一份规范，它在经过广泛 共识构建后，获得 W3C 及其成员认可，并且 由工作组成员承诺对实现提供 免版税许可。

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

本文档受 2023年11月3日 W3C 流程文档管辖。

1. 引言

本节为非规范性内容。

在用户代理中实现本规范，使作者能够通过向辅助技术传达数字出版 行业使用的结构化图书构造，来制作更具无障碍性的电子书。它通过扩展 核心无障碍 API 映射 1.1 [CORE-AAM-1.1] 和 无障碍名称和描述计算 1.2 [ACCNAME-1.2] 规范来服务于 用户代理。它为数字出版 WAI-ARIA 模块中定义的角色提供无障碍 API 映射指导。

DPUB-AAM 是 WAI-ARIA 套件的一部分，该套件在 WAI-ARIA 概述中描述。

2. 一致性

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

本文档中的关键词 MUST 和 SHOULD 应按照 BCP 14 [RFC2119] [RFC8174] 中的描述解释，当且仅当它们像此处所示那样以 全部大写形式出现时。

2.1 规范性和资料性 章节

一个章节是否为规范性或非规范性（资料性）的说明，适用于整个 章节，包括其子章节。

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

2.2 DPUB-ARIA 中已弃用的角色

DPUB-ARIA 规范 [dpub-aria-1.1] 将一些角色列为 已弃用。尽管这意味着鼓励作者不要使用这些角色，但预计这些 角色仍可能在旧有内容中 使用。因此，用户代理继续将这些角色映射到 无障碍 API 非常重要，并且这样做是 符合本规范的一部分。当未来 版本的 DPUB-ARIA 规范将此类角色从已弃用改为已移除时，它们也会被 从映射中移除，用户代理也将不再被要求继续 支持这些角色。

3. 支持键盘导航

在 Web 应用中启用键盘导航，是使无障碍 Web 应用成为可能的必要步骤。符合要求的 用户代理 MUST 符合 [CORE-AAM-1.1] 中的 支持键盘 导航要求。

4. 将 WAI-ARIA 映射到无障碍 API

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

本节 MUST 符合 [CORE-AAM-1.1] 中的 暴露 WAI-ARIA 语义的一般规则。

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

用户代理 MUST 符合 [CORE-AAM-1.1] 中的 原生标记语义 与 WAI-ARIA 之间的冲突。

6. 暴露不直接映射到无障碍 API 属性的属性

用户代理 MUST 符合 [CORE-AAM-1.1] 中的 暴露不直接 映射到无障碍 API 属性的属性。

7. 角色映射

平台 无障碍 API 传统上具有有限的一组 预定义 角色，这些角色是该 平台上的 辅助技术 所预期的，并且 可能只会暴露一个或两个角色。相比之下， WAI-ARIA 允许将多个角色指定为 一组按顺序排列、以空格分隔的有效角色标记。附加角色是 后备角色，类似于指定多个字体，以防首选字体类型不受 支持的概念。

7.1 一般规则

用户代理 MUST 符合 [CORE-AAM-1.1] 中角色映射 一般规则的无障碍 API 计算要求。

7.2 角色映射表

注

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

本节定义了 WAI-ARIA 数字 出版角色如何映射到平台无障碍 API。具有前缀值为 doc- 的角色、但未列在此 角色映射表中的元素，没有规范性映射。

7.2.1 doc-abstract

DPUB-ARIA 规范 doc-abstract
计算角色 doc-abstract
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_SECTION
  • 对象属性 xml-roles:doc-abstract。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'abstract'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-abstract。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "abstract" }

7.2.2 doc-acknowledgments

DPUB-ARIA 规范 doc-acknowledgments
计算角色 doc-acknowledgments
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-acknowledgments。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'acknowledgements'
  • 地标类型为 Custom
  • 本地化地标类型为 'acknowledgements'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-acknowledgments。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "acknowledgements" }

7.2.3 doc-afterword

DPUB-ARIA 规范 doc-afterword
计算角色 doc-afterword
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-afterword。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'afterword'
  • 地标类型为 Custom
  • 本地化地标类型为 'afterword'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-afterword。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "afterword" }

7.2.4 doc-appendix

DPUB-ARIA 规范 doc-appendix
计算角色 doc-appendix
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-appendix。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'appendix'
  • 地标类型为 Custom
  • 本地化地标类型为 'appendix'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-appendix。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "appendix" }

7.2.6 doc-biblioentry

DPUB-ARIA 规范 doc-biblioentry
计算角色 doc-biblioentry
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

ROLE_SYSTEM_LISTITEM + STATE_SYSTEM_READONLY

IAccessible2：

对象属性 xml-roles:doc-biblioentry。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'biblioentry'
ATK/AT-SPI 角色

暴露 ROLE_LIST_ITEM 和对象属性 xml-roles:doc-bilioentry。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: <nil>
  • AXRoleDescription: 'group'
  • AXCustomContent: {}

7.2.7 doc-bibliography

DPUB-ARIA 规范 doc-bibliography
计算角色 doc-bibliography
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-bibliography。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'bibliography'
  • 地标类型为 Custom
  • 本地化地标类型为 'biblography'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-bibliography。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "bibliography" }

7.2.8 doc-biblioref

DPUB-ARIA 规范 doc-biblioref
计算角色 doc-biblioref
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露
  • ROLE_SYSTEM_LINK + STATE_LINKED
  • 所有后代上的 STATE_LINKED

IAccessible2：

  • 对象属性 xml-roles:doc-biblioref。
  • AccessibleHypertext 接口
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'biblioref'
ATK/AT-SPI 角色

暴露 ROLE_LINK 和对象属性 xml-roles:doc-biblioref。

Mac AX API
  • AXRole: AXLink
  • AXSubrole: <nil>
  • AXRoleDescription: 'link'
  • AXCustomContent: { label: "type", value: "bibliography" }

7.2.9 doc-chapter

DPUB-ARIA 规范 doc-chapter
计算角色 doc-chapter
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-chapter。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'chapter'
  • 地标类型为 Custom
  • 本地化地标类型为 'chapter'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:chapter。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkChapter
  • AXRoleDescription: 'chapter'
  • AXCustomContent: {}

7.2.10 doc-colophon

DPUB-ARIA 规范 doc-colophon
计算角色 doc-colophon
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_SECTION

IAccessible2：对象属性 xml-roles:doc-colophon。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'colophon'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-colophon。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "colophon" }

7.2.11 doc-conclusion

DPUB-ARIA 规范 doc-conclusion
计算角色 doc-conclusion
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-conclusion。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'conclusion'
  • 地标类型为 Custom
  • 本地化地标类型为 'conclusion'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-conclusion。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "conclusion" }

7.2.12 doc-cover

DPUB-ARIA 规范 doc-cover
计算角色 doc-cover
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

ROLE_SYSTEM_GRAPHIC

IAccessible2：对象属性 xml-roles:doc-cover。
UIA 控件类型 + 其他特性 控件类型为 Image
ATK/AT-SPI 角色

暴露 ROLE_IMAGE 和对象属性 xml-roles:doc-cover。

Mac AX API
  • AXRole: AXImage
  • AXSubrole: <nil>
  • AXRoleDescription: 'cover image'
  • AXCustomContent: {}

7.2.13 doc-credit

DPUB-ARIA 规范 doc-credit
计算角色 doc-credit
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_SECTION

IAccessible2：

对象属性 xml-roles:doc-credit
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'credit'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-credit。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: {}

7.2.14 doc-credits

DPUB-ARIA 规范 doc-credits
计算角色 doc-credits
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-credits。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'credits'
  • 地标类型为 Custom
  • 本地化地标类型为 'credits'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-credits。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "credits" }

7.2.15 doc-dedication

DPUB-ARIA 规范 doc-dedication
计算角色 doc-dedication
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_SECTION

IAccessible2：

对象属性 xml-roles:doc-dedication
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'dedication'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-dedication。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "dedication" }

7.2.16 doc-endnote

DPUB-ARIA 规范 doc-endnote
计算角色 doc-endnote
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

ROLE_SYSTEM_LISTITEM + STATE_SYSTEM_READONLY

IAccessible2：

对象属性 xml-roles:doc-endnote。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'endnote'
ATK/AT-SPI 角色

暴露 ROLE_LIST_ITEM 和对象属性 xml-roles:doc-endnote。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: <nil>
  • AXRoleDescription: 'group'
  • AXCustomContent: {}

7.2.17 doc-endnotes

DPUB-ARIA 规范 doc-endnotes
计算角色 doc-endnotes
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-endnotes。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'endnotes'
  • 地标类型为 Custom
  • 本地化地标类型为 'endnotes'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-endnotes。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "end notes" }

7.2.18 doc-epigraph

DPUB-ARIA 规范 doc-epigraph
计算角色 doc-epigraph
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_SECTION

IAccessible2：

对象属性 xml-roles:doc-epigraph
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'epigraph'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-epigraph。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "epigraph" }

7.2.19 doc-epilogue

DPUB-ARIA 规范 doc-epilogue
计算角色 doc-epilogue
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-epilogue。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'epilogue'
  • 地标类型为 Custom
  • 本地化地标类型为 'epilogue'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-epilogue。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "epilog" }

7.2.20 doc-errata

DPUB-ARIA 规范 doc-errata
计算角色 doc-errata
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-errata
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'errata'
  • 地标类型为 Custom
  • 本地化地标类型为 'errata'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-errata。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "errata" }

7.2.21 doc-example

DPUB-ARIA 规范 doc-example
计算角色 doc-example
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_SECTION

IAccessible2：

对象属性 xml-roles:doc-example
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'example'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-example。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "example" }

7.2.22 doc-footnote

DPUB-ARIA 规范 doc-footnote
计算角色 doc-footnote
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性

暴露 IAccessible2：

  • IA2_ROLE_FOOTNOTE
  • 对象属性：xml-roles:doc-footnote
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'footnote'
ATK/AT-SPI 角色

暴露 ROLE_FOOTNOTE 和对象属性 xml-roles:doc-footnote。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "footnote" }

7.2.23 doc-foreword

DPUB-ARIA 规范 doc-foreword
计算角色 doc-foreword
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-foreword
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'foreword'
  • 地标类型为 Custom
  • 本地化地标类型为 'foreword'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-foreword。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "foreword" }

7.2.24 doc-glossary

DPUB-ARIA 规范 doc-glossary
计算角色 doc-glossary
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-glossary
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'glossary'
  • 地标类型为 Custom
  • 本地化地标类型为 'glossary'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-glossary。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "glossary" }

7.2.25 doc-glossref

DPUB-ARIA 规范 doc-glossref
计算角色 doc-glossref
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露
  • ROLE_SYSTEM_LINK + STATE_LINKED
  • 所有后代上的 STATE_LINKED

IAccessible2：

  • 对象属性 xml-roles:doc-glossref。
  • AccessibleHypertext 接口
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'glossref'
ATK/AT-SPI 角色

暴露 ROLE_LINK 和对象属性 xml-roles:doc-glossref。

Mac AX API
  • AXRole: AXLink
  • AXSubrole: <nil>
  • AXRoleDescription: 'link'
  • AXCustomContent: { label: "type", value: "glossary" }

7.2.26 doc-index

DPUB-ARIA 规范 doc-index
计算角色 doc-index
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-index
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'index'
  • 地标类型为 Custom
  • 本地化地标类型为 'index'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-index。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkNavigation
  • AXRoleDescription: 'navigation'
  • AXCustomContent: { label: "type", value: "index" }

7.2.27 doc-introduction

DPUB-ARIA 规范 doc-introduction
计算角色 doc-introduction
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-introduction
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'introduction'
  • 地标类型为 Custom
  • 本地化地标类型为 'introduction'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-introduction。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "introduction" }

7.2.28 doc-noteref

DPUB-ARIA 规范 doc-noteref
计算角色 doc-noteref
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露
  • ROLE_SYSTEM_LINK + STATE_LINKED
  • 所有后代上的 STATE_LINKED

IAccessible2：

  • 对象属性 xml-roles:doc-noteref。
  • AccessibleHypertext 接口
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'noteref'
ATK/AT-SPI 角色

暴露 ROLE_LINK 和对象属性 xml-roles:doc-noteref。

Mac AX API
  • AXRole: AXLink
  • AXSubrole: <nil>
  • AXRoleDescription: 'link'
  • AXCustomContent: { label: "type", value: "note" }

7.2.29 doc-notice

DPUB-ARIA 规范 doc-notice
计算角色 doc-notice
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_NOTE

IAccessible2：

对象属性 xml-roles:doc-notice。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'notice'
ATK/AT-SPI 角色

暴露 ROLE_COMMENT 和对象属性 xml-roles:doc-notice。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXDocumentNote
  • AXRoleDescription: 'note'
  • AXCustomContent: {}

7.2.30 doc-pagebreak

DPUB-ARIA 规范 doc-pagebreak
计算角色 doc-pagebreak
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

ROLE_SYSTEM_SEPARATOR

IAccessible2：

对象属性 xml-roles:doc-pagebreak。
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'pagebreak'
ATK/AT-SPI 角色

暴露 ROLE_SEPARATOR 和对象属性 xml-roles:doc-pagebreak。

Mac AX API
  • AXRole: AXSplitter
  • AXSubrole: <nil>
  • AXRoleDescription: 'splitter'
  • AXCustomContent: { label: "type", value: "page break" }

7.2.32 doc-pageheader

DPUB-ARIA 规范 doc-pageheader
计算角色 doc-pageheader
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_HEADER
  • 对象属性 xml-roles:doc-pageheader
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 控件模式：Annotation
  • Annotation.AnnotationTypeId：Header
ATK/AT-SPI 角色 暴露

ROLE_HEADER 和对象属性 xml-roles:doc-pageheader。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: <nil>
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "header" }

7.2.33 doc-pagelist

DPUB-ARIA 规范 doc-pagelist
计算角色 doc-pagelist
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-pagelist
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'pagelist'
  • 地标类型为 Custom
  • 本地化地标类型为 'pagelist'
ATK/AT-SPI 角色 暴露

ROLE_LANDMARK 和对象属性 xml-roles:doc-pagelist。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkNavigation
  • AXRoleDescription: 'navigation'
  • AXCustomContent: { label: "type", value: "page list" }

7.2.34 doc-part

DPUB-ARIA 规范 doc-part
计算角色 doc-part
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-part
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'part'
  • 地标类型为 Custom
  • 本地化地标类型为 'part'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-part。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "part" }

7.2.35 doc-preface

DPUB-ARIA 规范 doc-preface
计算角色 doc-preface
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARKi
  • 对象属性 xml-roles:doc-preface
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'preface'
  • 地标类型为 Custom
  • 本地化地标类型为 'preface'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-preface。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "preface" }

7.2.36 doc-prologue

DPUB-ARIA 规范 doc-prologue
计算角色 doc-prologue
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-prologue
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'prologue'
  • 地标类型为 Custom
  • 本地化地标类型为 'prologue'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-prologue。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkRegion
  • AXRoleDescription: 'region'
  • AXCustomContent: { label: "type", value: "prolog" }

7.2.37 doc-pullquote

DPUB-ARIA 规范 doc-pullquote
计算角色 doc-pullquote
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_SECTION
  • 对象属性 xml-roles:doc-pullquote
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'pullquote'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-pullquote。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "pull quote" }

7.2.38 doc-qna

DPUB-ARIA 规范 doc-qna
计算角色 doc-qna
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_SECTION

IAccessible2：

对象属性 xml-roles:doc-qna
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'qna'
ATK/AT-SPI 角色

暴露 ROLE_SECTION 和对象属性 xml-roles:doc-qna。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXApplicationGroup
  • AXRoleDescription: 'group'
  • AXCustomContent: { label: "type", value: "Q&A" }

7.2.39 doc-subtitle

DPUB-ARIA 规范 doc-subtitle
计算角色 doc-subtitle
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_HEADING
  • 对象属性 xml-roles:doc-subtitle
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'subtitle'
ATK/AT-SPI 角色

暴露 ROLE_HEADING 和对象属性 xml-roles:doc-subtitle。

Mac AX API
  • AXRole: AXHeading
  • AXSubrole: AXSubtitle
  • AXRoleDescription: 'subtitle'
  • AXCustomContent: {}

7.2.40 doc-tip

DPUB-ARIA 规范 doc-tip
计算角色 doc-tip
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露

IA2_ROLE_NOTE

IAccessible2：

对象属性 xml-roles:doc-tip
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'tip'
ATK/AT-SPI 角色

暴露 ROLE_COMMENT 和对象属性 xml-roles:doc-tip。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXDocumentNote
  • AXRoleDescription: 'note'
  • AXCustomContent: { label: "type", value: "tip" }

7.2.41 doc-toc

DPUB-ARIA 规范 doc-toc
计算角色 doc-toc
MSAA + IAccessible2 角色 + 其他 IAccessible2 特性 暴露 IAccessible2：
  • IA2_ROLE_LANDMARK
  • 对象属性 xml-roles:doc-toc
UIA 控件类型 + 其他特性
  • 控件类型为 Text
  • 本地化控件类型为 'toc'
  • 地标类型为 Custom
  • 本地化地标类型为 'toc'
ATK/AT-SPI 角色

暴露 ROLE_LANDMARK 和对象属性 xml-roles:doc-toc。

Mac AX API
  • AXRole: AXGroup
  • AXSubrole: AXLandmarkNavigation
  • AXRoleDescription: 'navigation'
  • AXCustomContent: { label: "type", value: "table of contents" }

8. 可翻译值

HTML 规范指出，其他规范可以定义 可翻译 属性 [html]。每个 属性值的语言和方向性与该元素的 语言和 方向性相同 [html]。

为了让辅助技术用户能够理解，下列供人阅读的 role 映射值在页面本地化时 SHOULD 翻译：

9. 状态和属性映射

本节描述如何暴露 WAI-ARIA 状态和对象 属性。用户 代理 MUST 符合 [CORE-AAM-1.1] 中 状态和属性 映射的无障碍 API 计算 要求。

10. 需要额外计算的 特殊处理

10.1 名称和描述

在计算无障碍名称或无障碍描述时，用户代理 MUST 符合 [ACCNAME-1.2] 规范中标题为 文本替代 计算的章节。

10.2 关系

用户代理 MUST 符合 [CORE-AAM-1.1] 中 关系的无障碍 API 计算要求。

10.3 组位置

用户代理 MUST 符合 [CORE-AAM-1.1] 中 组位置 的无障碍 API 计算要求。

11. 操作

用户代理 MUST 符合 [CORE-AAM-1.1] 中 操作的无障碍 API 计算要求。

12. 事件

用户代理会因用户操作、WAI-ARIA 状态变化、文档内容或节点可见性变化、 选择变化以及菜单操作而触发事件。符合要求的用户代理 MUST 支持 [CORE-AAM-1.1] 事件映射。

13. 安全考量

本节为非规范性内容。

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

14. 隐私考量

本节为非规范性内容。

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

A. 附录

A.1 变更日志

A.1.1 自首个公开工作草案以来的实质性变更

  • 2023年12月1日：移除了分别暗示列表项后代 doc-bibliograph 和 doc-endnotes 上存在 doc-biblioentry 和 doc-endnote 的映射。
  • 2023年1月10日：添加了关于可翻译值的章节。
  • 2023年1月4日：修正了 ATK/AT-SPI 对 doc-preface 的映射中提到的错误 doc-pagebreak 角色。
  • 2023年1月4日：更新了 Mac AX API 映射，以 添加 AXCustomContent 字段。

A.1.2 自 数字出版 无障碍 API 映射 1.0以来的其他实质性变更

  • 2021年9月20日：添加了 doc-pageheader 和 doc-pagefooter 角色的映射。

A.2 致谢

本节为非规范性内容。

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

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

  • Rahim Abdi (Apple Inc.)
  • NAVYA AGARWAL (Adobe)
  • Mario Batušić (Fabasoft)
  • Benjamin Beaudry (Microsoft Corporation)
  • Curt Bellew (Oracle Corporation)
  • Zoë Bijl (W3C Invited Experts)
  • Aleksandar Cindrikj (Netcetera)
  • Keith Cirkel (Mozilla Foundation)
  • Daniel Clark (Microsoft Corporation)
  • James Craig (Apple Inc.)
  • Chris Cuellar (Bocoup)
  • Hidde de Vries (Logius)
  • Joanmarie Diggs (Igalia)
  • Howard Edwards (Bocoup)
  • James Edwards (TPGi)
  • Mayuri Faldu (Navy Federal Credit Union)
  • Betsy Fanning (PDF Association)
  • Steve Faulkner (TetraLogical Services Ltd)
  • Jaunita Flessas (Navy Federal Credit Union)
  • Jane Fulton (Cisco)
  • Bryan Garaventa (W3C Invited Experts)
  • Rashmi Garimella (Google LLC)
  • Matt Garrish (DAISY Consortium)
  • Doug Geoffray (Microsoft Corporation)
  • Ariella Gilmore (IBM Corporation)
  • Shirisha Gubba (Google LLC)
  • Jon Gunderson (University of Illinois)
  • Oliver Habersetzer (SAP SE)
  • Theo Hale (Microsoft Corporation)
  • Sunny Hardasani (Adobe)
  • Matthew Hardy (Adobe)
  • Chris Harrelson (Google LLC)
  • Peter Heumader (Fabasoft)
  • Sarah Higley (Microsoft Corporation)
  • Hans Hillen (TPGi)
  • Isabel Holdsworth (TPGi)
  • Stanley Hon (Microsoft Corporation)
  • Michael Jackson (Microsoft Corporation)
  • Duff Johnson (PDF Association)
  • Summer Jones (Thomson Reuters Corp.)
  • William Kilian (TargetStream Technologies)
  • Matthew King (Meta)
  • Zachary Kinsey (TargetStream Technologies)
  • Greta Krafsig (The Washington Post)
  • Peter Krautzberger (krautzource UG)
  • Nina Krauß (SAP SE)
  • JaEun Jemma Ku (University of Illinois)
  • Joe Lamyman (TetraLogical Services Ltd)
  • Charles LaPierre (Benetech)
  • Philip Lazarevic (Level Access)
  • Leo Lee (Microsoft Corporation)
  • Aaron Leventhal (Google LLC)
  • Brett Lewis (TPGi)
  • Andy Luhrs (Microsoft Corporation)
  • Sazzad Mahamud (Google LLC)
  • Alison Maher (Microsoft Corporation)
  • Mark McCarthy (University of Illinois)
  • Eduardo Meza Etienne (Navy Federal Credit Union)
  • Clay Miller (Microsoft Corporation)
  • Daniel Montalvo (W3C)
  • Jacques Newman (Microsoft Corporation)
  • James Nurthen (Adobe)
  • Scott O'Hara (Microsoft Corporation)
  • Lola Odelola (W3C Invited Experts)
  • Adam Page (Hilton)
  • Michael Pennisi (Bocoup)
  • Roberto Perez (Microsoft Corporation)
  • Giacomo Petri (UsableNet)
  • Noah Praskins (TPGi)
  • Daniel Pöll (Fabasoft)
  • Paul Rayius (Allyant)
  • 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)
  • Cynthia Shelly (W3C Invited Experts)
  • Tzviya Siegman (W3C)
  • Arturo Silva (The Washington Post)
  • Avneesh Singh (DAISY Consortium)
  • Michael[tm] Smith (sideshowbarker) (W3C)
  • Francis Storr (Intel Corporation)
  • Jennifer Strickland (MITRE Corporation)
  • Melanie Sumner (IBM Corporation)
  • Alexander Surkov (Igalia)
  • James Teh (Mozilla Foundation)
  • Jocelyn Tran (Google LLC)
  • Léonie Watson (TetraLogical Services Ltd)
  • Jan Williams (TPGi)
  • Valerie Young (Igalia)
  • Kate Zhao (Thomson Reuters Corp.)
  • Xiao (Helen) Zhou (University of Illinois)
  • Filippo Zorzi (UsableNet)

A.2.2 支持资助方

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

B. 参考文献

B.1 规范性参考文献

[ACCNAME-1.2]
无障碍名称和描述计算 1.2. Bryan Garaventa; Melanie Sumner. W3C. 2025年5月22日. W3C 工作草案. URL: https://www.w3.org/TR/accname-1.2/
[CORE-AAM-1.1]
核心无障碍 API 映射 1.1. Joanmarie Diggs; Joseph Scheuhammer; Richard Schwerdtfeger; Michael Cooper; Andi Snow-Weaver; Aaron Leventhal. W3C. 2017年12月14日. W3C 推荐标准. URL: https://www.w3.org/TR/core-aam-1.1/
[core-aam-1.2]
核心无障碍 API 映射 1.2. Valerie Young; Alexander Surkov. W3C. 2025年5月8日. CRD. URL: https://www.w3.org/TR/core-aam-1.2/
[dpub-aria-1.1]
数字出版 WAI-ARIA 模块 1.1. Matt Garrish; Tzviya Siegman. W3C. 2025年3月18日. W3C 提议 推荐标准. URL: https://www.w3.org/TR/dpub-aria-1.1/
[html]
HTML 标准. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. 现行 标准. URL: https://html.spec.whatwg.org/multipage/
[infra]
Infra 标准. Anne van Kesteren; Domenic Denicola. WHATWG. 现行标准. URL: https://infra.spec.whatwg.org/
[RFC2119]
用于 RFC 中表示 要求级别的关键词. S. Bradner. IETF. 1997年3月. 当前最佳实践. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]
RFC 2119 关键词中大写与小写的歧义. B. Leiba. IETF. 2017年5月. 当前最佳实践. URL: https://www.rfc-editor.org/rfc/rfc8174

B.2 资料性参考文献

[dom]
DOM 标准. Anne van Kesteren. WHATWG. 现行标准. URL: https://dom.spec.whatwg.org/
[fingerprinting-guidance]
缓解 Web 规范中的浏览器指纹识别. Nick Doty; Tom Ritter. W3C. 2025年3月21日. W3C 工作组 说明. URL: https://www.w3.org/TR/fingerprinting-guidance/
[wai-aria]
无障碍富互联网应用（WAI-ARIA） 1.0. James Craig; Michael Cooper et al. W3C. 2014年3月20日. W3C 推荐标准. URL: https://www.w3.org/TR/wai-aria/