デジタル出版 WAI-ARIA モジュール 1.1

作品、またはその内部のセクションや抜粋の主要な考え、概念、結論の短い要約。

<section role="doc-abstract" aria-label="概要">
   <p>Webコンテンツのアクセシビリティには、ウィジェット、構造、
      および動作に関するセマンティック情報が必要です…</p>
</section>

作品の実現に対して、人、組織、政府、その他の主体による 重要な貢献を認めるセクションまたは記述。

<section role="doc-acknowledgments">
   <p>…に心からの感謝を表したいと思います。 </p>
</section>

著者または重要人物による締めくくりの記述であり、通常、その内容がどのように 書かれるに至ったか、その意義、またはその時系列以降に 生じた関連する出来事についての洞察を提供します。

<section role="doc-afterword">
   <h2>あとがき: 私がこの本を書いた理由</h2>
   …
</section>

主要コンテンツの後に配置され、内容に情報を与えるが 中心的ではない補足情報のセクション。

<section role="doc-appendix">
   <h2>付録A. 歴史年表</h2>
   …
</section>

ユーザーがコンテンツ内の関連する場所へ戻れるようにするリンク（例: 脚注から その参照箇所へ、または用語集の定義から用語が使われている場所へ）。

<aside id="fn01" role="doc-footnote">
   <a role="doc-backlink" href="#fnref01">1.</a>
   この研究および
   類似の研究の追加結果は…で確認できます
</aside>

[DPUB-ARIA 1.1で非推奨] 参考文献一覧内の外部情報源への単一の参照。biblioentryは通常、 コンテンツ内の参照よりも詳細な情報 （例: 完全な題名、著者、出版社、発行日など）を提供します。

作品内で引用される外部参照の一覧。印刷物またはデジタル情報源を指す場合があります。

doc-bibliographyロールを持つ要素は、 参考文献項目を含む少なくとも1つの子孫リストをMUST含まなければなりません（項目が たとえばアルファベット順に細分化されている場合、その要素は複数のリストを含みます）。

著者は、項目を含むリストにdoc-bibliographyロールを直接適用してはMUST NOTなりません。

<section role="doc-bibliography">
   <h2>選択参考文献</h2>
   <ul>
      …
   </ul>
</section>

参考文献項目への参照。

<p>
   <a role="doc-biblioref"
      href="#b8cab5dd-bc24-459c-9858-7afa9da69b64">Steinbeck</a>が
   その偉大な小説で述べているように…
</p>

作品内の主要な主題別コンテンツセクション。

<section role="doc-chapter">
   <h2>第1章. Loomings.</h2>
   …
</section>

版に固有の制作上の注記の短いセクション（例: 使用された書体の説明）で、 多くの場合、作品の末尾に配置されます。

<section role="doc-colophon" aria-label="書体について">
   <p>この出版物は…を使用して組まれました </p>
</section>

作品を要約する、または物語を締めくくる結論のセクションまたは記述。

<section role="doc-conclusion">
   <h2>まとめ</h2>
   <p>フェミニスト研究における中心的課題は、ステレオタイプを明らかにし、解体することです… </p>
</section>

作品の雰囲気やトーンを設定し、通常は題名と著者を含む画像。

<img role="doc-cover" src="coverimage.jpg" alt="Virginia WoolfによるA Room of One's Own"/>

写真など、第三者の情報源から組み込まれたコンテンツの出所に対する謝辞。 通常、作成者、著作権、および再利用に関する制限を識別します。

<p role="doc-credit">
   A. M. GarberおよびC. E. Phelpsによる<cite>“Economic Foundations of Cost-Effectiveness Analysis”</cite>から
   62ページ、表3.1 …
</p>

クレジットの集合。

<section role="doc-credits">
   <h2>写真クレジット</h2>
   …
</section>

作品の冒頭に置かれる献辞で、通常、著者に近しい1人以上の人物への敬意として宛てられます。

<p role="doc-dedication">これが決して可能ではなかったであろう私の家族へ。</p>

[DPUB-ARIA 1.1で非推奨] 作品またはその内部のセクションの末尾に現れる注記の集合の1つで、 参照された本文箇所に追加の文脈を提供します。

作品またはその内部のセクションの末尾にある注記の集合。

doc-endnotesロールを持つ要素は、 巻末注を含む少なくとも1つの子孫リストをMUST含まなければなりません（注記が細分化されている場合、 たとえば章ごとであれば、その要素は複数のリストを含みます）。

著者は、巻末注内でdoc-footnoteロールを持つ要素を宣言してはMUST NOTなりません。 暗黙のロールと重複するためです。

著者は、巻末注を含むリストにdoc-endnotesロールを直接適用してはMUST NOTなりません。

