另请参阅 翻译。
Copyright © 2015-2025 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
要使辅助技术用户能够在 Web 内容中找到方向,需要嵌入有关 Web 文档结构划分的语义 元数据。这对于 长篇文档的结构划分尤为重要,并且与为辅助技术嵌入有关 Web 应用程序控件和行为的语义元数据相伴而行。本规范定义了一 组 WAI-ARIA 角色,专门用于 帮助辅助技术用户浏览这类长篇文档。
本文档是 WAI-ARIA 套件的一部分, 该套件在 WAI-ARIA 概述中有所说明。
本节描述本文档 在发布时的状态。当前 W3C 出版物列表以及本技术报告的最新修订版可见于 W3C 标准与草案 索引: https://www.w3.org/TR/。
我们鼓励就本规范的各个方面提供反馈,包括最新增加的
doc-pageheader 和 doc-pagefooter 角色。
本规范的未来更新可能会纳入新特性。
本文档由可访问富互联网 应用工作组作为 推荐标准,并使用 推荐标准轨道发布。
W3C 建议将本规范作为 Web 的标准 广泛部署。
W3C 推荐标准是一种规范,它在经过广泛 共识构建之后,由 W3C 及其成员认可,并且 工作组成员承诺对实现提供 免版税许可。
本文档由一个 根据 W3C 专利 政策运作的小组制作。 W3C 维护一份 任何专利披露的公开列表, 这些披露与该小组的交付成果相关;该页面还包括 披露专利的说明。实际知晓某项专利的个人,如果该个人认为该专利包含 必要权利要求, 则必须依照 W3C 专利政策第 6 节 披露该信息。
本文档受 2023 年 11 月 03 日 W3C 流程文档管辖。
本节为非规范性内容。
WAI-ARIA 是一项技术规范,它 定义了通用宿主语言语义可访问性 API 和框架,使 Web 浏览器能够将 Web 内容中的可访问性语义映射到特定平台的可访问性 API。这 使 Web 内容能够与平台辅助技术互操作,从而类似于没有平台依赖的原生平台应用程序。
本规范是 WAI-ARIA 的模块化扩展,专为数字 出版行业设计。本规范 包括以下目标:
本规范中定义的角色派生自 EPUB 结构语义词汇表。
有关 WAI-ARIA 的更详细说明,请参见 WAI-ARIA 概述,以及它如何适用于 富互联网应用可访问性。
本规范定义了一个用于数字出版的 WAI-ARIA 模块,包括用于定义元素的 角色、 状态 和属性的 值。它会影响若干受众:
每项一致性要求都指明其适用的受众。
虽然本规范适用于上述受众,但它并非专门面向这些受众中的任何一个——也不 打算成为这些 受众的唯一信息来源。未来,将创建更多文档来帮助作者在 出版行业中应用这些 WAI-ARIA 语义,并定义本文档中的信息如何映射到平台 可访问性 API。
本模块基于 [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 模块可以 作为向这些宿主 语言添加语义信息的长期方法而被采用。
除标记为非规范性的章节外,本规范中的所有创作指南、图表、示例和注释均为 非规范性内容。本规范中的其他所有内容均为规范性内容。
本文档中的关键词 MAY、MUST、MUST NOT 和 SHOULD 应按照 BCP 14 [RFC2119] [RFC8174] 中的说明进行解释,但仅当它们如本文所示全部以大写形式出现时 才如此解释。
规范性章节提供了作者、用户代理和辅助技术 MUST 遵循的要求,以使实现符合本规范。
非规范性章节提供有助于理解本规范的信息。此类章节可能 包含推荐实践的示例,但并不要求遵循此类 建议才能符合本规范。
本节定义了对 WAI-ARIA 角色模型的补充,并描述 所有角色的特征和 属性。有关本模块所提供字段的说明,请参见 ARIA 角色。
以下是供富互联网应用作者使用的 WAI-ARIA 角色的字母顺序列表。
doc-abstract (角色)
对作品,或其中某一节或摘录的主要思想、概念和结论的简短概述。
<section role="doc-abstract" aria-label="摘要">
<p>Web 内容的可访问性需要有关控件、结构
和行为的语义信息 …</p>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB abstract [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-acknowledgments (角色)
对个人、组织、 政府和其他实体为作品实现所作重要贡献表示感谢的章节或声明。
<section role="doc-acknowledgments">
<p>我谨向 … 表达诚挚的感谢 </p>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB acknowledgments [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-afterword (角色)
作者或重要人物的结束语,通常说明 内容如何写成、其意义,或在其时间线之后 已经发生的相关事件。
<section role="doc-afterword">
<h2>后记:我为何写这本书</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB afterword [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-appendix (角色)
位于主要内容之后的补充信息章节,它为内容提供信息 但并非核心内容。
<section role="doc-appendix">
<h2>附录 A. 历史时间线</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB appendix [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-backlink (角色)
允许用户返回内容中相关位置的链接(例如,从脚注 返回其引用处,或从术语表定义返回术语使用处)。
<aside id="fn01" role="doc-footnote">
<a role="doc-backlink" href="#fnref01">1.</a>
本研究的其他结果以及
类似研究可见于 …
</aside>
| 特征 | 值 |
|---|---|
| 超类角色: | link |
| 相关概念: | EPUB referrer [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: |
|
| 需要可访问名称: | True |
doc-biblioentry (角色)
[在 DPUB-ARIA 1.1 中已弃用] 书目中对外部来源的单个引用。 biblioentry 通常比内容中的引用提供更详细的信息 (例如,完整标题、作者、出版者、出版日期等)。
doc-biblioentry 角色最初设计为列表
项使用,但由于 WAI-ARIA 规范中的澄清,它作为
list 角色的子级无效。由于 doc-bibliography 角色已经标识了
书目条目章节,因此建议作者在无法使用原生 HTML 元素
来构造条目时,改用 list 和
listitem 角色。
| 特征 | 值 |
|---|---|
| 超类角色: | listitem |
| 相关概念: | EPUB biblioentry [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | True |
doc-bibliography (角色)
作品中引用的外部参考文献列表,可指印刷或数字来源。
带有 doc-bibliography 角色的元素MUST
至少包含一个后代列表,用于包含书目
条目(如果条目被
细分,例如按字母顺序排列,则该元素会包含多个列表)。
作者 MUST NOT 将 doc-bibliography 角色直接应用
于包含条目的列表。
<section role="doc-bibliography">
<h2>精选书目</h2>
<ul>
…
</ul>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB bibliography [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-biblioref (角色)
对书目条目的引用。
<p>
正如 <a role="doc-biblioref"
href="#b8cab5dd-bc24-459c-9858-7afa9da69b64">Steinbeck</a>
在他的伟大小说中所说 …
</p>
| 特征 | 值 |
|---|---|
| 超类角色: | link |
| 相关概念: | EPUB biblioref [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: |
|
| 需要可访问名称: | True |
doc-chapter
(角色)
作品中内容的主要主题章节。
<section role="doc-chapter">
<h2>第 1 章。远望。</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB chapter [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-colophon (角色)
与版本相关的简短制作说明章节(例如,描述所使用的字体), 通常位于作品末尾。
<section role="doc-colophon" aria-label="关于字体">
<p>本出版物使用 … 排版 </p>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB colophon [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-conclusion (角色)
总结作品或收束叙事的结论性章节或声明。
<section role="doc-conclusion">
<h2>总结</h2>
<p>女性主义学术研究的一项核心任务是揭露并拆解刻板印象 … </p>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB conclusion [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-cover (角色)为作品设定氛围或基调的图像,通常包含标题和作者。
<img role="doc-cover" src="coverimage.jpg" alt="Virginia Woolf 的《一间自己的房间》"/>
| 特征 | 值 |
|---|---|
| 超类角色: | img |
| 相关概念: | EPUB cover [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-credit
(角色)
对来自第三方来源的整合内容来源的致谢,例如照片。 通常标识创作者、版权以及任何复用限制。
<p role="doc-credit">
第 62 页,表 3.1,出自 <cite>“成本效益分析的经济学基础”</cite>
作者 A. M. Garber 和 C. E. Phelps …
</p>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB credit [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-credits
(角色)
致谢项的集合。
<section role="doc-credits">
<h2>照片致谢</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB credits [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-dedication (角色)
位于作品开头的题献,通常献给一位或多位与 作者亲近的人。
<p role="doc-dedication">献给我的家人,没有他们,这一切永远不可能实现。</p>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB dedication [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-endnote
(角色)
[在 DPUB-ARIA 1.1 中已弃用] 位于作品末尾或其中 某一节末尾的一组注释之一,为所引用的文本段落提供额外上下文。
doc-endnote 角色最初设计为列表
项使用,但由于 WAI-ARIA 规范中的澄清,它作为
list 角色的子级无效。由于 doc-endnotes 角色已经标识了尾注
章节,因此建议作者在无法使用原生 HTML 元素
来构造条目时,改用 list 和
listitem 角色。
| 特征 | 值 |
|---|---|
| 超类角色: | listitem |
| 相关概念: | EPUB rearnote [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
doc-endnotes (角色)
位于作品末尾或其中某一节末尾的一组注释。
带有 doc-endnotes 角色的元素 MUST
至少包含一个后代列表,用于包含尾注(如果
注释被细分,例如
按章节细分,则该元素会包含多个列表)。
作者 MUST NOT 在尾注中声明具有 doc-footnote 角色的元素,因为这与隐含角色
重复。
作者 MUST NOT 将 doc-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>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB rearnotes [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-epigraph (角色)
置于作品或某一节开头、用于确立主题或营造 氛围的引文。
<blockquote role="doc-epigraph">
<p>“请问你能告诉我,我从这里该往哪条路走吗?”</p>
<p>“这很大程度上取决于你想去哪里,”猫说。</p>
</blockquote>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB epigraph [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-epilogue (角色)
收束或评论作品中的行为和事件的叙事性结尾章节, 通常从未来视角展开。
<section role="doc-epilogue">
<header>
<h2>尾声</h2>
<p>普洛斯彼罗念白</p>
</header>
<p>如今我的魔力已尽数消散,…</p>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB epilogue [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-errata
(角色)
作品首次出版后发现的一组更正,有时称为 勘误。
<section role="doc-errata">
<h2>更正</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB errata [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-example
(角色)
作品中某个关键概念的示例,例如代码清单、案例研究或问题。
<figure role="doc-example">
<figcaption>示例 1 — 你好,世界!</figcaption>
…
</figure>
| 特征 | 值 |
|---|---|
| 超类角色: | figure |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-footnote (角色)
附属信息,例如引文或评论,为所引用的文本段落提供额外上下文。
doc-footnote 角色仅用于表示
作品正文中出现的单个注释。对于出现在某一节末尾
的注释集合,请参见 doc-endnotes。
<aside id="6baa07af" role="doc-footnote">
* 本研究和类似研究的其他结果可见于 …
</aside>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB footnote [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
doc-foreword (角色)
位于作品之前的引言性章节,通常并非由作品作者撰写。
<section role="doc-foreword">
<h2>前言</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB foreword [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | 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>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB glossary [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-glossref (角色)
对术语表定义的引用。
<p>
这体现在
<a href="#bcc0f155" role="doc-glossref">信用违约互换</a> 的成本中 …
</p>
| 特征 | 值 |
|---|---|
| 超类角色: | link |
| 相关概念: | EPUB glossref [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: |
|
| 需要可访问名称: | 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>
| 特征 | 值 |
|---|---|
| 超类角色: |
navigation
|
| 相关概念: | EPUB index [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-introduction (角色)
通常介绍作品范围或性质的预备章节。
<section role="doc-introduction">
<p>每个人都对营销有一些经验 … </p>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB introduction [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-noteref
(角色)
对脚注或尾注的引用,通常在正文中以数字或符号上标形式出现。
<p> … 正如研究所示。<a href="#fn01" id="fnref01" role="doc-noteref">[1]</a></p>
| 特征 | 值 |
|---|---|
| 超类角色: | link |
| 相关概念: | EPUB noteref [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: |
|
| 需要可访问名称: | 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>
| 特征 | 值 |
|---|---|
| 超类角色: | note |
| 相关概念: | EPUB notice [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-pagebreak (角色)
一个分隔符,表示在内容的静态分页版本中,两个连续页面之间 分页发生前的位置。
分页符定位符也常用于在纯数字出版物中提供静态标记 (即不存在静态分页等效版本的情况)。这些标记提供 一致的导航,不受字体和屏幕尺寸差异影响,否则这些差异可能 影响内容的动态分页。
作者 MUST 确保分页符的名称是最终 用户可理解的页码,用于标识正在开始的页面,以便辅助 技术能根据需要播报该页面 (例如,在用于标识当前页面的命令中)。
分页符定位符 MUST 位于其所
标识页面内容之前。如果页面包含页眉(doc-pageheader),分页符定位符 SHOULD 位于其之前,
即使页眉包含可见页码也是如此。如果页码
位于页眉中所有其他内容之前,则分页符定位符 MAY 与页眉中的页码一起使用。
从静态页面等效版本重现分页符定位符时,有时会出现 单词跨页断字的情况。发生这种情况时,分页符定位符 SHOULD 放在该单词之前或之后,以确保它不会干扰文本转语音 播放。
doc-pageheader (角色)
出现在页面顶部的一段文本,提供当前作品及其所在位置的上下文。 页眉不同于正文,通常遵循重复模板,其中包含(可能被截断的) 项目,例如文档标题、当前章节、作者姓名和页码。
doc-pageheader 角色 MUST 用于
页眉的每个实例。
辅助技术 MAY 允许用户在阅读文档内容时 不被页眉打断而连续阅读。
<section role="doc-pageheader">
<div>战争与和平</div>
<div>321</div>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | 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>
| 特征 | 值 |
|---|---|
| 超类角色: | navigation |
| 相关概念: | EPUB page-list [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-part (角色)作品中的主要结构划分,包含一组处理特定主题、 叙事弧线或类似封装主题的相关章节。
<section role="doc-part">
<h2>第一部分</h2>
<section role="doc-chapter">
<h2>第 1 章</h2>
…
</section>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB part [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-preface
(角色)
位于作品之前的引言性章节,通常由作品作者撰写。
<section role="doc-preface">
<h2>引言:银河系指南</h2>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB preface [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-prologue (角色)
为作品设定背景的引言性章节,通常是叙事的一部分。
<section role="doc-prologue">
<header>
<h2>序幕</h2>
<p>合唱队</p>
</header>
<p>两个家族,门第相当,…</p>
…
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | landmark |
| 相关概念: | EPUB prologue [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | 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>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB pullquote [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-qna (角色)以一系列问题和答案构成的内容章节,例如访谈或 常见问题列表。
<section role="doc-qna">
<h2>作者访谈</h2>
<dl>
<dt>问:你是什么时候开始写这本书的?</dt>
<dd>答:我第一次有这个想法是在 …</dd>
…
</dl>
</section>
| 特征 | 值 |
|---|---|
| 超类角色: | section |
| 相关概念: | EPUB qna [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
doc-subtitle (角色)
作品、或其中某一节或组件的解释性或替代标题。
<header>
<h2>第 2 章 战斗</h2>
<p role="doc-subtitle">再次冲向突破口</p>
</header>
| 特征 | 值 |
|---|---|
| 超类角色: | sectionhead |
| 相关概念: | EPUB subtitle [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: |
|
| 需要可访问名称: | False |
doc-tip (角色)有助于阐明内容某个方面或帮助理解内容的信息。
<aside role="doc-tip">
<h3>提示</h3>
<p>你可以把一个变量赋予一个新值,该新值是包含
其先前值的表达式的结果。</p>
</aside>
| 特征 | 值 |
|---|---|
| 超类角色: | note |
| 相关概念: | EPUB help [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | 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>
| 特征 | 值 |
|---|---|
| 超类角色: | navigation |
| 相关概念: | EPUB toc [EPUB-SSV-11] |
| 继承的状态和属性: |
|
| 名称来源: | 作者 |
| 需要可访问名称: | False |
本节是非规范性的。
本规范未引入新的安全注意事项。
本节是非规范性的。
根据 Web 平台 设计原则,本规范不提供用于确定信息是否正被辅助技术使用的程序化 接口。然而,本规范确实允许作者向辅助技术用户呈现与 非辅助技术用户可获得信息不同的信息。这可以 使用 DPUB-ARIA 规范的许多特性实现,正如这也可以使用 Web 技术栈的许多其他部分实现一样。这种内容差异可能被滥用于对 辅助技术用户进行主动指纹识别。
本节是非规范性的。
doc-biblioentry 重新添加超类角色doc-bibliography 和 doc-endnotes 的列表项后代暗示为
doc-biblioentry 和 doc-endnote 的要求
doc-footnote 角色。参见
议题 38。
doc-part 的必需可访问名称改为
false,以匹配其他地标角色。参见
议题 34。
doc-pageheader 和 doc-pagefooter 角色。参见 议题 28。doc-pagebreak
的名称是正在
开始的页面的页码。参见 议题 27。
term 和 definition 作为 doc-glossary 的必需子级,以适应构建术语表的各种
方式。参见
议题 9。
doc-pagebreak
名称应为最终用户可理解的名称。参见 议题 17。doc-example 的超类改为
figure
以兼容在 HTML figure 上使用。参见
议题 19。
doc-biblioentry 和 doc-endnote 角色无法被识别为
list
的子级,弃用了这些角色。参见
议题 15。
doc-pagebreak
以允许名称来自内容。参见 议题 12。
doc-pullquote
的超类修正为 section,以匹配 [dpub-aam-1.0] 中的映射。参见
议题 7。
doc-subtitle 以
允许名称来自内容。参见 议题 6。本节是非规范性的。
以下人员为本文档的制定作出了贡献:
本出版物部分由美国联邦资金资助,资金来自教育部、 国家残障、独立生活与康复研究所(NIDILRR),最初 合同编号为 ED-OSE-10-C-0067,随后合同编号为 HHSP23301500054C,目前 为 HHS75P00120P00168。本出版物内容不一定反映 美国教育部的观点或政策,提及商品名、商业产品或组织 也不意味着美国政府认可。