数字出版 WAI-ARIA 模块 1.1

W3C 推荐标准

关于本文档的更多详情
此版本:
https://www.w3.org/TR/2025/REC-dpub-aria-1.1-20250612/
最新发布版本:
https://www.w3.org/TR/dpub-aria-1.1/
最新编辑草案:
https://w3c.github.io/dpub-aria/
历史:
https://www.w3.org/standards/history/dpub-aria-1.1/
提交历史
实现报告:
https://www.w3.org/2021/04/wpt-fyi-snapshot.html?filter=dpub-aam
编辑:
Matt Garrish (DAISY 联盟)
Tzviya Siegman (W3C)
前编辑:
Shane McCarron (Spec-Ops)
Markus Gylling (DAISY 联盟)
反馈:
GitHub w3c/dpub-aria (拉取请求, 新建议题, 未解决议题)
勘误:
存在勘误

另请参阅 翻译


摘要

要使辅助技术用户能够在 Web 内容中找到方向,需要嵌入有关 Web 文档结构划分的语义 元数据。这对于 长篇文档的结构划分尤为重要,并且与为辅助技术嵌入有关 Web 应用程序控件和行为的语义元数据相伴而行。本规范定义了一 组 WAI-ARIA 角色,专门用于 帮助辅助技术用户浏览这类长篇文档。

本文档是 WAI-ARIA 套件的一部分, 该套件在 WAI-ARIA 概述中有所说明。

本文档状态

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

我们鼓励就本规范的各个方面提供反馈,包括最新增加的 doc-pageheaderdoc-pagefooter 角色。

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

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

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

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

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

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

1. 引言

本节为非规范性内容。

WAI-ARIA 是一项技术规范,它 定义了通用宿主语言语义可访问性 API 和框架,使 Web 浏览器能够将 Web 内容中的可访问性语义映射到特定平台的可访问性 API。这 使 Web 内容能够与平台辅助技术互操作,从而类似于没有平台依赖的原生平台应用程序。

本规范是 WAI-ARIA 的模块化扩展,专为数字 出版行业设计。本规范 包括以下目标:

本规范中定义的角色派生自 EPUB 结构语义词汇表

有关 WAI-ARIA 的更详细说明,请参见 WAI-ARIA 概述,以及它如何适用于 富互联网应用可访问性。

1.1 目标受众

本规范定义了一个用于数字出版的 WAI-ARIA 模块,包括用于定义元素的 角色状态属性的 值。它会影响若干受众:

每项一致性要求都指明其适用的受众。

虽然本规范适用于上述受众,但它并非专门面向这些受众中的任何一个——也不 打算成为这些 受众的唯一信息来源。未来,将创建更多文档来帮助作者在 出版行业中应用这些 WAI-ARIA 语义,并定义本文档中的信息如何映射到平台 可访问性 API。

1.2 用户代理支持

本模块基于 [WAI-ARIA] 中定义的通用用户代理 支持原则,同时还 提供了用户代理增强呈现给读者的一般用户界面的能力。

1.3 WAI-ARIA 与宿主语言的共同演进

Digital Publishing WAI-ARIA 模块 遵循 [WAI-ARIA] 中定义的 WAI-ARIA 与宿主语言的共同演进模型。它 旨在增强 [HTML]、[SVG2] 和 [EPUB] 等支持语言中的语义,或作为一种 可访问性增强技术用于其他未明确包含 ARIA 支持的基于标记的 语言。当作者通过样式和脚本创建尚未由页面语言直接支持的新类型对象时,它会向辅助 技术阐明语义,因为新类型对象的发明速度快于 Web 语言中对它们的标准化支持出现的速度。

当宿主语言为这些类型的对象提供语义元素时,不应使用样式和脚本来创建对象。虽然 WAI-ARIA 可以改善 这些对象的可访问性,但最好通过允许用户代理原生处理该 对象来提供可访问性。例如,最好使用原生标题元素,例如 h1, 而不是在 div 元素上使用 heading 角色。

随着时间推移,预计宿主语言将演进,以便为目前只能通过本规范声明的对象提供语义。这是自然且可取的,因为 WAI-ARIA 的一个 目标是帮助促进更多语义化且可访问的标记出现。当给定 特性的原生语义可用时,作者应使用原生特性,并停止将此 模块用于该特性。不过,旧有内容可以继续使用 Digital Publishing WAI-ARIA 模块,因此用户代理 仍然需要支持它。