<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>第I歌</h3>
      <div role="list>
         <div role="listitem">
            <p>1. ここでの頭韻の使用は… </p>
         </div>
         …
      </div>
   </section>
   …
</section>

作品またはセクションの冒頭に置かれ、テーマを示したり雰囲気を 設定したりする引用。

<blockquote role="doc-epigraph">
   <p>「ここからどちらへ行けばよいか、教えていただけますか？」</p>
   <p>「それは、きみがどこへ行きたいかに大きく左右されるね」と猫は言った。</p>
</blockquote>

作品の行動や出来事を締めくくる、またはそれについて述べる物語上の結論セクションで、 通常は未来の視点から記述されます。

<section role="doc-epilogue">
   <header>
      <h2>エピローグ</h2>
      <p>PROSPEROによる発話</p>
   </header>
   <p>今や私の魔法はすべて打ち破られ、…</p>
   …
</section>

作品の初版公開後に発見された訂正の集合。corrigendaと呼ばれることもあります。

<section role="doc-errata">
   <h2>訂正</h2>
   …
</section>

コードリスト、ケーススタディ、問題など、作品の重要な概念を示す例示。

<figure role="doc-example">
   <figcaption>例1 — Hello World!</figcaption>
   …
</figure>

引用や注釈など、参照された本文箇所に追加の文脈を提供する補助情報。

doc-footnoteロールは、作品の本文内に現れる個々の 注記を表すためだけのものです。セクションの末尾に現れる注記の集合については、 doc-endnotesを参照してください。

<aside id="6baa07af" role="doc-footnote">
   * この研究および類似の研究の追加結果は…で確認できます
</aside>

作品の前に置かれる導入セクションで、通常は作品の著者ではない人物によって書かれます。

<section role="doc-foreword">
   <h2>序文</h2>
   …
</section>

コンテンツ内で使用される新しい、一般的でない、または専門的な用語の簡潔な辞書。

用語集の構造は、エンドユーザーが各用語と関連する定義を 識別できるようにする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>

用語集の定義への参照。

<p>
   これは
   <a href="#bcc0f155" role="doc-glossref">クレジット・デフォルト・スワップ</a>のコストに示されています…
</p>

作品で扱われる主要な主題、名称、その他の重要なトピックへのリンクの 詳細な一覧を提供するナビゲーション支援。

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

通常、作品の範囲または性質を紹介する予備的なセクション。

<section role="doc-introduction">
   <p>誰もがマーケティングについて何らかの経験を持っています… </p>
</section>

脚注または巻末注への参照で、通常、本文中に上付きの数字または記号として現れます。

<p> … 研究が示しているように。<a href="#fn01" id="fnref01" role="doc-noteref">[1]</a></p>

ある操作または出来事から生じる可能性のある結果をユーザーに通知します。例には 警告、注意、危険が含まれます。

<section role="doc-notice">
   <img src="warning.png" alt="警告アイコン"/>
   <p>フォントを含められるからといって、含めるべきだとは限りません。
      可読性について慎重に考えてください。また、知的財産を尊重してください。
      優れた無料のオープンソースフォントは数多くあります。</p>
</section>

通知へナビゲートできる必要がある場合、著者はラベルを含めるSHOULDべきです。

<div role="doc-notice" aria-label="爆発の危険">
   <p><em>危険！</em> 反応性物質を混合すると爆発を引き起こす可能性があります。</p>
</div>

静的にページ付けされた版のコンテンツにおいて、連続する2ページ間の区切りが発生する直前の位置を示す区切り。

改ページロケーターは、純粋にデジタルな出版物（すなわち、静的にページ付けされた同等物が存在しない場合）において、 静的なマーカーを提供するためにも一般的に使用されます。これらのマーカーは、フォントや画面サイズの違いに 左右されず一貫したナビゲーションを提供します。そうした違いは、そうでなければ コンテンツの動的なページ付けに影響する可能性があります。

著者は、支援技術が必要に応じてページを通知できるように（例: 現在のページを識別するコマンドで）、 改ページの名前が、開始されるページを識別するエンドユーザーが理解できるページ番号であることを MUST保証しなければなりません。

改ページロケーターは、それが識別するページのコンテンツより前に置かれなければMUSTなりません。 ページにヘッダー（doc-pageheader）が含まれる場合、たとえヘッダーに 可視のページ番号が含まれていても、改ページロケーターはその前に配置されるSHOULDべきです。番号がヘッダー内の他のすべてのコンテンツより 前にある場合、改ページロケーターはページヘッダー内のページ番号とともに使用してもMAYよいです。

静的なページ相当物から改ページロケーターを再現する場合、単語がページをまたいでハイフンで 分割されることがあります。その場合、改ページロケーターは、テキスト読み上げ 再生の妨げにならないように、単語の前または後のいずれかに配置されるSHOULDべきです。

