デジタル出版アクセシビリティ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) は、ユーザー エージェント が Digital Publishing WAI-ARIA Module [dpub-aria-1.1] マークアップをプラットフォームの アクセシビリティ API にどのようにマッピングするかを定義します。これは、 ユーザーエージェントにおけるアクセシビリティを担当し、デジタル出版向けに作成されたアクセシビリティコンテンツを サポートできるようにする開発者を対象としています。

この文書の位置付け

この節では、この文書の公開時点における位置付けを説明します。現在の W3C 公開物の一覧、およびこの技術報告の最新版は、 W3C 標準および草案 索引（ https://www.w3.org/TR/）で確認できます。

この仕様の将来の更新では、新機能が取り込まれる可能性があります。

この文書は、Accessible Rich Internet Applications Working Group により、 勧告トラックを用いた 勧告として公開されました。

W3C は、Web の標準としてこの仕様を広く展開することを 推奨します。

W3C 勧告とは、広範な合意形成の後に W3C およびそのメンバーにより承認され、 実装に対する ロイヤリティフリーのライセンス供与 についてワーキンググループメンバーからのコミットメントを有する仕様です。

この文書は、 W3C 特許 ポリシーの下で運営されるグループによって作成されました。 W3C は、このグループの成果物に関連して行われた 特許開示の公開リストを 維持しています。このページには、特許を開示するための手順も含まれています。 ある個人が、その個人が 必須クレーム を含むと信じる特許について実際の知識を有している場合、その情報を W3C 特許ポリシー第6節に従って開示しなければなりません。

この文書には、 2023年11月3日版 W3C プロセス文書が適用されます。

1. 序論

この節は非規範的です。

ユーザーエージェントにおけるこの仕様の実装により、デジタル出版 業界で使用される構造的な書籍構成要素を支援技術へ伝えることで、作成者はよりアクセシブルな電子書籍を 制作できるようになります。これは、ユーザーエージェント向けの Core Accessibility API Mappings 1.1 [CORE-AAM-1.1] および Accessible Name and Description Computation 1.2 [ACCNAME-1.2] 仕様を拡張することで 実現されます。Digital Publishing WAI-ARIA Module で定義されたロールに対する Accessibility API Mapping のガイダンスを提供します。

DPUB-AAM は、 WAI-ARIA Overview で説明されている 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 アプリケーションを可能にするために必要な手順です。適合する ユーザーエージェント は、[CORE-AAM-1.1] の キーボードナビゲーションの サポート要件に適合 MUST。

4. WAI-ARIA からアクセシビリティ API へのマッピング

4.1 WAI-ARIA セマンティクスを公開するための一般規則

この節は、[CORE-AAM-1.1] の WAI-ARIA セマンティクスを公開するための一般規則に適合 MUST。

5. ネイティブ マークアップのセマンティクスと WAI-ARIA との競合

ユーザーエージェントは、[CORE-AAM-1.1] の ネイティブマークアップのセマンティクス と WAI-ARIA との競合に適合 MUST。

6. アクセシビリティ API プロパティへ直接マッピングされない属性の公開

ユーザーエージェントは、[CORE-AAM-1.1] の アクセシビリティ API プロパティへ直接マッピングされない属性の公開 に適合 MUST。

7. ロールマッピング

プラットフォームの アクセシビリティ API には従来、そのプラットフォーム上の 支援技術が期待する、有限個の定義済み ロールの集合があり、 公開できるロールは1つまたは2つだけでした。これに対して、 WAI-ARIA では、空白区切りの有効なロールトークンの順序付き集合として 複数のロールを指定できます。追加のロールは、第一候補のフォント種別がサポートされていない場合に備えて 複数のフォントを指定する概念に似た、フォールバックロールです。

7.1 一般規則

ユーザーエージェントは、[CORE-AAM-1.1] のロールマッピング 一般規則のアクセシビリティ API 計算要件に MUST 適合しなければなりません。

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 の 状態およびオブジェクト プロパティを公開する方法を説明します。ユーザー エージェントは、[CORE-AAM-1.1] の 状態およびプロパティの マッピングに関するアクセシビリティ API 計算要件に MUST 適合しなければなりません。