虽然本模块的某些特性可能会随着时间推移而失去重要性,但 Digital Publishing WAI-ARIA 模块为网页 或开放的基于 Web 的标准(例如 EPUB)添加语义的一般可能性,预计仍将是一项持续需求。宿主 语言可能不会实现本模块提供的所有语义,而各种宿主语言也可能 实现这些特性的不同子集。新的对象类型不断被 开发出来,而本规范的一个目标是提供一种使此类对象可访问的方式, 因为创作实践通常比宿主语言标准发展得更快。通过这种方式, 本模块和宿主语言会以不同速度共同演进。

某些宿主语言存在的目的是为用户界面之外的特性创建语义。例如, SVG 表达的是图形对象生成背后的语义,而不是这些对象可能代表的用户 界面组件的语义。诸如此类的宿主语言可能出于设计原因, 不提供可映射到本规范特性的原生语义。在这些情况下, Digital Publishing WAI-ARIA 模块可以 作为向这些宿主 语言添加语义信息的长期方法而被采用。

1.4 创作实践

1.4.1 创作工具

WAI-ARIA 和 Digital Publishing WAI-ARIA 角色状态属性定义中的许多要求都可以 在开发过程中自动检查,类似于 用于验证代码的其他质量控制流程。为了协助正在 创建数字出版物(例如 EPUB)的作者,此类流程可以将来自 DOM 的 Digital Publishing WAI-ARIA 角色的语义结构与本 规范中定义的结构进行比较,并通知作者错误,或者直接创建强制执行该 结构的模板。

1.4.2 测试实践和 工具

交互式内容的可访问性无法仅通过静态检查来确认。交互式 内容的开发者需要测试对 控件和应用程序的设备无关访问,并验证 在用户交互期间对所有内容和变更的可访问性 API 访问。

1.5 辅助技术

对可访问性语义的程序化访问对于辅助技术至关重要。有关更多 信息,请参见 [WAI-ARIA] 中的辅助技术 一节。

2. 一致性

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

本文档中的关键词 MAYMUSTMUST NOTSHOULD 应按照 BCP 14 [RFC2119] [RFC8174] 中的说明进行解释,但仅当它们如本文所示全部以大写形式出现时 才如此解释。

规范性章节提供了作者、用户代理和辅助技术 MUST 遵循的要求,以使实现符合本规范。

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

3. 数字出版角色

本节定义了对 WAI-ARIA 角色模型的补充,并描述 所有角色的特征和 属性。有关本模块所提供字段的说明,请参见 ARIA 角色

3.1 角色定义

以下是供富互联网应用作者使用的 WAI-ARIA 角色的字母顺序列表。