ページの下部に表示され、現在の作品およびその中の位置に関する文脈を提供するテキストのセクション。 ページフッターは本文とは区別され、通常は 文書タイトル、現在のセクション、著者名、ページ番号などの項目（省略される場合あり）を含む反復テンプレートに従います。

doc-pagefooterロールは、ページフッターのすべてのインスタンスで使用されなければMUSTなりません。

doc-pagefooterはdoc-pagebreakを含んではMUST NOTなりません。

doc-pagefooterは脚注（doc-footnote）を含んではMUST NOTなりません。

支援技術は、ページフッターによる中断なしに、ユーザーが文書コンテンツを 連続して読むことを許可してもMAYよいです。

<section role="doc-pagefooter">
   <div>Leo Tolstoy</div>
   <div>321</div>
   …
</section>

ページの上部に表示され、現在の作品およびその中の位置に関する文脈を提供するテキストのセクション。 ページヘッダーは本文とは区別され、通常は 文書タイトル、現在のセクション、著者名、ページ番号などの項目（省略される場合あり）を含む反復テンプレートに従います。

doc-pageheaderロールは、ページヘッダーのすべてのインスタンスで使用されなければMUSTなりません。

支援技術は、ページヘッダーによる中断なしに、ユーザーが文書コンテンツを 連続して読むことを許可してもMAYよいです。

<section role="doc-pageheader">
   <div>War and Peace</div>
   <div>321</div>
   …
</section>

コンテンツ内の改ページへのリンク一覧を提供するナビゲーション支援。

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

特定の主題、物語のまとまり、または類似の内包されたテーマを扱う関連セクションの集合を含む、 作品内の主要な構造的区分。

<section role="doc-part">
   <h2>第1部</h2>
   <section role="doc-chapter">
      <h2>第1章</h2>
      …
   </section>
   …
</section>

作品の前に置かれる導入セクションで、通常は作品の著者によって書かれます。

<section role="doc-preface">
   <h2>はじめに:銀河へのガイド</h2>
   …
</section>

作品の背景を設定する導入セクションで、通常は物語の一部です。

<section role="doc-prologue">
   <header>
      <h2>プロローグ</h2>
      <p>合唱隊</p>
   </header>
   <p>同じ尊厳を持つ二つの家、…</p>
   …
</section>

現在のコンテンツから特徴的に配置または強調された引用であり、トピックに注意を引いたり 重要な点を強調したりするために設計されたもの。

別の情報源から引用された一節とは異なり、プルクォートは現在の文書内のテキストの直接の反復です。 そのため、著者は、提示目的の出現箇所が支援技術の利用者から 隠されていることをMUST保証しなければなりません（例: aria-hidden属性を使用する）。

次の例は、別の場所に表示される（例: スクリプト経由で）プルクォートの識別を示しています。 この場合、マークされたテキストは提示目的ではないため、プルクォートは隠されていません。

<p>… 私は死ぬかもしれないが、その前に、私の暴君であり苦しめる者であるお前は、自らの惨めさを照らす太陽を呪うことになる。
   <span id="pq01" role="doc-pullquote">用心せよ、私は恐れを知らず、それゆえ強いのだ。</span>
   私は蛇の狡猾さをもって見張り、その毒で刺すだろう。… </p>

次の例は、テキストを複製するプルクォートを示しています。この引用は提示目的のみであるため 隠されています。

<p>… より良い習慣は成長への道を開き、成長はより大きな幸福につながります。</p>
<aside role="doc-pullquote" aria-hidden="true">
   より良い習慣は成長への道を開き、成長はより大きな幸福につながります。
</aside>

インタビューやよくある質問の一覧など、一連の質問と回答として構造化されたコンテンツのセクション。

<section role="doc-qna">
   <h2>著者へのインタビュー</h2>
   <dl>
      <dt>Q: この本を書き始めたのはいつですか？</dt>
      <dd>A: 最初に着想を得たのは…</dd>
      …
   </dl>
</section>

作品、またはその内部のセクションやコンポーネントに対する説明的または代替の題名。

<header>
   <h2>第2章 戦い</h2>
   <p role="doc-subtitle">もう一度、突破口へ</p>
</header>

コンテンツのある側面を明確にしたり、その理解を助けたりする有用な情報。

<aside role="doc-tip">
   <h3>ヒント</h3>
   <p>変数には、その前の値を含む式の結果である
      新しい値を割り当てることができます。</p>
</aside>

コンテンツ内の主要なセクション見出しへのリンクの順序付き一覧を提供するナビゲーション支援。 目次は作品全体を対象とすることも、その小さなセクションのみを対象とすることもできます。

<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章 Loomings.</a></li>
      …
   </ol>
</nav>