10. 追加の計算を必要とする 特別な処理

10.1 名前および説明

アクセシブル名または アクセシブル説明を計算する際、ユーザーエージェントは [ACCNAME-1.2] 仕様の テキスト代替 計算と題された節に MUST 適合しなければなりません。

10.2 関係

ユーザーエージェントは、[CORE-AAM-1.1] の 関係に関するアクセシビリティ API 計算要件に MUST 適合しなければなりません。

10.3 グループ内の位置

ユーザーエージェントは、[CORE-AAM-1.1] の グループ内の位置に関する アクセシビリティ API 計算要件に MUST 適合しなければなりません。

11. アクション

ユーザーエージェントは、[CORE-AAM-1.1] の アクションに関するアクセシビリティ API 計算要件に MUST 適合しなければなりません。

12. イベント

ユーザーエージェントは、ユーザー操作、WAI-ARIA の 状態変更、文書内容またはノード可視性の変更、 選択範囲の変更、およびメニューの操作に対して イベントを発火します。適合する ユーザーエージェントは、 [CORE-AAM-1.1] の イベントマッピングを MUST サポートしなければなりません。

13. セキュリティに関する考慮事項

この節は非規範的です。

この仕様は、新たなセキュリティ上の考慮事項を導入しません。

14. プライバシーに関する考慮事項

この節は非規範的です。

Web Platform Design Principles に従い、この仕様は、情報が支援技術によって使用されているかどうかを判定するための プログラム上のインターフェイスを提供しません。しかし、この仕様は、支援技術を使用しないユーザーが利用できる情報とは 異なる情報を、作成者が支援技術のユーザーに提示することを可能にします。これは、Web 技術スタックの 他の多くの部分を用いて可能であるのと同様に、DPUB-ARIA 仕様の多くの機能を使用して可能です。 この内容の差異は、支援技術ユーザーの 能動的フィンガープリンティングを実行するために 悪用される可能性があります。

A. 付録

A.1 変更履歴

A.1.1 最初の公開作業草案以降の実質的な変更

  • 2023年12月1日: それぞれ doc-bibliograph および doc-endnotes の listitem 子孫に doc-biblioentry および doc-endnote を暗示していたマッピングを削除しました。
  • 2023年1月10日: 翻訳可能な値に関する節を追加しました。
  • 2023年1月4日: doc-preface の ATK/AT-SPI マッピングで言及されていた 誤った doc-pagebreak ロールを修正しました。
  • 2023年1月4日: Mac AX API マッピングを更新し、 AXCustomContent フィールドを追加しました。

A.1.2 Digital Publishing Accessibility API Mappings 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 支援資金提供者

この公開物は、米国教育省、National Institute on Disability, Independent Living, and Rehabilitation Research (NIDILRR) からの米国連邦資金により一部助成されました。当初は契約番号 ED-OSE-10-C-0067、 その後は契約番号 HHSP23301500054C、現在は HHS75P00120P00168 に基づいています。この公開物の内容は、 必ずしも米国教育省の見解または方針を反映するものではなく、商標名、商用製品、または組織への言及は、 米国政府による承認を意味するものではありません。

B. 参考文献

B.1 規範的参考文献

[ACCNAME-1.2]
Accessible Name and Description Computation 1.2. Bryan Garaventa; Melanie Sumner. W3C. 2025年5月22日. W3C 作業草案. URL: https://www.w3.org/TR/accname-1.2/
[CORE-AAM-1.1]
Core Accessibility API Mappings 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]
Core Accessibility API Mappings 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]
Digital Publishing WAI-ARIA Module 1.1. Matt Garrish; Tzviya Siegman. W3C. 2025年3月18日. W3C 勧告案. URL: https://www.w3.org/TR/dpub-aria-1.1/
[html]
HTML Standard. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/
[infra]
Infra Standard. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. 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 Standard. Anne van Kesteren. WHATWG. Living Standard. 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]
Accessible Rich Internet Applications (WAI-ARIA) 1.0. James Craig; Michael Cooper et al. W3C. 2014年3月20日. W3C 勧告. URL: https://www.w3.org/TR/wai-aria/