doc-abstract
对作品,或其中某一节或摘录的主要思想、概念和结论的简短概述。
doc-acknowledgments
对个人、组织、政府和其他实体为作品实现所作重要贡献表示感谢的章节或声明。
doc-afterword
作者或重要人物的结束语,通常说明 内容如何写成、其意义,或在其时间线之后 已经发生的相关事件。
doc-appendix
位于主要内容之后的补充信息章节,它为内容提供信息但 并非核心内容。
doc-backlink
允许用户返回内容中相关位置的链接(例如,从脚注返回 其引用处,或从术语表定义返回术语使用处)。
doc-biblioentry
[在 DPUB-ARIA 1.1 中已弃用] 书目中对外部来源的单个引用。 biblioentry 通常比内容中的引用提供更详细的信息 (例如,完整标题、作者、出版者、出版日期等)。
doc-bibliography
作品中引用的外部参考文献列表,可指印刷或数字来源。
doc-biblioref
对书目条目的引用。
doc-chapter
作品中内容的主要主题章节。
doc-colophon
与版本相关的简短制作说明章节(例如,描述所使用的字体), 通常位于作品末尾。
doc-conclusion
总结作品或收束叙事的结论性章节或声明。
doc-cover
为作品设定氛围或基调的图像,通常包含标题和作者。
doc-credit
对来自第三方来源的整合内容来源的致谢,例如照片。 通常标识创作者、版权以及任何复用限制。
doc-credits
致谢项的集合。
doc-dedication
位于作品开头的题献,通常献给一位或多位与作者亲近的人。
doc-endnote
[在 DPUB-ARIA 1.1 中已弃用] 位于作品末尾或其中某一节末尾的一组注释之一, 为所引用的文本段落提供额外上下文。
doc-endnotes
位于作品末尾或其中某一节末尾的一组注释。
doc-epigraph
置于作品或某一节开头、用于确立主题或营造氛围的引文。
doc-epilogue
收束或评论作品中的行为和事件的叙事性结尾章节, 通常从未来视角展开。
doc-errata
作品首次出版后发现的一组更正,有时称为勘误。
doc-example
作品中某个关键概念的示例,例如代码清单、案例研究或问题。
doc-footnote
附属信息,例如引文或评论,为所引用的文本段落提供额外上下文。
doc-foreword
位于作品之前的引言性章节,通常并非由作品作者撰写。
doc-glossary
内容中使用的新术语、非常见术语或专业术语的简明词典。
doc-glossref
对术语表定义的引用。
doc-index
一种导航辅助,提供指向作品中涵盖的关键主题、名称和其他重要 话题的详细链接列表。
doc-introduction
通常介绍作品范围或性质的预备章节。
doc-noteref
对脚注或尾注的引用,通常在正文中以数字或符号上标形式出现。
doc-notice
通知用户某个行为或事件可能产生的后果。示例包括 警告、注意事项和危险提示。
doc-pagebreak
一个分隔符,表示在内容的静态分页版本中,两个连续页面之间 分页发生前的位置。
doc-pagefooter
出现在页面底部的一段文本,提供当前作品及其 所在位置的上下文。页脚不同于正文,通常 遵循重复模板,其中包含(可能被截断的)项目,例如文档标题、 当前章节、作者姓名和页码。
doc-pageheader
出现在页面顶部的一段文本,提供当前作品及其 所在位置的上下文。页眉不同于正文,通常遵循 重复模板,其中包含(可能被截断的)项目,例如文档标题、当前 章节、作者姓名和页码。
doc-pagelist
一种导航辅助,提供指向内容中分页符的链接列表。
doc-part
作品中的主要结构划分,包含一组处理特定主题、叙事弧线或类似封装主题的相关章节。
doc-preface
位于作品之前的引言性章节,通常由作品作者撰写。
doc-prologue
为作品设定背景的引言性章节,通常是叙事的一部分。
doc-pullquote
从当前内容中摘出的、以独特方式放置或突出显示的引文,用于吸引注意力 指向某个主题或突出关键点。
doc-qna
以一系列问题和答案构成的内容章节,例如访谈或常见问题列表。
doc-subtitle
作品、或其中某一节或组件的解释性或替代标题。
doc-tip
有助于阐明内容某个方面或帮助理解内容的信息。
doc-toc
一种导航辅助,提供一个有序链接列表,指向内容中的主要章节标题。 目录可以覆盖整部作品,也可以只覆盖其中较小的一节。

doc-abstract (角色)

对作品,或其中某一节或摘录的主要思想、概念和结论的简短概述。

<section role="doc-abstract" aria-label="摘要">
   <p>Web 内容的可访问性需要有关控件、结构
      和行为的语义信息 …</p>
</section>
doc-abstract 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-acknowledgments (角色)

对个人、组织、 政府和其他实体为作品实现所作重要贡献表示感谢的章节或声明。

<section role="doc-acknowledgments">
   <p>我谨向 … 表达诚挚的感谢 </p>
</section>
doc-acknowledgments 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-afterword (角色)

作者或重要人物的结束语,通常说明 内容如何写成、其意义,或在其时间线之后 已经发生的相关事件。

<section role="doc-afterword">
   <h2>后记:我为何写这本书</h2></section>
doc-afterword 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-appendix (角色)

位于主要内容之后的补充信息章节,它为内容提供信息 但并非核心内容。

<section role="doc-appendix">
   <h2>附录 A. 历史时间线</h2></section>
doc-appendix 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-biblioentry (角色)

[在 DPUB-ARIA 1.1 中已弃用] 书目中对外部来源的单个引用。 biblioentry 通常比内容中的引用提供更详细的信息 (例如,完整标题、作者、出版者、出版日期等)。

doc-biblioentry 角色最初设计为列表 项使用,但由于 WAI-ARIA 规范中的澄清,它作为 list 角色的子级无效。由于 doc-bibliography 角色已经标识了 书目条目章节,因此建议作者在无法使用原生 HTML 元素 来构造条目时,改用 listlistitem 角色。

