この章では、WAI-ARIAロールモデルへの追加を定義し、すべてのロールの特性とプロパティを説明する。このモジュールで提供されるフィールドの説明については、ARIAロールを参照のこと。
次は、リッチインターネットアプリケーションの著者によって使用されるWAI-ARIAロールのアルファベット順リストである。
doc-abstract （ロール）
作品の主要な考え方、概念、および結論、または、その作品の中のセクションもしくは抜粋の短い要約。
<section role="doc-abstract" aria-label="Abstract">
<p>Accessibility of web content requires semantic information about widgets, structures,
and behaviors …</p>
</section>doc-acknowledgments （ロール）
作品の実現に対する個人、組織、政府、およびその他のエンティティによる重要な貢献を認めるセクションまたはステートメント。
<section role="doc-acknowledgments">
<p>I would like to extend my sincere gratitude to … </p>
</section>doc-afterword （ロール）
著者または重要人物からの締めくくりのステートメント。通常、コンテンツがどのように書かれるようになったのか、その重要性、またはそのタイムライン以降に発生した関連イベントについての洞察を提供する。
<section role="doc-afterword">
<h2>Afterword: Why I Wrote This Book</h2>
…
</section>doc-appendix （ロール）
コンテンツに情報を提供するが、コンテンツの中心ではない、主要コンテンツの後にある補足情報のセクション。
<section role="doc-appendix">
<h2>Appendix A. Historical Timeline</h2>
…
</section>doc-backlink （ロール）
ユーザーがコンテンツ内の関連する場所に戻ることを可能にするリンク（たとえば、脚注からその参照へ、または用語集の定義から用語が使用されている場所へ）。
<aside id="fn01" role="doc-footnote">
<a role="doc-backlink" href="#fnref01">1.</a>
Additional results of this study and
similar studies can be found at …
</aside>doc-biblioentry （ロール）
[DPUB-ARIA 1.1で非推奨]参考文献の外部ソースへの単一の参照。biblioentryは通常、コンテンツ内のその参照よりも詳細な情報を提供する（たとえば、完全なタイトル、著者、発行者、発行日など）。
注
doc-biblioentryロールはリストアイテムとして使用するように設計されているが、WAI-ARIA仕様での説明のため、listロールの子としては不正である。doc-bibliographyロールはすでに参考文献項目のセクションを明確にしているため、ネイティヴHTML要素を使用して項目を構成できない場合、listおよびlistitemロールを使用することを勧める。
doc-bibliography （ロール）
著作物で引用されている外部参照のリスト。印刷またはデジタルソースである可能性がある。
doc-bibliographyロールを運ぶ要素は、参考文献項目を含む少なくとも1つの子孫リストを含まなければならない（項目が細分化されている場合、たとえばアルファベット順の場合、要素には複数のリストが含まれる）。
著者は、doc-bibliographyロールを、項目を含むリストに直接適用してはならない。
<section role="doc-bibliography">
<h2>Select Bibliography</h2>
<ul>
…
</ul>
</section>doc-biblioref （ロール）
参考文献項目への参照。
<p>
As <a role="doc-biblioref"
href="#b8cab5dd-bc24-459c-9858-7afa9da69b64">Steinbeck</a>
says in his great novel …
</p>doc-chapter （ロール）
作品のコンテンツの主要なテーマセクション。
<section role="doc-chapter">
<h2>Chapter 1. Loomings.</h2>
…
</section>doc-colophon （ロール）
多くの場合作品の巻末にある、その版固有のプロダクションノートの短いセクション（使用されている書体の説明など）。
<section role="doc-colophon" aria-label="About the type">
<p>This publication was set using … </p>
</section>doc-conclusion （ロール）
作品を要約するまたは物語を締めくくる最後のセクションまたは文。
<section role="doc-conclusion">
<h2>Summary</h2>
<p>A central task in feminist scholarship is to expose and dismantle the stereotypes … </p>
</section>doc-cover （ロール）
作品の雰囲気やトーンを設定し、通常はタイトルと著者を含む画像。
<img role="doc-cover" src="coverimage.jpg" alt="A Room of One's Own by Virginia Woolf"/>doc-credit （ロール）
写真など、サードパーティソースからの統合されたコンテンツの出典の謝辞。通常、著者、著作権、および再利用に関する制限を明確にする。
<p role="doc-credit">
Page 62, Table 3.1 from <cite>“Economic Foundations of Cost-Effectiveness Analysis”</cite>
by A. M. Garber and C. E. Phelps …
</p>doc-credits （ロール）
クレジットのコレクション。
<section role="doc-credits">
<h2>Photo Credits</h2>
…
</section>doc-dedication （ロール）
作品の先頭にある献辞。通常、作者の近くにいる1人以上の人物に敬意を表して宛てられる。
<p role="doc-dedication">To my family, without whom this would have never been possible.</p>doc-endnote （ロール）
[DPUB-ARIA 1.1で非推奨]作品または作品内のセクションの末尾に見られる、参照される文章の一節に追加のコンテキストを提供する、注釈のコレクションの1つ。
注
doc-endnoteロールはリストアイテムとして使用するように設計されているが、WAI-ARIA仕様での説明のため、listロールの子としては不正である。doc-endnotesロールはすでに文末脚注のセクションを明確にしているため、ネイティヴHTML要素を使用して項目を構成できない場合、listおよびlistitemロールを使用することを勧める。
doc-endnotes （ロール）
作品の末尾またはその作品中のセクションにある注釈のコレクション。
doc-endnotesロールを運ぶ要素には、文末脚注を含む少なくとも1つの子孫リストを含まなければならない（たとえば、章ごとに脚注が細分化されている場合、要素には複数のリストが含まれる）。
著者は、ロールdoc-footnoteをもつ要素を文末脚注内で宣言してはならない。これは、暗黙のロールと重複するためである。
著者は、doc-endnotesロールを文末脚注を含むリストに直接適用してはならない。
<section role="doc-endnotes">
<h2>Notes</h2>
<ol>
<li id="6baa07af">
<p>Additional results of this study can be found at … </p>
</li>
<li id="7b2c0555">
<p>…</p>
</li>
…
</ol>
</section><section role="doc-endnotes">
<h2>Notes</h2>
<section>
<h3>Canto I</h3>
<div role="list>
<div role="listitem">
<p>1. The use of alliteration here … </p>
</div>
…
</div>
</section>
…
</section>doc-epigraph （ロール）
作品の冒頭やセクションに設定される、テーマを確立したり、雰囲気を設定したりする引用文。
<blockquote role="doc-epigraph">
<p>“Would you tell me please, which way I ought to go from here?”</p>
<p>“That depends a good deal on where you want to get to,” said the cat.</p>
</blockquote>doc-epilogue （ロール）
通常は将来の観点から、作品の行動と出来事についてまとめたりコメントしたりする物語の結びのセクション。
<section role="doc-epilogue">
<header>
<h2>Epilogue</h2>
<p>SPOKEN BY PROSPERO</p>
</header>
<p>Now my charms are all o'erthrown, …</p>
…
</section>doc-errata （ロール）
作品の最初の出版後に発見された一連の訂正。正誤表と呼ばれることもある。
<section role="doc-errata">
<h2>Corrections</h2>
…
</section>doc-example （ロール）
コードリスト、ケーススタディ、問題点など、作品の主要なコンセプトの図解。
<figure role="doc-example">
<figcaption>Example 1 — Hello World!</figcaption>
…
</figure>doc-foreword （ロール）
作品の前置きをする紹介セクションで、典型的には作品の著者によって書かれていない。
<section role="doc-foreword">
<h2>Foreword</h2>
…
</section>doc-glossary （ロール）
コンテンツで使用されている新しい、まれな、または特殊な用語の簡潔な辞書。
用語集の構造は、エンドユーザーが各用語とそれに関連する定義を特定できるようにすべきである（たとえば、[HTML] dfn要素を使用して）。
<section role="doc-glossary" aria-label="glossary">
<dl>
…
<dt id="bcc0f155"><dfn>Credit default swap</dfn></dt>
<dd>
A credit default swap effectively insures against
default by a borrower.
</dd>
…
</dl>
</section><section role="doc-glossary" aria-labelledby="glosshd">
<h2 id="glosshd">Glossay of Technical Terms</h2>
<ul>
<li id="gtt00110001"><dfn>algorithm</dfn> A set of rules …</li>
…
</ul>
</section>doc-glossref （ロール）
用語集の定義への参照。
<p>
This is indicated in the cost of a
<a href="#bcc0f155" role="doc-glossref">credit default swap</a> …
</p>doc-index （ロール）
主要な主題、名前、および作品で扱われるその他の重要な話題へのリンクの詳細なリストを提供するナビゲーション支援。
<section role="doc-index">
<h2>Index</h2>
<section>
<h2>A</h2>
<ul>
<li>A/B testing, <a href="chapter03.xhtml#page230">230</a></li>
…
</ul>
</section>
…
</section>doc-introduction （ロール）
典型的に、作品の範囲または種別を紹介する前付けセクション。
<section role="doc-introduction">
<p>Everyone has some experience with marketing … </p>
</section>doc-noteref （ロール）
脚注または文末脚注への参照。典型的には、テキストの本文に上付きの数字または記号として表示される。
<p> … as studies have shown.<a href="#fn01" id="fnref01" role="doc-noteref">[1]</a></p>doc-chapter （ロール）
動作またはイベントから発生する可能性のある結果をユーザーに通知する。例としては、警告、注意、危険などがある。
<section role="doc-notice">
<img src="warning.png" alt="warning icon"/>
<p>Just because you can include a font doesn’t mean you should.
Think carefully about readability. Also, be respectful of intellectual property.
There are many excellent free open-source fonts available.</p>
</section>通知をナビゲートする必要がある場合、著者はラベルを含めるべきである。
<div role="doc-notice" aria-label="Explosion Risk">
<p><em>Danger!</em> Mixing reactive materials may cause an explosion.</p>
</div>doc-pagebreak （ロール）
コンテンツの静的にページ付けされたバージョンで、2つの連続するページ間で改ページが発生する前の位置を示すセパレーター。
改ページロケーターはまた、純粋なデジタル出版物（すなわち、静的にページ化された同等のものが存在しない場合）において静的マーカーを提供するために一般に使用される。これらのマーカーは、コンテンツの動的なページ付けに影響を与える可能性のあるフォントおよび画面サイズの違いにかかわらず、一貫したナビゲーションを提供する。
著者は、支援技術が必要に応じてページを通知できるように、改ページの名前が、開始するページを特定するエンドユーザーの使用可能なページ番号であることを保証しなければならない（たとえば、現在のページを特定するコマンドで）。
改ページロケーターは、それが特定するページの内容の前に置かなければならない。ページがヘッダー（doc-pageheader）を含む場合、たとえヘッダーに可視のページ番号が含まれていても、改ページロケーターはその前に配置されるべきである。改ページロケーターは、ページ番号がヘッダー内の他のすべてのコンテンツよりも前にある場合、ページヘッダー内のページ番号とともに使用してもよい。
静的ページ相当のものから改ページロケーターを再現する場合、単語がページにまたがってハイフネーションされることがある。このような場合、テキスト読み上げの再生を妨げないように、単語の前または後に改ページロケーターを配置すべきである。
次の例は、デジタル文書の改ページをマークアップするための3つの同等のパターンを示している。明示的なページ番号が提供されない場合、aria-labelまたはtitle属性のいずれかを使用して、アクセシブルな名前を割り当てることができる。
<hr id="pg04" role="doc-pagebreak" aria-label="4"/>
<span id="pg04" role="doc-pagebreak" title="4"/>
<div id="pg04" role="doc-pagebreak">4</div>doc-pagelist （ロール）
コンテンツの改ページへのリンクのリストを提供するナビゲーション支援。
<nav role="doc-pagelist">
<h2>Pages</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-part （ロール）
特定の主題、ストーリーアーク、または同様の要約されたテーマを扱う一連の関連セクションを含む作品の主要な構造的部分。
<section role="doc-part">
<h2>Part One</h2>
<section role="doc-chapter">
<h2>Chapter 1</h2>
…
</section>
…
</section>doc-preface （ロール）
作品の前置きをする紹介セクションで、典型的には作品の著者によって書かれている。
<section role="doc-preface">
<h2>Introduction:A Guide to the Galaxy</h2>
…
</section>doc-prologue （ロール）
作品の背景を設定する紹介セクションで、典型的には物語の一部である。
<section role="doc-prologue">
<header>
<h2>Prologue</h2>
<p>Chorus</p>
</header>
<p>Two households, both alike in dignity, …</p>
…
</section>doc-pullquote （ロール）
トピックに注目を集める、または重要なポイントを強調したりすることを意図する、現在のコンテンツからの明確に配置または強調表示された引用。
別のソースから引用された一節とは異なり、プルクォートは現在の文書内のテキストの直接の繰り返しである。その結果、著者は、プレゼンテーションの存在が支援技術のユーザーから隠されていることを保証しなければならない（たとえば、aria-hidden属性を使用する）。
次の例は、他の場所（台本など）に表示されるプルクォートの識別を示している。この場合、マークされたテキストはプレゼンテーショナルではないため、プルクォートは隠されない。
<p>… I may die, but first you, my tyrant and tormentor, shall curse the sun that gazes on your misery.
<span id="pq01" role="doc-pullquote">Beware, for I am fearless and therefore powerful.</span>
I will watch with the wiliness of a snake, that I may sting with its venom. … </p>次の例は、テキストを複製するプルクォートを示している。この引用は、プレゼンテーションのみを目的としているため、隠されている。
<p>… Better habits pave the way to growth, and growth leads to greater happiness.</p>
<aside role="doc-pullquote" aria-hidden="true">
Better habits pave the way to growth, and growth leads to greater happiness.
</aside>doc-qna （ロール）
インタビューやよくある質問のリストなど、一連の質問と回答として構成されたコンテンツのセクション。
<section role="doc-qna">
<h2>Interview with the Author</h2>
<dl>
<dt>Q: When did you begin writing this book?</dt>
<dd>A: I first got the idea …</dd>
…
</dl>
</section>doc-subtitle （ロール）
作品の説明もしくは代替タイトル、またはその作品の中のセクションもしくはコンポーネント。
<header>
<h2>Chapter 2 The Battle</h2>
<p role="doc-subtitle">Once more unto the breach</p>
</header>doc-tip （ロール）
コンテンツのいくつかの観点を明確にする、またはコンテンツの理解を助けるのに有用な情報。
<aside role="doc-tip">
<h3>Tip</h3>
<p>You can assign a variable a new value that is the result
of an expression involving its previous value.</p>
</aside>doc-toc （ロール）
コンテンツの主要なセクション見出しへのリンクの順序付きリストを提供するナビゲーション支援。目次は、作品全体をカバーすることもあれば、作品のごく一部をカバーすることもある。
<nav role="doc-toc">
<h2>Contents</h2>
<ol role="directory">
<li><a href="preface_001.xhtml">Original Transcriber’s Notes:</a></li>
<li><a href="introduction_001.xhtml">ETYMOLOGY.</a></li>
<li><a href="epigraph_001.xhtml">EXTRACTS (Supplied by a Sub-Sub-Librarian).</a></li>
<li><a href="chapter_001.xhtml">Chapter 1. Loomings.</a></li>
…
</ol>
</nav>RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4