doc-biblioentry 的特征:
特征
超类角色: listitem
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: True

doc-bibliography (角色)

作品中引用的外部参考文献列表,可指印刷或数字来源。

带有 doc-bibliography 角色的元素MUST 至少包含一个后代列表,用于包含书目 条目(如果条目被 细分,例如按字母顺序排列,则该元素会包含多个列表)。

作者 MUST NOTdoc-bibliography 角色直接应用 于包含条目的列表。

<section role="doc-bibliography">
   <h2>精选书目</h2>
   <ul></ul>
</section>
doc-bibliography 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-biblioref (角色)

对书目条目的引用。

<p>
   正如 <a role="doc-biblioref"
      href="#b8cab5dd-bc24-459c-9858-7afa9da69b64">Steinbeck</a>
   在他的伟大小说中所说 …
</p>
doc-biblioref 的特征:
特征
超类角色: link
相关概念:
继承的状态和属性:
名称来源:
  • 内容
  • 作者
需要可访问名称: True

doc-chapter (角色)

作品中内容的主要主题章节。

<section role="doc-chapter">
   <h2>第 1 章。远望。</h2></section>
doc-chapter 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-colophon (角色)

与版本相关的简短制作说明章节(例如,描述所使用的字体), 通常位于作品末尾。

<section role="doc-colophon" aria-label="关于字体">
   <p>本出版物使用 … 排版 </p>
</section>
doc-colophon 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-conclusion (角色)

总结作品或收束叙事的结论性章节或声明。

<section role="doc-conclusion">
   <h2>总结</h2>
   <p>女性主义学术研究的一项核心任务是揭露并拆解刻板印象 … </p>
</section>
doc-conclusion 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-cover (角色)

为作品设定氛围或基调的图像,通常包含标题和作者。

<img role="doc-cover" src="coverimage.jpg" alt="Virginia Woolf 的《一间自己的房间》"/>
doc-cover 的特征:
特征
超类角色: img
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-credit (角色)

对来自第三方来源的整合内容来源的致谢,例如照片。 通常标识创作者、版权以及任何复用限制。

<p role="doc-credit">
   第 62 页,表 3.1,出自 <cite>“成本效益分析的经济学基础”</cite>
   作者 A. M. Garber 和 C. E. Phelps …
</p>
doc-credit 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-credits (角色)

致谢项的集合。

<section role="doc-credits">
   <h2>照片致谢</h2></section>
doc-credits 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-dedication (角色)

位于作品开头的题献,通常献给一位或多位与 作者亲近的人。

<p role="doc-dedication">献给我的家人,没有他们,这一切永远不可能实现。</p>
doc-dedication 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-endnote (角色)

[在 DPUB-ARIA 1.1 中已弃用] 位于作品末尾或其中 某一节末尾的一组注释之一,为所引用的文本段落提供额外上下文。

doc-endnote 角色最初设计为列表 项使用,但由于 WAI-ARIA 规范中的澄清,它作为 list 角色的子级无效。由于 doc-endnotes 角色已经标识了尾注 章节,因此建议作者在无法使用原生 HTML 元素 来构造条目时,改用 listlistitem 角色。

doc-endnote 的特征:
特征
超类角色: listitem
相关概念:
继承的状态和属性:
名称来源: 作者

doc-endnotes (角色)

位于作品末尾或其中某一节末尾的一组注释。

带有 doc-endnotes 角色的元素 MUST 至少包含一个后代列表,用于包含尾注(如果 注释被细分,例如 按章节细分,则该元素会包含多个列表)。

作者 MUST NOT 在尾注中声明具有 doc-footnote 角色的元素,因为这与隐含角色 重复。

作者 MUST NOTdoc-endnotes 角色直接应用于 包含尾注的列表。

<section role="doc-endnotes">
   <h2>注释</h2>
   <ol>
      <li id="6baa07af">
         <p>本研究的其他结果可见于 … </p>
      </li>
      <li id="7b2c0555">
         <p></p>
      </li></ol>
</section>
<section role="doc-endnotes">
   <h2>注释</h2>
   <section>
      <h3>第一歌</h3>
      <div role="list>
         <div role="listitem">
            <p>1. 此处头韵的使用 … </p>
         </div></div>
   </section></section>
doc-endnotes 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-epigraph (角色)

置于作品或某一节开头、用于确立主题或营造 氛围的引文。

<blockquote role="doc-epigraph">
   <p>“请问你能告诉我,我从这里该往哪条路走吗?”</p>
   <p>“这很大程度上取决于你想去哪里,”猫说。</p>
</blockquote>
doc-epigraph 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-epilogue (角色)

收束或评论作品中的行为和事件的叙事性结尾章节, 通常从未来视角展开。

<section role="doc-epilogue">
   <header>
      <h2>尾声</h2>
      <p>普洛斯彼罗念白</p>
   </header>
   <p>如今我的魔力已尽数消散,…</p></section>
doc-epilogue 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-errata (角色)

作品首次出版后发现的一组更正,有时称为 勘误。

<section role="doc-errata">
   <h2>更正</h2></section>
doc-errata 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-example (角色)

作品中某个关键概念的示例,例如代码清单、案例研究或问题。

<figure role="doc-example">
   <figcaption>示例 1 — 你好,世界!</figcaption></figure>
doc-example 的特征:
特征
超类角色: figure
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-footnote (角色)

附属信息,例如引文或评论,为所引用的文本段落提供额外上下文。

doc-footnote 角色仅用于表示 作品正文中出现的单个注释。对于出现在某一节末尾 的注释集合,请参见 doc-endnotes

<aside id="6baa07af" role="doc-footnote">
   * 本研究和类似研究的其他结果可见于 …
</aside>
doc-footnote 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者

doc-foreword (角色)

位于作品之前的引言性章节,通常并非由作品作者撰写。

<section role="doc-foreword">
   <h2>前言</h2></section>
doc-foreword 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-glossary (角色)

内容中使用的新术语、非常见术语或专业术语的简明词典。

术语表的结构 SHOULD 使最终用户能够 识别每个术语及其关联定义(例如,使用 [HTML] dfn 元素)。

<section role="doc-glossary" aria-label="术语表">
   <dl><dt id="bcc0f155"><dfn>信用违约互换</dfn></dt>
      <dd>
         信用违约互换实际上为
         借款人的违约提供保险。
      </dd></dl>
</section>
<section role="doc-glossary" aria-labelledby="glosshd">
   <h2 id="glosshd">技术术语表</h2>
   <ul>
      <li id="gtt00110001"><dfn>算法</dfn> 一组规则 …</li></ul>
</section>
doc-glossary 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-glossref (角色)

对术语表定义的引用。

<p>
   这体现在
   <a href="#bcc0f155" role="doc-glossref">信用违约互换</a> 的成本中 …
</p>
doc-glossref 的特征:
特征
超类角色: link
相关概念:
继承的状态和属性:
名称来源:
  • 内容
  • 作者
需要可访问名称: True

doc-index (角色)

一种导航辅助,提供指向作品中涵盖的关键主题、名称和其他 重要话题的详细链接列表。

<section role="doc-index">
   <h2>索引</h2>
   <section>
      <h2>A</h2>
      <ul>
         <li>A/B 测试,<a href="chapter03.xhtml#page230">230</a></li></ul>
   </section></section>
doc-index 的特征:
特征
超类角色: navigation
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-introduction (角色)

通常介绍作品范围或性质的预备章节。

<section role="doc-introduction">
   <p>每个人都对营销有一些经验 … </p>
</section>
doc-introduction 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-noteref (角色)

对脚注或尾注的引用,通常在正文中以数字或符号上标形式出现。

<p> … 正如研究所示。<a href="#fn01" id="fnref01" role="doc-noteref">[1]</a></p>
doc-noteref 的特征:
特征
超类角色: link
相关概念:
继承的状态和属性:
名称来源:
  • 内容
  • 作者
需要可访问名称: True

doc-notice (角色)

通知用户某个行为或事件可能产生的后果。示例包括 警告、注意事项和危险提示。

<section role="doc-notice">
   <img src="warning.png" alt="警告图标"/>
   <p>能包含字体并不意味着你就应该这样做。
      请仔细考虑可读性。同时,也要尊重知识产权。
      有许多优秀的免费开源字体可用。</p>
</section>

当该通知需要可导航到时,作者 SHOULD 包含标签。

<div role="doc-notice" aria-label="爆炸风险">
   <p><em>危险!</em> 混合反应性材料可能导致爆炸。</p>
</div>
doc-notice 的特征:
特征
超类角色: note
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-pagebreak (角色)

一个分隔符,表示在内容的静态分页版本中,两个连续页面之间 分页发生前的位置。

分页符定位符也常用于在纯数字出版物中提供静态标记 (即不存在静态分页等效版本的情况)。这些标记提供 一致的导航,不受字体和屏幕尺寸差异影响,否则这些差异可能 影响内容的动态分页。

作者 MUST 确保分页符的名称是最终 用户可理解的页码,用于标识正在开始的页面,以便辅助 技术能根据需要播报该页面 (例如,在用于标识当前页面的命令中)。

分页符定位符 MUST 位于其所 标识页面内容之前。如果页面包含页眉(doc-pageheader),分页符定位符 SHOULD 位于其之前, 即使页眉包含可见页码也是如此。如果页码 位于页眉中所有其他内容之前,则分页符定位符 MAY 与页眉中的页码一起使用。

从静态页面等效版本重现分页符定位符时,有时会出现 单词跨页断字的情况。发生这种情况时,分页符定位符 SHOULD 放在该单词之前或之后,以确保它不会干扰文本转语音 播放。

doc-pagebreak 的特征:
特征
超类角色: separator
相关概念:
继承的状态和属性:
名称来源:
  • 内容
  • 作者
需要可访问名称: True
子级为表现性: True

doc-pageheader (角色)

出现在页面顶部的一段文本,提供当前作品及其所在位置的上下文。 页眉不同于正文,通常遵循重复模板,其中包含(可能被截断的) 项目,例如文档标题、当前章节、作者姓名和页码。

doc-pageheader 角色 MUST 用于 页眉的每个实例。

辅助技术 MAY 允许用户在阅读文档内容时 不被页眉打断而连续阅读。

<section role="doc-pageheader">
   <div>战争与和平</div>
   <div>321</div></section>
doc-pageheader 的特征:
特征
超类角色: section
继承的状态和属性:
名称来源: 禁止
需要可访问名称: False

doc-pagelist (角色)

一种导航辅助,提供指向内容中分页符的链接列表。

<nav role="doc-pagelist">
   <h2>页面</h2>
   <ol>
      <li><a href="chapter.xhtml#Page_1">1</a></li>
      <li><a href="chapter.xhtml#Page_2">2</a></li></ol>
</nav>
doc-pagelist 的特征:
特征
超类角色: navigation
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-part (角色)

作品中的主要结构划分,包含一组处理特定主题、 叙事弧线或类似封装主题的相关章节。

<section role="doc-part">
   <h2>第一部分</h2>
   <section role="doc-chapter">
      <h2>第 1 章</h2></section></section>
doc-part 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-preface (角色)

位于作品之前的引言性章节,通常由作品作者撰写。

<section role="doc-preface">
   <h2>引言:银河系指南</h2></section>
doc-preface 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-prologue (角色)

为作品设定背景的引言性章节,通常是叙事的一部分。

<section role="doc-prologue">
   <header>
      <h2>序幕</h2>
      <p>合唱队</p>
   </header>
   <p>两个家族,门第相当,…</p></section>
doc-prologue 的特征:
特征
超类角色: landmark
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-pullquote (角色)

从当前内容中摘出的、以独特方式放置或突出显示的引文,用于吸引注意力 指向某个主题或突出关键点。

与引用自其他来源的段落不同,提引是当前文档中文本的直接重复。因此, 作者 MUST 确保表现性出现 对辅助技术用户隐藏 (例如,使用 aria-hidden 属性)。

以下示例展示了对将呈现在其他位置的提引的标识 (例如,通过脚本)。在这种情况下,提引未被隐藏,因为标记的文本并非 表现性文本。

<p>… 我可能会死,但首先,你,我的暴君和折磨者,将诅咒照见你苦难的太阳。
   <span id="pq01" role="doc-pullquote">当心,因为我无所畏惧,因此强大。</span>
   我将像蛇一样狡黠地守候,好用它的毒液刺伤你。… </p>

下一个示例展示了一个重复文本的提引。该引文被隐藏,因为它 仅用于表现目的。

<p>… 更好的习惯为成长铺路,而成长带来更大的幸福。</p>
<aside role="doc-pullquote" aria-hidden="true">
   更好的习惯为成长铺路,而成长带来更大的幸福。
</aside>
doc-pullquote 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-qna (角色)

以一系列问题和答案构成的内容章节,例如访谈或 常见问题列表。

<section role="doc-qna">
   <h2>作者访谈</h2>
   <dl>
      <dt>问:你是什么时候开始写这本书的?</dt>
      <dd>答:我第一次有这个想法是在 …</dd></dl>
</section>
doc-qna 的特征:
特征
超类角色: section
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-subtitle (角色)

作品、或其中某一节或组件的解释性或替代标题。

<header>
   <h2>第 2 章 战斗</h2>
   <p role="doc-subtitle">再次冲向突破口</p>
</header>
doc-subtitle 的特征:
特征
超类角色: sectionhead
相关概念:
继承的状态和属性:
名称来源:
  • 内容
  • 作者
需要可访问名称: False

doc-tip (角色)

有助于阐明内容某个方面或帮助理解内容的信息。

<aside role="doc-tip">
   <h3>提示</h3>
   <p>你可以把一个变量赋予一个新值,该新值是包含
      其先前值的表达式的结果。</p>
</aside>
doc-tip 的特征:
特征
超类角色: note
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

doc-toc (角色)

一种导航辅助,提供一个有序链接列表,指向内容中的主要章节标题。 目录可以覆盖整部作品,也可以只覆盖其中较小的一节。

<nav role="doc-toc">
   <h2>目录</h2>
   <ol role="directory">
      <li><a href="preface_001.xhtml">原转录者说明:</a></li>
      <li><a href="introduction_001.xhtml">词源。</a></li>
      <li><a href="epigraph_001.xhtml">摘录(由副副图书管理员提供)。</a></li>
      <li><a href="chapter_001.xhtml">第 1 章。远望。</a></li></ol>
</nav>
doc-toc 的特征:
特征
超类角色: navigation
相关概念:
继承的状态和属性:
名称来源: 作者
需要可访问名称: False

4. 安全注意事项

本节是非规范性的。

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

5. 隐私注意事项

本节是非规范性的。

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

A. 变更日志

本节是非规范性的。

A.1 上一份候选推荐标准 快照以来的实质性变更

A.2 DPUB-ARIA 1.0 推荐标准以来的实质性变更

B. 致谢

本节是非规范性的。

以下人员为本文档的制定作出了贡献:

B.1 发布时的 ARIA WG 参与者

B.2 支持资助方

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

C. 参考文献

C.1 规范性参考文献

[EPUB-SSV-11]
EPUB 3 结构语义词汇表 1.1. Ivan Herman; Matt Garrish. W3C. 2025 年 3 月 13 日。W3C 工作组说明。URL: https://www.w3.org/TR/epub-ssv-11/
[HTML]
HTML 标准. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. 现行 标准。URL: https://html.spec.whatwg.org/multipage/
[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

C.2 资料性参考文献

[dpub-aam-1.0]
数字出版可访问性 API 映射. Richard Schwerdtfeger; Joanmarie Diggs. W3C. 2017 年 12 月 14 日。W3C 推荐标准。URL: https://www.w3.org/TR/dpub-aam-1.0/
[EPUB]
EPUB 3.3. Ivan Herman; Matt Garrish; Dave Cramer. W3C. 2025 年 3 月 27 日。W3C 推荐标准。URL: https://www.w3.org/TR/epub-33/
[fingerprinting-guidance]
在 Web 规范中缓解浏览器指纹识别. Nick Doty; Tom Ritter. W3C. 2025 年 3 月 21 日。W3C 工作组 说明。URL: https://www.w3.org/TR/fingerprinting-guidance/
[infra]
Infra 标准. Anne van Kesteren; Domenic Denicola. WHATWG. 现行标准。URL: https://infra.spec.whatwg.org/
[SVG2]
可缩放矢量图形(SVG)2. Amelia Bellamy-Royds; Bogdan Brinza; Chris Lilley; Dirk Schulze; David Storey; Eric Willigers. W3C. 2018 年 10 月 4 日。W3C 候选推荐标准。URL: https://www.w3.org/TR/SVG2/
[WAI-ARIA]
可访问富互联网应用(WAI-ARIA) 1.1. Joanmarie Diggs; Shane McCarron; Michael Cooper; Richard Schwerdtfeger; James Craig. W3C. 2017 年 12 月 14 日。W3C 推荐标准。URL: https://www.w3.org/TR/wai-aria-1.1/