コアアクセシビリティ API マッピング 1.2

W3C 勧告候補草案

この文書についての詳細
このバージョン:
https://www.w3.org/TR/2026/CRD-core-aam-1.2-20260430/
最新公開バージョン:
https://www.w3.org/TR/core-aam-1.2/
最新エディターズドラフト:
https://w3c.github.io/core-aam/
履歴:
https://www.w3.org/standards/history/core-aam-1.2/
コミット履歴
実装レポート:
https://w3c.github.io/test-results/core-aam-1.2/
最新勧告:
https://www.w3.org/TR/core-aam-1.1/
編集者:
Valerie Young (Igalia, S.L.)
(W3C 招待専門家)
旧編集者:
Alexander Surkov (Igalia, S.L.) (2025年8月まで編集者)
Joanmarie Diggs (Igalia, S.L.) (2022年10月まで編集者)
Richard Schwerdtfeger (Knowbility) (2017年10月まで編集者)
Joseph Scheuhammer (Inclusive Design Research Centre, OCAD University) (2017年 5月まで編集者)
Andi Snow-Weaver (IBM) (2012年12月まで編集者)
Aaron Leventhal (IBM) (2009年1月まで編集者)
Michael Cooper (W3C) (2023年7月まで編集者)
プラットフォームマッピングメンテナー:
Benjamin Beaudry (Microsoft Corp.) (UIA)
James Craig (Apple, Inc.) (AX API)
Joanmarie Diggs (Igalia, S.L.) (ATK / AT-SPI)
Alexander Surkov (Igalia, S.L.) (MSAA, IAccessible2)
David Tseng (Google LLC) (Android Accessibility API)
フィードバック:
GitHub w3c/core-aam (プル リクエスト, 新しい課題, 未解決の課題)

概要

この文書は、ユーザー エージェントが Web コンテンツ言語のセマンティクスをアクセシビリティ APIにどのように公開すべきかを説明します。これは、障害のあるユーザーが 支援技術を使用して情報を取得し、情報とやり取りするのに役立ちます。これらの マッピングを文書化することは、アクセシビリティ API によって実装される ロール、状態、プロパティ、およびイベントの相互運用可能な公開を促進し、この情報が著者の意図と一致した形で現れることを保証するのに役立ちます。

この Core Accessibility API Mappings 仕様は、 一般的なキーボードナビゲーションサポート、および Web コンテンツで WAI-ARIA [WAI-ARIA-1.2] によって提供される汎用の ロール、状態、およびプロパティのマッピングを含む、複数のコンテンツ技術にまたがって適用されるサポートを定義します。他の Accessibility API Mappings 仕様は、ネイティブ技術機能や WAI-ARIA 拡張を含む特定の技術について、この Core 仕様に依存し、これを拡張します。この文書は、Core Accessibility API Mappings 1.1 [CORE-AAM-1.1] W3C 勧告のガイダンスを更新し、最終的にはそれに取って代わる予定です。これは、 WAI-ARIA 概要で説明される WAI-ARIA スイートの一部です。

この文書の状態

このセクションは、この文書の公開時点での状態を説明します。現在の W3C 公開物の一覧、およびこの技術報告の最新改訂版は、 W3C 標準および草案 索引で確認できます。

Accessible Rich Internet Applications ワーキンググループは、この仕様のあらゆる側面についてフィードバックを求めています。 フィードバックを提出する際は、関連文書の文脈で課題を検討してください。コメントするには、W3C core-aam GitHub リポジトリに課題を提出してください。これが 実行不可能な場合は、public-aria@w3.org (コメントアーカイブ) にメールを送信してください。進行中の文書更新は、 公開されているエディターズドラフトで閲覧できます。

リビング仕様 — この文書はリビング仕様として維持されています。最新の 規範的バージョンについては、 Core Accessibility API Mappings を参照してください。

この文書は、Accessible Rich Internet Applications ワーキンググループによって、 勧告 トラックを使用する 勧告候補草案として公開されました。

勧告候補としての公開は、 W3C およびそのメンバーによる承認を意味しません。勧告候補草案は、 ワーキンググループが 後続の勧告候補スナップショットに含めることを意図する、以前の勧告候補からの 変更を統合します。

これは草案文書であり、いつでも他の文書によって更新、置換、または廃止される可能性があります。 この文書を進行中の作業以外のものとして引用することは不適切です。

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

この文書は、 2025年8月18日版 W3C プロセス文書によって管理されます。

1. はじめに

このセクションは非規範的です。

Core Accessibility API Mappings は、 WAI-ARIAロール状態、および プロパティが、 プラットフォームのアクセシビリティ API を介してユーザーエージェントによってどのように公開されることが期待されるかを指定します。これは、 WAI-ARIA 仕様を定義しサポートするリソース群の一部であり、 そこには次の文書が含まれます:

WAI-ARIA の概要については、 WAI-ARIA 概要を参照してください。

1.1 アクセシビリティ API

アクセシビリティ API は、ユーザーインターフェイスに関するアクセシビリティ情報を支援 技術に伝達することを可能にします。この情報には次が含まれます:

  1. 説明的プロパティ (ロール、名前、値、位置など)
  2. 一時的な状態 (押下、フォーカスなど)
  3. イベント (テキストが変更された、ボタンがクリックされた、チェックボックスが切り替えられた)
  4. ユーザーが実行できるアクション (クリック、チェック/切り替え、ドラッグなど)
  5. 関係 (親/子、説明/説明対象オブジェクト、前のオブジェクト/次のオブジェクトなど)
  6. テキストコンテンツ

この仕様で扱うアクセシビリティ API は次のとおりです:

WAI-ARIA 1.0 User Agent Implementation Guide には、IAccessibleEx としても知られ、 Microsoft Internet Explorer 8.0 - 11 に実装されていた [UIA-EXPRESS] のマッピングが含まれていました。 新しい実装では、代わりに UI Automation を使用することが強く推奨されます。

ユーザーエージェント開発者が他のアクセシビリティ API を使用して情報を公開する必要がある場合は、その API が動作する プラットフォームの開発者、およびそのプラットフォーム上の支援技術開発者と緊密に協力することが推奨されます。

1.2 アクセシビリティ API の比較

さまざまな技術的および歴史的理由により、アクセシビリティ API はすべて同じように機能するわけではありません。多くの 場合、それぞれがロール、状態、およびプロパティを支援技術にどのように命名または公開するかについて、 単純な一対一の関係はありません。以下のサブセクションでは、一部の API のいくつかの特徴的な性質を説明します。

1.2.1 ATK/AT-SPI

MSAA、IAccessible2、UIA、および AX API はそれぞれ、コンテンツおよびインタラクティブ コンポーネントに関する情報を公開するソフトウェアアプリケーションと、その情報を利用する支援 技術の双方で共有される API を定義します。これに対して、Linux/GNOME はその共有インターフェイスを 2 つの側面に分離し、それぞれを異なるアクセシビリティ API、すなわち ATK または AT-SPI で表します。

ATK は、アクセシビリティ情報を公開するためにソフトウェアによって実装されるインターフェイスを定義するのに対し、AT-SPI は、アクティブなアプリケーションからアクセシビリティ 情報を収集し、それを通常は支援技術である他の関心を持つアプリケーションに中継するデスクトップサービスです。

例えば、GNOME GUI ツールキット [GTK] は、 GTK ウィジェットが自身に関するアクセシビリティ情報を公開できるように、各ウィジェット (menu、 combobox、checkbox など) について ATK の関連する側面を実装します。 その後 AT-SPI が GTK で構築されたアプリケーションからその情報を取得し、 関心を持つ関係者が利用できるようにします。

ATK は実装者に最も関連し、AT-SPI は利用者に関連します。 WAI-ARIA のロール、状態、およびプロパティをマッピングする文脈では、 ユーザーエージェントは実装者であり、ATK を使用します。 支援技術は利用者であり、AT-SPI を使用します。

1.2.2 UIA (UI Automation)

UI Automation は、アプリケーションユーザーインターフェイスのすべての要素をオートメーション要素として表現します。 オートメーション要素はアプリケーションのアクセシビリティツリーのノードを形成し、オートメーションクライアントによって 照会、走査、および操作できます。

UI Automation には中心となる概念がいくつかあります:

  • オートメーション要素 - コントロールおよび一部のアプリケーションコンテンツは、オートメーション要素として提示されます。
  • 要素プロパティ - オートメーション要素には、すべてのオートメーションクライアントが理解できる非依存的な方法で、 ネイティブフレームワーク要素の特性を説明する共通プロパティがいくつかあります。 要素プロパティ値にアクセスする方法はいくつかあり、以下で説明します。
  • コントロールパターン - 異なるフレームワークにおける一般的なインタラクティビティの一部は、 UIA においてコントロール パターンとして表現され、異なるオートメーションクライアントが共通の プログラム的インターフェイスを使用してコントロールとやり取りできるようにします。
  • イベント - 他のアクセシビリティ API と同様に、オートメーション要素は、重要な状態変更について オートメーションプロバイダーがクライアントに通知できるさまざまなイベントをサポートします。

すべてのオートメーション要素は IUIAutomationElement インターフェイスから継承し、 特定のコントロールパターンに固有でないすべてのプロパティは、その インターフェイスを通じて照会できます。UI Automation 要素プロパティにアクセスする方法はいくつかあります:

  • 現在値への直接プロパティアクセサー - Current{PropertyName}、例えば Name プロパティの場合は IUIAutomationElement::CurrentName
  • キャッシュされたプロパティアクセサー - Cached{PropertyName}、例えば Name プロパティの場合は IUIAutomationElement::CachedName。プロバイダーとクライアントがリモート環境で使用される 場合は、キャッシュされた値の使用が推奨されます。
  • GetCurrentPropertyValue に、そのプロパティに対応する UIA プロパティ ID 列挙値を渡して 現在値を取得します。例えば Name プロパティの場合は IUIAutomationElement::GetCurrentPropertyValue(UIA_NamePropertyId) です。
  • GetCachedPropertyValue に、そのプロパティに対応する UIA プロパティ ID 列挙値を渡して キャッシュされた値を取得します。例えば Name プロパティの場合は IUIAutomationElement::GetCachedPropertyValue(UIA_NamePropertyId) です。

特定の UIA コントロールパターンのプロパティは、 関連するコントロールパターンインターフェイスを使用して同じ方法で照会されます。Toggle Pattern を例にすると、 ToggleState プロパティを照会するために、 クライアントは IUIAutomationTogglePattern::CurrentToggleState または IUIAutomationTogglePattern::GetCurrentPropertyValue(UIA_ToggleToggleStatePropertyId) を使用して 現在値を取得できます。

この仕様におけるプロパティマッピングは {PropertyName} を提供し、 プロパティ値にアクセスするすべての具体的な方法を指定するものではありません。オートメーションクライアントは、具体的なニーズおよびコーディングスタイルの 慣例に応じて、上記の慣例を使用して現在値またはキャッシュ値にアクセスできます。

1.2.3 Android Accessibility API

Android のアクセシビリティサービスとアプリケーションはいずれも、ユーザーインターフェイス要素を AccessibilityNodeInfo オブジェクトのツリーとして表現します。アクセシビリティサービスはイベントを受け取り、 AccessibilityNodeInfo ツリーを走査し、プロパティを取得し、ノード上でアクションを実行します。 逆に、Android アプリケーションは、ビューまたはコンポーザブルを構築することによって間接的に、または AccessibilityNodeProvider を介して直接、 AccessibilityNodeInfo ツリーを構築します。その後、イベントを発火し、アクションを処理します。

WAI-ARIA 実装者にとって特に関心があるのは、 AccessibilityNodeInfo および AccessibilityEvent 上のプロパティ、アクション、およびイベントへのマッピングです。

1.2.4 アクセシブルな名前 および説明

各プラットフォームアクセシビリティ API には、 アクセシブルな名前および アクセシブルな説明 プロパティを、 アクセシブルオブジェクトごとに割り当て、取得するための方法が含まれています。これらのオブジェクトは アクセシビリティツリー内に作成されます。これらの プロパティがどのように実装され、何と呼ばれるかは、API によって異なります。

例えば、MSAA では、すべてのアクセシブルオブジェクトaccName プロパティをサポートし、これはオブジェクトの アクセシブルな名前を格納します。 オブジェクトが アクセシブルな説明を持つこともサポートする場合、 MSAA はこのプロパティをオブジェクトの accDescription プロパティに格納します。

ATK を使用するソフトウェアは、オブジェクトの accessible-name および accessible-description プロパティを読み書きできます。さらに、AT-SPI は、それらの プロパティの値を atspi_accessible_get_name および atspi_accessible_get_description 関数を通じて照会できます。

UIA アクセシビリティツリー内のオートメーション要素には Name プロパティがあります。オブジェクトが アクセシブルな説明を持つこともサポートする場合、 UIA はこのプロパティをオブジェクトの FullDescription プロパティに格納します。

オブジェクトのアクセシブルな説明が、 aria-description または aria-describedby によって提供される場合、 それは accessibilityCustomContent API に公開されるべきです。それ以外の場合は、 AXHelp として公開されるべきです。

Android では、アクセシブルな名前は、content description、supplemental description、および text など、 AccessibilityNodeInfo 上で定義される多数のプロパティにマップされます。

詳細については、Accessible Name and Description Computation 仕様を参照してください。

2. 適合性

非規範的と印付けされたセクションに加えて、この仕様内のすべての著作ガイドライン、図、例、および注記は非規範的です。 この仕様内のそれ以外のすべては規範的です。

この文書におけるキーワード MAYMUSTMUST NOTSHOULD、および SHOULD NOT は、 BCP 14 [RFC2119] [RFC8174] に記述されるとおりに解釈されますが、それはここに示すようにすべて 大文字で現れる場合に限られます。

規範的セクションは、この仕様に適合する実装のために、ユーザーエージェントおよび支援技術が 従わなければならない (MUST) 要件を提供します。

非規範的 (参考情報) セクションは、仕様を理解するのに有用な情報を提供します。そのような セクションには推奨される実践の例が含まれる場合がありますが、この仕様に適合するために そのような推奨事項に従うことは要求されません。

2.1 WAI-ARIA で非推奨とされた機能

WAI-ARIA 仕様は、一部の機能を非推奨として一覧にしています。 これは、著者がそのような機能を使用しないことが推奨されることを意味しますが、 それらの機能がレガシーコンテンツで引き続き使用される可能性があることが想定されます。したがって、ユーザーエージェントが これらの機能をアクセシビリティ API にマップし続けることは重要であり、そうすることはこの仕様への 適合性の一部です。WAI-ARIA 仕様の将来のバージョンが、そのような機能を 非推奨から削除済みに変更した場合、それらはマッピングからも削除され、ユーザーエージェントは それらの機能のサポートを継続するよう求められなくなります。

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

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

プラットフォームのアクセシビリティ APIによってサポートされている場合、ユーザーエージェントは、デスクトップアクセシビリティ API の標準メカニズムを通じて、WAI-ARIAセマンティクスを公開します。例えば、 WAI-ARIAウィジェットについては、その ウィジェットが類似のデスクトップウィジェットでどのように公開されるかを比較します。一般に、ほとんどの WAI-ARIA ウィジェット機能は、アクセシビリティ APIロール、値、ブール型の状態、および 関係を通じて公開されます。

WAI-ARIA 1.0 および 1.1 に関して、 アクセシビリティ API は一方向にのみ 動作します。ユーザーエージェントは、アクセシビリティ API を介して WAI-ARIA 情報 (ロール、状態、およびプロパティ) を公開し、AT は同じ API を使用してその情報を取得できます。しかし、逆方向は サポートされていません。WAI-ARIA 1.0 および 1.1 は、 支援技術が WAI-ARIA 情報を直接変更するためのメカニズムを定義していません。

「公開」、「マッピング」、および「含める」という用語は、 アクセシブル オブジェクトノードアクセシビリティツリー内に作成し、 これらのオブジェクトに、アクセシビリティ API 固有の状態およびプロパティを設定することを指します。

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

WAI-ARIA のロール、状態、およびプロパティは、 これらのセマンティクスを持つネイティブホスト言語の 要素が利用できない場合に、セマンティック情報を追加することを意図しており、 一般には、それ自体にネイティブセマンティクスを持たない要素で使用されます。また、意図されたオブジェクトと 類似しているが同一ではないセマンティクスを持つ要素にも使用できます (例えば、入れ子のリストを ツリー構造を表すために使用できます)。この方法は、 WAI-ARIA 実装を持たない古いブラウザーのためのフォールバック戦略の一部である場合や、 転用された要素のネイティブ表示によって必要なスタイルおよび/またはスクリプトの量が 減るために使用される場合があります。以下に概説する場合を除き、ユーザーエージェントは、 ホスト言語のセマンティクスを使用するのではなく、WAI-ARIA セマンティクスを常に使用して、 要素をアクセシビリティ APIにどのように公開するかを定義しなければなりません (MUST)。

ホスト言語は、ロールに対応する暗黙の WAI-ARIA セマンティクスを持つ機能を備えていることがあります。アクセシビリティ API に対応するロールを持つ WAI-ARIA ロールが提供される場合、ユーザーエージェントは、 ホスト言語によってネイティブ要素上で属性が明示的に禁止されている WAI-ARIA 状態およびプロパティをそのロールが必要とする場合を除き、 ネイティブセマンティクスではなく、WAI-ARIA ロールのセマンティクスを処理に 使用しなければなりません (MUST)。 ロールの値は、状態およびプロパティの値と同じようには競合しません。また、通常は転用されない要素上であっても、 著者には WAI-ARIA ロールを提供する正当な理由があると期待されるためです。例えば、スピンボタンは通常、 既定のキーボードサポートの大部分を得るために テキストフィールド (<input type="text">) から構築されます。しかし、ネイティブロールである "text field" は、 スピンボタンの追加機能を適切に伝達しないため、正しくありません。著者は、 コントロールがアクセシビリティ API で適切にマップされるように、 WAI-ARIA ロール spinbutton (<input type="text" role="spinbutton" ...>) を追加します。 対応するロールがアクセシビリティ API に存在しない WAI-ARIA ロールが提供される場合、ユーザーエージェントは、 WAI-ARIA ロールに加えてネイティブセマンティクスを公開してもよいです (MAY)。ホスト言語要素が、 そのセマンティクスまたは構造がネイティブホスト言語セマンティクス、またはそれらのセマンティクスのサブクラスと同等でない WAI-ARIA ロールによって上書きされる場合、Allowed Accessibility Child Roles として指定されたロールを持つ子要素は、 presentation または none を持つものとして扱います。

注記

上記のテキストは、WAI-ARIA 仕様とはわずかに異なります。 ユーザーエージェントがネイティブロールではなく WAI-ARIA ロールを公開するという要件は、 WAI-ARIA ロールからアクセシビリティ API 内の対応するロールへの 直接マッピングがある場合にのみ適用されることが意図されていました。しかし、 WAI-ARIA 仕様におけるその要件の文言は明確ではなく、 実装者によって異なる解釈がされてきました。この要件はここで明確化され、アクセシビリティ API 内のロールへの直接マッピングがない場合には、 ユーザーエージェントがネイティブセマンティクスを公開してもよいことを示す追加の記述が加えられました。 実装に相違があるため、著者には、 WAI-ARIA Authoring Practices Guide において、 アクセシビリティ WAI-ARIA 上で独自のセマンティクスを持つネイティブ要素に、 そのような WAI-ARIA ロールを追加しないよう助言されます。

WAI-ARIA の状態およびプロパティが、同じ暗黙の WAI-ARIA セマンティクスを持つホスト言語機能に対応する場合、 値が同期しなくなると問題になることがあります。例えば、 HTMLchecked 属性と aria-checked 属性が競合する値を持つ可能性があります。したがって、 支援技術に競合する状態およびプロパティを提供することを防ぐために、ホスト言語は、 ホスト言語要素上での WAI-ARIA 属性の使用が、 その要素のネイティブ属性と競合する箇所を明示的に宣言します。ホスト言語が、ある要素について WAI-ARIA属性が ネイティブ属性と直接的なセマンティック競合にあると宣言する場合、ユーザー エージェントはその WAI-ARIA 属性を無視し、代わりに同じ暗黙のセマンティクスを持つホスト 言語属性を使用しなければなりません (MUST)。

ホスト言語は、WAI-ARIA で上書きできない機能も文書化することがあります (これらは「強いネイティブ セマンティクス」と呼ばれます)。これらは、暗黙の WAI-ARIA セマンティクスを持つ機能である場合もあれば、 WAI-ARIA によってセマンティクスが変更された場合に処理が 不確実になる機能である場合もあります。適合性チェッカーは、強い ネイティブセマンティクスを持つ要素上で WAI-ARIA ロールが使用された場合に、 エラーまたは警告を通知することがありますが、ユーザーエージェントは、その要素をアクセシビリティ API に公開する際に、 WAI-ARIA ロールのセマンティクスの値を引き続き使用しなければなりません (MUST)。

3.3 アクセシビリティ API プロパティに直接マップされない属性の公開

プラットフォームのアクセシビリティ APIには、 WAI-ARIA に存在しない機能がある場合があります。同様に、 WAI-ARIA は、公開時点でアクセシビリティ API によってサポートされていない機能を公開します。通常、すべての WAI-ARIA 属性と プラットフォームのアクセシビリティ API の間には、一対一の関係はありません。 WAI-ARIAロール状態、およびプロパティがアクセシビリティ API に直接マップされず、 その APIWAI-ARIA のロール、状態、プロパティ、および それらの値を公開するためのメカニズムがある場合、ユーザーエージェントは そのメカニズムを使用して、次のように WAI-ARIA データを公開しなければなりません (MUST):

注記

MSAA は、 API に直接マップされない属性を公開するための メカニズムを提供しておらず、実装者の間でも、それをどのように行うかについて合意はありません。

ユーザーエージェントは、このメカニズムを通じてロール文字列全体も公開しなければならず (MUST)、 アクセシビリティ API への直接マッピングがある場合であっても、 このメカニズムを通じて WAI-ARIA 属性および値を公開してもよいです (MAY)。

ブラウザー実装者には、関連する情報を公開するための自らの API メソッドを公に文書化することが推奨されます。これにより、 支援技術開発者が、 ユーザー機能をサポートするためにその API を使用できるようになります。

3.4 ロールマッピング

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

3.4.1 一般規則

ユーザーエージェントは、API がそのためのメカニズムをサポートする場合、 WAI-ARIA ロール文字列を公開しなければなりません (MUST)。これにより、支援技術はロールに対して独自の追加処理を行うことができます。

  • MSAA: サポートされていません。ユーザーエージェントは、 MSAAaccRole プロパティに カスタムロールを公開すべきではありません (SHOULD NOT)。
  • IAccessible2: オブジェクト属性ペア (xml-roles:"string") として公開します
  • UIA: AriaRole プロパティとして公開します。 AriaRole property は、空白を区切り文字として使用することで、二次的なロールもサポートできます。
  • ATK/AT-SPI: オブジェクト属性ペア (xml-roles:"string") として公開します

3.4.2 算出ロール

要素の computedrole は、ブラウザーエンジンによって算出された要素のロールを表す文字列です。 computedrole は、主に開発者ツール、仕様適合性、および相互運用性テストの目的で使用されます。

注記

ユーザーエージェントは、このロール文字列を、例えば開発者ツール内、および WebDriver 関数 getComputedRole への応答として提供します。この関数は、 ARIA、HTML-AAM、およびその他の 仕様の相互運用性テストに使用されます。

注記

要素がロールを持っているものの、必要な文脈内に含まれていない場合 (例えば、必要なロール list のアクセシブルな親を持たない、 孤立した listitem)、これはオーサリングエラーですが、ユーザーエージェントの動作は 単一の規則として指定されていません。ほとんどのロールについて、ユーザーエージェントは、 ロールを無視してエラーから回復することも、実装が無害であると判断したシナリオにおいて 著者が意図したロールを尊重することもできます。エンジンが著者のロールエラーをどのように扱うかに関する この寛容さは、[HTML-AAM] のような言語固有のマッピング文書によって 上書きされる場合があることに注意してください。

ホスト言語要素が、有効で非抽象のロールに対する正確な、または同等のマッピングを持たない場合、 関連する Accessibility API Mapping 拡張仕様は、相互運用性テスト目的の戻り値として、一意の computedrole 文字列を指定してもよいです (MAY)。例えば、 [HTML-AAM] における <video> -> "html-video" などです。 しかし、著者は、トークンが有効で定義済みのロール (例えば dpub-chapter) にも一致する場合を除き、 role 属性でホスト言語接頭辞付きの computedrole 文字列 (例えば html-video) を使用してはなりません (MUST NOT)。 ユーザーエージェントは、抽象ロールまたは無効なロールトークンを無視しなければなりません (MUST)。

3.4.3 ロールマッピング表

3.4.3.1 alert
ARIA 仕様 alert
算出ロール

alert

MSAA + IAccessible2 ロール: ROLE_SYSTEM_ALERT
イベント: ユーザーエージェントは EVENT_SYSTEM_ALERT を発火するべきです (SHOULD)。[注記 2]
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: alert
LiveSetting: Assertive (2)
イベント: ユーザーエージェントは system alert イベントを発火するべきです (SHOULD)。[注記 2]
ATK/AT-SPI ロール: ROLE_NOTIFICATION
イベント: ユーザーエージェントは system alert イベントを発火するべきです (SHOULD)。[注記 2]
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationAlert
イベント: ユーザーエージェントは system alert イベントを発火するべきです (SHOULD)。[注記 2]
Android

未定

3.4.3.2 alertdialog
ARIA 仕様 alertdialog
算出ロール

alertdialog

MSAA + IAccessible2 ロール: ROLE_SYSTEM_DIALOG
イベント: ユーザーエージェントは EVENT_SYSTEM_ALERT を発火するべきです (SHOULD)。[注記 2]
UIA コントロールタイプ: Pane
イベント: ユーザーエージェントは system alert イベントを発火するべきです (SHOULD)。[注記 2]
ATK/AT-SPI ロール: ROLE_ALERT
インターフェイス: Window
イベント: ユーザーエージェントは system alert イベントを発火するべきです (SHOULD)。[注記 2]
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationAlertDialog
イベント: ユーザーエージェントは system alert イベントを発火するべきです (SHOULD)。[注記 2]
Android

未定

3.4.3.3 application
ARIA 仕様 application
算出ロール

application

MSAA + IAccessible2 ロール: ROLE_SYSTEM_APPLICATION
UIA コントロールタイプ: Pane
ローカライズされたコントロールタイプ: application
ATK/AT-SPI ロール: ROLE_EMBEDDED
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXWebApplication
Android

未定

3.4.3.4 article
ARIA 仕様 article
算出ロール

article

MSAA + IAccessible2 ロール: ROLE_SYSTEM_DOCUMENT
状態: STATE_SYSTEM_READONLY
オブジェクト属性: xml-roles:article
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: article
ATK/AT-SPI ロール: ROLE_ARTICLE
オブジェクト属性: xml-roles:article
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXDocumentArticle
Android

未定

3.4.3.6 blockquote
ARIA 仕様 blockquote
算出ロール

blockquote

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_BLOCK_QUOTE
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: blockquote
ATK/AT-SPI ロール: ROLE_BLOCK_QUOTE
AX API[注記 1] AXRole: AXGroup
AXSubrole: <nil>
Android

未定

3.4.3.7 aria-pressed および aria-haspopup の既定値を持つ button
ARIA 仕様 button with default values for aria-pressed and aria-haspopup
算出ロール

button

MSAA + IAccessible2 ロール: ROLE_SYSTEM_PUSHBUTTON
UIA コントロールタイプ: Button
ATK/AT-SPI ロール: ROLE_PUSH_BUTTON
AX API[注記 1] AXRole: AXButton
AXSubrole: <nil>
Android

未定

3.4.3.8 aria-haspopup に non-false 値を持つ button
ARIA 仕様 button with non-false value for aria-haspopup
算出ロール

button

MSAA + IAccessible2 ロール: ROLE_SYSTEM_BUTTONMENU
UIA コントロールタイプ: Button
ATK/AT-SPI ロール: ROLE_PUSH_BUTTON
AX API[注記 1] AXRole: AXPopUpButton
AXSubrole: <nil>
Android

未定

3.4.3.9 aria-pressed に 定義済み値を持つ button
ARIA 仕様 button with defined value for aria-pressed
算出ロール

button

MSAA + IAccessible2 ロール: ROLE_SYSTEM_PUSHBUTTON
ロール: IA2_ROLE_TOGGLE_BUTTON
UIA コントロールタイプ: Button
ATK/AT-SPI ロール: ROLE_TOGGLE_BUTTON
AX API[注記 1] AXRole: AXCheckBox
AXSubrole: AXToggle
Android

未定

3.4.3.10 caption
ARIA 仕様 caption
算出ロール

caption

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_CAPTION
UIA コントロールタイプ: Text
ATK/AT-SPI ロール: ROLE_CAPTION
AX API[注記 1] AXRole: AXGroup
AXSubrole: <nil>
Android

未定

3.4.3.11 cell
ARIA 仕様 cell
算出ロール

cell

MSAA + IAccessible2 ロール: ROLE_SYSTEM_CELL
インターフェイス: IAccessibleTableCell
UIA コントロールタイプ: DataItem
ローカライズされたコントロールタイプ: item
コントロールパターン: GridItem
コントロールパターン: TableItem
ATK/AT-SPI ロール: ROLE_TABLE_CELL
インターフェイス: TableCell
AX API[注記 1] AXRole: AXCell
AXSubrole: <nil>
Android

未定

3.4.3.12 checkbox
ARIA 仕様 checkbox
算出ロール

checkbox

MSAA + IAccessible2 ロール: ROLE_SYSTEM_CHECKBUTTON
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
UIA コントロールタイプ: Checkbox
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
ATK/AT-SPI ロール: ROLE_CHECK_BOX
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
AX API[注記 1] AXRole: AXCheckBox
AXSubrole: <nil>
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
Android

未定

3.4.3.13 code
ARIA 仕様 code
算出ロール

code

MSAA + IAccessible2 ロール: IA2_ROLE_TEXT_FRAME
オブジェクト属性: xml-roles:code
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: code
ATK/AT-SPI ロール: ROLE_STATIC
オブジェクト属性: xml-roles:code
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXCodeStyleGroup
Android

未定

3.4.3.14 columnheader
ARIA 仕様 columnheader
算出ロール

columnheader

MSAA + IAccessible2 ロール: ROLE_SYSTEM_COLUMNHEADER
インターフェイス: IAccessibleTableCell
UIA コントロールタイプ: DataItem
ローカライズされたコントロールタイプ: column header
コントロールパターン: GridItem
コントロールパターン: TableItem
ATK/AT-SPI ロール: ROLE_COLUMN_HEADER
インターフェイス: TableCell
AX API[注記 1] AXRole: AXCell
AXSubrole: <nil>
Android

未定

3.4.3.15 combobox
ARIA 仕様 combobox
算出ロール

combobox

MSAA + IAccessible2 ロール: ROLE_SYSTEM_COMBOBOX
状態: STATE_SYSTEM_HASPOPUP
状態: aria-expanded"true" でない場合、STATE_SYSTEM_COLLAPSED
UIA コントロールタイプ: Combobox
ATK/AT-SPI ロール: ROLE_COMBO_BOX
状態: STATE_EXPANDABLE
状態: STATE_HAS_POPUP
AX API[注記 1] AXRole: AXComboBox
AXSubrole: <nil>
Android

未定

3.4.3.16 comment
ARIA 仕様 comment
算出ロール

comment

MSAA + IAccessible2 ロール: IA2_ROLE_COMMENT
オブジェクト属性: xml-roles:comment
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: comment
ATK/AT-SPI ロール: ROLE_COMMENT
オブジェクト属性: xml-roles:comment
AX API[注記 1] AXRole: AXGroup
Android

未定

3.4.3.17 complementary
ARIA 仕様 complementary
算出ロール

complementary

MSAA + IAccessible2 ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:complementary
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: complementary
ランドマークタイプ: Custom
ローカライズされたランドマークタイプ: complementary
ATK/AT-SPI ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:complementary
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXLandmarkComplementary
Android

未定

3.4.3.18 contentinfo
ARIA 仕様 contentinfo
算出ロール

contentinfo

MSAA + IAccessible2 ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:contentinfo
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: content information
ランドマークタイプ: Custom
ローカライズされたランドマークタイプ: content information
ATK/AT-SPI ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:contentinfo
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXLandmarkContentInfo
Android

未定

3.4.3.19 definition
ARIA 仕様 definition
算出ロール

definition

MSAA + IAccessible2 オブジェクト属性: xml-roles:definition
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: definition
ATK/AT-SPI ロール: ROLE_DESCRIPTION_VALUE
オブジェクト属性: xml-roles:definition
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXDefinition
Android

未定

3.4.3.20 deletion
ARIA 仕様 deletion
算出ロール

deletion

MSAA + IAccessible2 ロール: IA2_ROLE_CONTENT_DELETION
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: deletion
ATK/AT-SPI ロール: ROLE_CONTENT_DELETION
オブジェクト属性: xml-roles:deletion
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXDeleteStyleGroup
AXAttributedStringForTextMarkerRange: deletion に含まれるすべてのテキストについて AXIsSuggestedDeletion = 1; を含みます
Android

未定

3.4.3.21 dialog
ARIA 仕様 dialog
算出ロール

dialog

MSAA + IAccessible2 ロール: ROLE_SYSTEM_DIALOG
UIA コントロールタイプ: Pane
ATK/AT-SPI ロール: ROLE_DIALOG
インターフェイス: Window
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationDialog
Android

未定

3.4.3.22 directory (非推奨)
ARIA 仕様 directory
算出ロール

list

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LIST
UIA コントロールタイプ: List
ATK/AT-SPI ロール: ROLE_LIST
AX API[注記 1] AXRole: AXList
AXSubrole: AXContentList
Android

未定

3.4.3.23 document
ARIA 仕様 document
算出ロール

document

MSAA + IAccessible2 ロール: ROLE_SYSTEM_DOCUMENT
状態: STATE_SYSTEM_READONLY
UIA コントロールタイプ: Document
ATK/AT-SPI ロール: ROLE_DOCUMENT_FRAME
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXDocument
Android

未定

3.4.3.24 emphasis
ARIA 仕様 emphasis
算出ロール

emphasis

MSAA + IAccessible2 ロール: IA2_ROLE_TEXT_FRAME
オブジェクト属性: xml-roles:emphasis
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: emphasis
ATK/AT-SPI ロール: ROLE_STATIC
オブジェクト属性: xml-roles:emphasis
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXEmphasisStyleGroup
Android

未定

3.4.3.25 feed
ARIA 仕様 feed
算出ロール

feed

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
オブジェクト属性: xml-roles:feed
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: feed
ATK/AT-SPI ロール: ROLE_PANEL
オブジェクト属性: xml-roles:feed
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationGroup
Android

未定

3.4.3.26 figure
ARIA 仕様 figure
算出ロール

figure

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
オブジェクト属性: xml-roles:figure
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: figure
ATK/AT-SPI ロール: ROLE_PANEL
オブジェクト属性: xml-roles:figure
AX API[注記 1] AXRole: AXGroup
AXSubrole: <nil>
Android

未定

3.4.3.27 アクセシブルな 名前を持つ form
ARIA 仕様 form with an accessible name
算出ロール

form

MSAA + IAccessible2 ロール: IA2_ROLE_FORM
オブジェクト属性: xml-roles:form
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: form
ランドマークタイプ: Form
ATK/AT-SPI ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:form
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXLandmarkForm
Android

未定

3.4.3.28 アクセシブルな 名前を持たない form
ARIA 仕様 form without an accessible name
算出ロール

form

MSAA + IAccessible2 要素をランドマークとして 公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
UIA 要素をランドマークとして 公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
ATK/AT-SPI 要素をランドマークとして 公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
AX API[注記 1] 要素をランドマークとして 公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
Android

未定

3.4.3.29 generic
ARIA 仕様 generic
算出ロール

generic

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_SECTION
UIA コントロールタイプ: Group
ATK/AT-SPI ロール: ROLE_SECTION
AX API[注記 1] AXRole: AXGroup
AXSubrole: <nil>
Android

未定

3.4.3.30 grid
ARIA 仕様 grid
算出ロール

grid

MSAA + IAccessible2 ロール: ROLE_SYSTEM_TABLE
オブジェクト属性: xml-roles:grid
インターフェイス: IAccessibleTable2
メソッド: IAccessible::accSelect()
メソッド: IAccessible::get_accSelection()
UIA コントロールタイプ: DataGrid
コントロールパターン: Grid
コントロールパターン: Table
コントロールパターン: Selection
ATK/AT-SPI ロール: ROLE_TABLE
オブジェクト属性: xml-roles:grid
インターフェイス: Table
インターフェイス: Selection

WAI-ARIA は、 アクセシビリティ API を介した選択の変更を サポートしていないため、ユーザーエージェントは、選択を変更する手段を提供する すべての Selection メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXTable
AXSubrole: <nil>
AXColumnHeaderUIElements: columnheader 要素へのポインターの リスト
AXHeader: それらの columnheader 要素を含む行またはグループへの ポインター
AXRowHeaderUIElements: rowheader 要素へのポインターの リスト
Android

未定

3.4.3.31 gridcell
ARIA 仕様 gridcell
算出ロール

gridcell

MSAA + IAccessible2 ロール: ROLE_SYSTEM_CELL
インターフェイス: IAccessibleTableCell
UIA コントロールタイプ: DataItem
ローカライズされたコントロールタイプ: item
コントロールパターン: SelectionItem
コントロールパターン: GridItem
コントロールパターン: TableItem
SelectionItem.SelectionContainer: それを含む grid
ATK/AT-SPI ロール: ROLE_TABLE_CELL
インターフェイス: TableCell
AX API[注記 1] AXRole: AXCell
AXSubrole: <nil>
Android

未定

3.4.3.32 group
ARIA 仕様 group
算出ロール

group

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
UIA コントロールタイプ: Group
ATK/AT-SPI ロール: ROLE_PANEL
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationGroup
Android

未定

3.4.3.33 heading
ARIA 仕様 heading
算出ロール

heading

MSAA + IAccessible2 ロール: IA2_ROLE_HEADING
オブジェクト属性: xml-roles:heading
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: heading
ATK/AT-SPI ロール: ROLE_HEADING
AX API[注記 1] AXRole: AXHeading
AXSubrole: <nil>
Android

未定

3.4.3.34 image
ARIA 仕様 image
算出ロール

image

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GRAPHIC
インターフェイス: IAccessibleImage
UIA コントロールタイプ: Image
ATK/AT-SPI ロール: ROLE_IMAGE
インターフェイス: Image
AX API[注記 1] AXRole: AXImage
AXSubrole: <nil>
Android

未定

3.4.3.35 img
ARIA 仕様 img
算出ロール

image

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GRAPHIC
インターフェイス: IAccessibleImage
UIA コントロールタイプ: Image
ATK/AT-SPI ロール: ROLE_IMAGE
インターフェイス: Image
AX API[注記 1] AXRole: AXImage
AXSubrole: <nil>
Android

未定

3.4.3.36 insertion
ARIA 仕様 insertion
算出ロール

insertion

MSAA + IAccessible2 ロール: IA2_ROLE_CONTENT_INSERTION
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: insertion
ATK/AT-SPI ロール: ROLE_CONTENT_INSERTION
オブジェクト属性: xml-roles:insertion
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXInsertStyleGroup
AXAttributedStringForTextMarkerRange: insertion に含まれるすべてのテキストについて AXIsSuggestedInsertion = 1; を含みます
Android

未定

3.4.3.38 list
ARIA 仕様 list
算出ロール

list

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LIST
状態: STATE_SYSTEM_READONLY
UIA コントロールタイプ: List
ATK/AT-SPI ロール: ROLE_LIST
AX API[注記 1] AXRole: AXList
AXSubrole: AXContentList
Android

未定

3.4.3.39 combobox の アクセシビリティ親を持たない listbox
ARIA 仕様 listbox
算出ロール

listbox

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LIST
メソッド: IAccessible::accSelect()
メソッド: IAccessible::get_accSelection()
UIA コントロールタイプ: List
コントロールパターン: Selection
ATK/AT-SPI ロール: ROLE_LIST_BOX
インターフェイス: Selection

WAI-ARIA は、 アクセシビリティ API を介した選択の変更を サポートしていないため、ユーザーエージェントは、選択を変更する手段を提供する すべての Selection メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXList
AXSubrole: <nil>
Android

未定

3.4.3.40 combobox のアクセシビリティ親を持つ listbox
ARIA 仕様 listbox
算出ロール

listbox

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LIST
メソッド: IAccessible::accSelect()
メソッド: IAccessible::get_accSelection()
UIA コントロールタイプ: List
コントロールパターン: Selection
ATK/AT-SPI ロール: ROLE_MENU
インターフェイス: Selection

WAI-ARIA は、 アクセシビリティ API を介した選択の変更を サポートしていないため、ユーザーエージェントは、選択を変更する手段を提供する すべての Selection メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXList
AXSubrole: <nil>
Android

未定

3.4.3.41 listitem
ARIA 仕様 listitem
算出ロール

listitem

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LISTITEM
状態: STATE_SYSTEM_READONLY
UIA コントロールタイプ: ListItem
コントロールパターン: SelectionItem
SelectionItem.SelectionContainer: それを含む list
ATK/AT-SPI ロール: ROLE_LIST_ITEM
AX API[注記 1] AXRole: AXGroup
AXSubrole: <nil>
Android

未定

3.4.3.42 log
ARIA 仕様 log
算出ロール

log

MSAA + IAccessible2 オブジェクト属性: xml-roles:log
オブジェクト属性: container-live:polite
オブジェクト属性: live:polite
オブジェクト属性: container-live-role:log
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: log
LiveSetting: Polite (1)
ATK/AT-SPI ロール: ROLE_LOG
オブジェクト属性: xml-roles:log
オブジェクト属性: container-live:polite
オブジェクト属性: live:polite
オブジェクト属性: container-live-role:log
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationLog
Android

未定

3.4.3.43 main
ARIA 仕様 main
算出ロール

main

MSAA + IAccessible2 ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:main
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: main
ランドマークタイプ: Main
ATK/AT-SPI ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:main
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXLandmarkMain
Android

未定

3.4.3.44 mark
ARIA 仕様 mark
算出ロール

mark

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_MARK
オブジェクト属性: xml-roles:mark
UIA コントロールタイプ: Group
ATK/AT-SPI ロール: ROLE_MARK
オブジェクト属性: xml-roles:mark
AX API[注記 1] AXRole: AXGroup
AXRoleDescription: highlight
AXAttributedStringForTextMarkerRange: mark に含まれるすべてのテキストについて AXHighlight = 1; を含みます
Android

未定

3.4.3.45 marquee
ARIA 仕様 marquee
算出ロール

marquee

MSAA + IAccessible2 ロール: ROLE_SYSTEM_ANIMATION
オブジェクト属性: xml-roles:marquee
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: marquee
ATK/AT-SPI ロール: ROLE_MARQUEE
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationMarquee
Android

未定

3.4.3.46 math
ARIA 仕様 math
算出ロール

math

MSAA + IAccessible2 ロール: ROLE_SYSTEM_EQUATION
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: math
ATK/AT-SPI ロール: ROLE_MATH
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXDocumentMath
Android

未定

3.4.3.52 meter
ARIA 仕様 meter
算出ロール

meter

MSAA + IAccessible2 ロール: IA2_ROLE_LEVEL_BAR
インターフェイス: IAccessibleValue
UIA コントロールタイプ: ProgressBar
ローカライズされたコントロールタイプ: meter
コントロールパターン: RangeValue
ATK/AT-SPI ロール: ROLE_LEVEL_BAR
インターフェイス: Value
AX API[注記 1] AXRole: AXLevelIndicator
AXSubrole: AXMeter
Android

未定

3.4.3.54 none
ARIA 仕様 none
算出ロール

none

MSAA + IAccessible2

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを IA2_ROLE_TEXT_FRAME として公開します。ユーザー エージェントは、空の子孫を アクセシビリティ ツリーから刈り込むべきです (SHOULD)。

UIA

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを text パターンを使用して公開します。ユーザー エージェントは、空の子孫を アクセシビリティ ツリーから刈り込むべきです (SHOULD)。

ATK/AT-SPI

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを ROLE_SECTION として公開します。ユーザーエージェントは、空の子孫を アクセシビリティ ツリーから刈り込むべきです (SHOULD)。

AX API[注記 1]

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを AXGroup として公開します。ユーザーエージェントは、空の子孫をアクセシビリティ ツリーから刈り込むべきです (SHOULD)。

Android

未定

3.4.3.55 note
ARIA 仕様 note
算出ロール

note

MSAA + IAccessible2 ロール: IA2_ROLE_NOTE
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: note
ATK/AT-SPI ロール: ROLE_COMMENT
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXDocumentNote
Android

未定

3.4.3.56 combobox 内にない option
ARIA 仕様 option not inside combobox
算出ロール

option

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LISTITEM
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
UIA コントロールタイプ: ListItem
コントロールパターン: Invoke
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
ATK/AT-SPI ロール: ROLE_LIST_ITEM
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
AX API[注記 1] AXRole: AXStaticText
AXSubrole: <nil>
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
Android

未定

3.4.3.57 combobox 内の option
ARIA 仕様 option inside combobox
算出ロール

option

MSAA + IAccessible2 ロール: ROLE_SYSTEM_LISTITEM
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
UIA コントロールタイプ: ListItem
コントロールパターン: Invoke
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
ATK/AT-SPI ロール: ROLE_MENU_ITEM
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
AX API[注記 1] AXRole: AXStaticText
AXSubrole: <nil>
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
Android

未定

3.4.3.58 paragraph
ARIA 仕様 paragraph
算出ロール

paragraph

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_PARAGRAPH
UIA コントロールタイプ: Text
ATK/AT-SPI ロール: ROLE_PARAGRAPH
AX API[注記 1] AXRole: AXGroup
AXSubrole: <nil>
Android

未定

3.4.3.59 presentation
ARIA 仕様 presentation
算出ロール

none

MSAA + IAccessible2

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを IA2_ROLE_TEXT_FRAME として公開します。ユーザー エージェントは、空の子孫を アクセシビリティ ツリーから刈り込むべきです (SHOULD)。

UIA

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを text パターンを使用して公開します。ユーザー エージェントは、空の子孫を アクセシビリティ ツリーから刈り込むべきです (SHOULD)。

ATK/AT-SPI

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを ROLE_SECTION として公開します。ユーザーエージェントは、空の子孫を アクセシビリティ ツリーから刈り込むべきです (SHOULD)。

AX API[注記 1]

指定された許可アクセシビリティ子 (例えば、gridcell の子を持つ grid、 listitem の子を持つ list) を持つオブジェクトについて、その子孫が アクセシビリティ ツリー内にある場合、それを AXGroup として公開します。ユーザーエージェントは、空の子孫をアクセシビリティ ツリーから刈り込むべきです (SHOULD)。

Android

未定

3.4.3.60 progressbar
ARIA 仕様 progressbar
算出ロール

progressbar

MSAA + IAccessible2 ロール: ROLE_SYSTEM_PROGRESSBAR
状態: STATE_SYSTEM_READONLY
インターフェイス: IAccessibleValue
UIA コントロールタイプ: ProgressBar
aria-valuenowaria-valuemax、または aria-valuemin が存在する場合、コントロールパターン: RangeValue
ATK/AT-SPI ロール: ROLE_PROGRESS_BAR
インターフェイス: Value

WAI-ARIA は、 アクセシビリティ API を介した値の変更を サポートしていないため、ユーザーエージェントは、値を変更する手段を提供する すべての Value メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXProgressIndicator
AXSubrole: <nil>
Android

未定

3.4.3.61 radio
ARIA 仕様 radio
算出ロール

radio

MSAA + IAccessible2 ロール: ROLE_SYSTEM_RADIOBUTTON
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
UIA コントロールタイプ: RadioButton
コントロールパターン: Toggle
コントロールパターン: SelectionItem
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
ATK/AT-SPI ロール: ROLE_RADIO_BUTTON
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
AX API[注記 1] AXRole: AXRadioButton
AXSubrole: <nil>
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
Android

未定

3.4.3.62 radiogroup
ARIA 仕様 radiogroup
算出ロール

radiogroup

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
UIA コントロールタイプ: List
ATK/AT-SPI ロール: ROLE_PANEL
AX API[注記 1] AXRole: AXRadioGroup
AXSubrole: <nil>
Android

未定

3.4.3.63 アクセシブルな 名前を持つ region
ARIA 仕様 region with an accessible name
算出ロール

region

MSAA + IAccessible2 ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:region
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: region
ランドマークタイプ: Custom
ローカライズされたランドマークタイプ: region
ATK/AT-SPI ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:region
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXLandmarkRegion
Android

未定

3.4.3.64 アクセシブルな 名前を持たない region
ARIA 仕様 region without an accessible name
算出ロール

ネイティブホスト言語ロールを使用します。

MSAA + IAccessible2 要素を ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
UIA 要素を ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
ATK/AT-SPI 要素を ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
AX API[注記 1] 要素を ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
Android

未定

3.4.3.65 treegrid 内にない row
ARIA 仕様 row not inside treegrid
算出ロール

row

MSAA + IAccessible2 ロール: ROLE_SYSTEM_ROW
UIA コントロールタイプ: DataItem
ローカライズされたコントロールタイプ: row
コントロールパターン: SelectionItem
ATK/AT-SPI ロール: ROLE_TABLE_ROW
AX API[注記 1] AXRole: AXRow
AXSubrole: <nil>
Android

未定

3.4.3.66 treegrid 内の row
ARIA 仕様 row inside treegrid
算出ロール

row

MSAA + IAccessible2 ロール: ROLE_SYSTEM_OUTLINEITEM
UIA コントロールタイプ: DataItem
ローカライズされたコントロールタイプ: row
コントロールパターン: SelectionItem
ATK/AT-SPI ロール: ROLE_TABLE_ROW
AX API[注記 1] AXRole: AXRow
AXSubrole: <nil>
Android

未定

3.4.3.67 rowgroup
ARIA 仕様 rowgroup
算出ロール

rowgroup

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
UIA コントロールタイプ: Group
ATK/AT-SPI ロール: ROLE_PANEL
AX API[注記 1] マップされない
Android

未定

3.4.3.68 rowheader
ARIA 仕様 rowheader
算出ロール

rowheader

MSAA + IAccessible2 ロール: ROLE_SYSTEM_ROWHEADER
インターフェイス: IAccessibleTableCell
UIA コントロールタイプ: HeaderItem
ATK/AT-SPI ロール: ROLE_ROW_HEADER
インターフェイス: TableCell
AX API[注記 1] AXRole: AXCell
AXSubrole: <nil>
Android

未定

3.4.3.69 scrollbar
ARIA 仕様 scrollbar
算出ロール

scrollbar

MSAA + IAccessible2 ロール: ROLE_SYSTEM_SCROLLBAR
インターフェイス: IAccessibleValue
UIA コントロールタイプ: ScrollBar
コントロールパターン: RangeValue
ATK/AT-SPI ロール: ROLE_SCROLL_BAR
インターフェイス: Value

WAI-ARIA は、 アクセシビリティ API を介した値の変更を サポートしていないため、ユーザーエージェントは、値を変更する手段を提供する すべての Value メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXScrollBar
AXSubrole: <nil>
Android

未定

3.4.3.72 sectionfooter
ARIA 仕様 sectionfooter
算出ロール

sectionfooter

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
オブジェクト属性: xml-roles:sectionfooter
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: section footer
ATK/AT-SPI ロール: ROLE_FOOTER
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXSectionFooter
AXRoleDescription: section footer
Android

未定

3.4.3.73 sectionheader
ARIA 仕様 sectionheader
算出ロール

sectionheader

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
オブジェクト属性: xml-roles:sectionheader
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: section header
ATK/AT-SPI ロール: ROLE_HEADER
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXSectionHeader
AXRoleDescription: section header
Android

未定

3.4.3.74 separator (フォーカス不可)
ARIA 仕様 separator (フォーカス不可)
算出ロール

seperator

MSAA + IAccessible2 ロール: ROLE_SYSTEM_SEPARATOR
UIA コントロールタイプ: Separator
ATK/AT-SPI ロール: ROLE_SEPARATOR
AX API[注記 1] AXRole: AXSplitter
AXSubrole: <nil>
Android

未定

3.4.3.75 separator (フォーカス可能)
ARIA 仕様 separator (フォーカス可能)
算出ロール

seperator

MSAA + IAccessible2 ロール: ROLE_SYSTEM_SEPARATOR
インターフェイス: IAccessibleValue
UIA コントロールタイプ: Thumb
コントロールパターン: RangeValue
ATK/AT-SPI ロール: ROLE_SEPARATOR
インターフェイス: Value

WAI-ARIA は、 アクセシビリティ API を介した値の変更を サポートしていないため、ユーザーエージェントは、値を変更する手段を提供する すべての Value メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXSplitter
AXSubrole: <nil>
Android

未定

3.4.3.76 slider
ARIA 仕様 slider
算出ロール

slider

MSAA + IAccessible2 ロール: ROLE_SYSTEM_SLIDER
インターフェイス: IAccessibleValue
UIA コントロールタイプ: Slider
コントロールパターン: RangeValue
ATK/AT-SPI ロール: ROLE_SLIDER
インターフェイス: Value

WAI-ARIA は、 アクセシビリティ API を介した値の変更を サポートしていないため、ユーザーエージェントは、値を変更する手段を提供する すべての Value メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXSlider
AXSubrole: <nil>
Android

未定

3.4.3.77 spinbutton
ARIA 仕様 spinbutton
算出ロール

spinbutton

MSAA + IAccessible2 ロール: ROLE_SYSTEM_SPINBUTTON
インターフェイス: IAccessibleValue
UIA コントロールタイプ: Spinner
コントロールパターン: RangeValue
ATK/AT-SPI ロール: ROLE_SPIN_BUTTON
インターフェイス: Value

WAI-ARIA は、 アクセシビリティ API を介した値の変更を サポートしていないため、ユーザーエージェントは、値を変更する手段を提供する すべての Value メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXIncrementor
AXSubrole: <nil>
Android

未定

3.4.3.78 status
ARIA 仕様 status
算出ロール

status

MSAA + IAccessible2 ロール: ROLE_SYSTEM_STATUSBAR
オブジェクト属性: container-live:polite
オブジェクト属性: live:polite
オブジェクト属性: container-live-role:status
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: status
LiveSetting: Polite (1)
ATK/AT-SPI ロール: ROLE_STATUSBAR
オブジェクト属性: container-live:polite
オブジェクト属性: live:polite
オブジェクト属性: container-live-role:status
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationStatus
Android

未定

3.4.3.79 strong
ARIA 仕様 strong
算出ロール

strong

MSAA + IAccessible2 ロール: IA2_ROLE_TEXT_FRAME
オブジェクト属性: xml-roles:strong
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: strong
ATK/AT-SPI ロール: ROLE_STATIC
オブジェクト属性: xml-roles:strong
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXStrongStyleGroup
Android

未定

3.4.3.80 subscript
ARIA 仕様 subscript
算出ロール

subscript

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_TEXT_FRAME
テキスト属性: text-position:sub
UIA コントロールタイプ: Text
使用されるスタイルは、アクセシブルオブジェクト上に実装された TextRange コントロールパターンの IsSubscript 属性によって 公開されます。
ATK/AT-SPI ロール: ROLE_SUBSCRIPT
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXSubscriptStyleGroup
Android

未定

3.4.3.81 suggestion
ARIA 仕様 suggestion
算出ロール

suggestion

MSAA + IAccessible2 ロール: IA2_ROLE_SUGGESTION
オブジェクト属性: xml-roles:suggestion
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: suggestion
ATK/AT-SPI ロール: ROLE_SUGGESTION
オブジェクト属性: xml-roles:suggestion
AX API[注記 1] AXRole: AXGroup
AXAttributedStringForTextMarkerRange: suggestion に含まれるすべてのテキストについて AXIsSuggestion = 1; を含みます
Android

未定

3.4.3.82 superscript
ARIA 仕様 superscript
算出ロール

superscript

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
ロール: IA2_ROLE_TEXT_FRAME
テキスト属性: text-position:super
UIA コントロールタイプ: Text
使用されるスタイルは、アクセシブルオブジェクト上に実装された TextRange コントロールパターンの IsSuperscript 属性によって公開されます。
ATK/AT-SPI ロール: ROLE_SUPERSCRIPT
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXSuperscriptStyleGroup
Android

未定

3.4.3.83 switch
ARIA 仕様 switch
算出ロール

switch

MSAA + IAccessible2 ロール: ROLE_SYSTEM_CHECKBUTTON
ロール: IA2_ROLE_TOGGLE_BUTTON
オブジェクト属性: xml-roles:switch
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
UIA コントロールタイプ: Button
ローカライズされたコントロールタイプ: toggleswitch
コントロールパターン: Toggle
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
ATK/AT-SPI ロール: ROLE_TOGGLE_BUTTON
オブジェクト属性: xml-roles:switch
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
AX API[注記 1] AXRole: AXCheckBox
AXSubrole: AXSwitch
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
Android

未定

3.4.3.84 tab
ARIA 仕様 tab
算出ロール

tab

MSAA + IAccessible2 ロール: ROLE_SYSTEM_PAGETAB
フォーカスが、 tabpanel 内にあり、 aria-labelledby に関連付けられている場合、 状態: STATE_SYSTEM_SELECTED
UIA コントロールタイプ: TabItem
ATK/AT-SPI ロール: ROLE_PAGE_TAB
フォーカスが、tabpanel 内にあり、 aria-labelledby に関連付けられている場合、 状態: STATE_SELECTED
AX API[注記 1] AXRole: AXRadioButton
AXSubrole: AXTabButton
Android

未定

3.4.3.85 table
ARIA 仕様 table
算出ロール

table

MSAA + IAccessible2 ロール: ROLE_SYSTEM_TABLE
オブジェクト属性: xml-roles:table
インターフェイス: IAccessibleTable2
UIA コントロールタイプ: Table
コントロールパターン: Grid
コントロールパターン: Table
ATK/AT-SPI ロール: ROLE_TABLE
オブジェクト属性: xml-roles:table
インターフェイス: Table
AX API[注記 1] AXRole: AXTable
AXSubrole: <nil>
AXColumnHeaderUIElements: columnheader 要素へのポインターの リスト
AXHeader: それらの columnheader 要素を含む行またはグループへの ポインター
AXRowHeaderUIElements: rowheader 要素へのポインターの リスト
Android

未定

3.4.3.86 tablist
ARIA 仕様 tablist
算出ロール

tablist

MSAA + IAccessible2 ロール: ROLE_SYSTEM_PAGETABLIST
メソッド: IAccessible::accSelect()
メソッド: IAccessible::get_accSelection()
UIA コントロールタイプ: Tab
コントロールパターン: Selection
ATK/AT-SPI ロール: ROLE_PAGE_TAB_LIST
インターフェイス: Selection

WAI-ARIA は、 アクセシビリティ API を介した選択の変更を サポートしていないため、ユーザーエージェントは、選択を変更する手段を提供する すべての Selection メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXTabGroup
AXSubrole: <nil>
Android

未定

3.4.3.87 tabpanel
ARIA 仕様 tabpanel
算出ロール

tabpanel

MSAA + IAccessible2 ロール: ROLE_SYSTEM_PANE または ROLE_SYSTEM_PROPERTYPAGE
UIA コントロールタイプ: Pane
ATK/AT-SPI ロール: ROLE_SCROLL_PANE
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXTabPanel
Android

未定

3.4.3.88 term
ARIA 仕様 term
算出ロール

term

MSAA + IAccessible2 ロール: IA2_ROLE_TEXT_FRAME
オブジェクト属性: xml-roles:term
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: term
ATK/AT-SPI ロール: ROLE_DESCRIPTION_TERM
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXTerm
Android

未定

3.4.3.89 aria-multilinefalse の場合の textbox
ARIA 仕様 textbox when aria-multiline is false
算出ロール

textbox

MSAA + IAccessible2 ロール: ROLE_SYSTEM_TEXT
状態: IA2_STATE_SINGLE_LINE
UIA コントロールタイプ: Edit
ATK/AT-SPI ロール: ROLE_ENTRY
状態: STATE_SINGLE_LINE
aria-readonly"true" でない場合、インターフェイス: EditableText
AX API[注記 1] AXRole: AXTextField
AXSubrole: <nil>
Android

未定

3.4.3.90 aria-multilinetrue の場合の textbox
ARIA 仕様 textbox when aria-multiline is true
算出ロール

textbox

MSAA + IAccessible2 ロール: ROLE_SYSTEM_TEXT
状態: IA2_STATE_MULTI_LINE
UIA コントロールタイプ: Edit
ATK/AT-SPI ロール: ROLE_ENTRY
状態: STATE_MULTI_LINE
aria-readonly"true" でない場合、インターフェイス: EditableText
AX API[注記 1] AXRole: AXTextArea
AXSubrole: <nil>
Android

未定

3.4.3.91 time
ARIA 仕様 time
算出ロール

time

MSAA + IAccessible2 ロール: ROLE_SYSTEM_GROUPING
オブジェクト属性: xml-roles:time
UIA コントロールタイプ: Text
ローカライズされたコントロールタイプ: time
注記: 種類が Text の独立した UIA コントロールを作成します。これは、ページのテキストパターン内に範囲のみを 作成する、ほとんどの UIA テキストマッピングとは異なります。
ATK/AT-SPI ロール: ROLE_STATIC
オブジェクト属性: xml-roles:time
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXTimeGroup
Android

未定

3.4.3.92 timer
ARIA 仕様 timer
算出ロール

timer

MSAA + IAccessible2 オブジェクト属性: xml-roles:timer
UIA コントロールタイプ: Group
ローカライズされたコントロールタイプ: timer
ATK/AT-SPI ロール: ROLE_TIMER
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXApplicationTimer
Android

未定

3.4.3.93 toolbar
ARIA 仕様 toolbar
算出ロール

toolbar

MSAA + IAccessible2 ロール: ROLE_SYSTEM_TOOLBAR
UIA コントロールタイプ: ToolBar
ATK/AT-SPI ロール: ROLE_TOOL_BAR
AX API[注記 1] AXRole: AXToolbar
AXSubrole: <nil>
Android

未定

3.4.3.94 tooltip
ARIA 仕様 tooltip
算出ロール

tooltip

MSAA + IAccessible2 ロール: ROLE_SYSTEM_TOOLTIP
UIA コントロールタイプ: ToolTip
ATK/AT-SPI ロール: ROLE_TOOL_TIP
AX API[注記 1] AXRole: AXGroup
AXSubrole: AXUserInterfaceTooltip
Android

未定

3.4.3.95 tree
ARIA 仕様 tree
算出ロール

tree

MSAA + IAccessible2 ロール: ROLE_SYSTEM_OUTLINE
メソッド: IAccessible::accSelect()
メソッド: IAccessible::get_accSelection()
UIA コントロールタイプ: Tree
ATK/AT-SPI ロール: ROLE_TREE
インターフェイス: Selection

WAI-ARIA は、 アクセシビリティ API を介した選択の変更を サポートしていないため、ユーザーエージェントは、選択を変更する手段を提供する すべての Selection メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXOutline
AXSubrole: <nil>
Android

未定

3.4.3.96 treegrid
ARIA 仕様 treegrid
算出ロール

treegrid

MSAA + IAccessible2 ロール: ROLE_SYSTEM_OUTLINE
インターフェイス: IAccessibleTable2
メソッド: IAccessible::accSelect()
メソッド: IAccessible::get_accSelection()
UIA コントロールタイプ: DataGrid
ATK/AT-SPI ロール: ROLE_TREE_TABLE
インターフェイス: Table
インターフェイス: Selection

WAI-ARIA は、 アクセシビリティ API を介した選択の変更を サポートしていないため、ユーザーエージェントは、選択を変更する手段を提供する すべての Selection メソッドについて false を返さなければなりません (MUST)。

AX API[注記 1] AXRole: AXTable
AXSubrole: <nil>
Android

未定

3.4.3.97 treeitem
ARIA 仕様 treeitem
算出ロール

treeitem

MSAA + IAccessible2 ロール: ROLE_SYSTEM_OUTLINEITEM
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
UIA コントロールタイプ: TreeItem
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
ATK/AT-SPI ロール: ROLE_TREE_ITEM
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
AX API[注記 1] AXRole: AXRow
AXSubrole: AXOutlineRow
関連項目: aria-checked状態およびプロパティのマッピング 表を参照
Android

未定

注記

[注記 1] ユーザーエージェントは、ユーザーに提示可能なローカライズ済み文字列値を AXRoleDescription に対して返すべきです。

注記

[注記 2] この仕様には現在、ユーザー エージェントがいつ system alert イベントを発火すべきかについてのガイダンスは含まれていません。 後日、この仕様に何らかのガイダンスが追加される可能性がありますが、それは推奨 (SHOULD) であり、要件 (MUST) ではありません。

3.5 状態およびプロパティのマッピング

このセクションでは、WAI-ARIA状態およびプロパティを公開する方法を説明します。

3.5.1 一般規則

  1. ユーザーエージェントは、管理対象状態 VISIBLE/INVISIBLESHOWING/OFFSCREEN などを 算出しなければなりません (MUST)。これは通常、WAI-ARIA 属性が存在しない通常の 要素の場合と同じ方法で行われます。 FOCUSABLE/FOCUSED 状態は、aria-activedescendant の影響を受ける場合があります。
  2. ユーザーエージェントは、ホスト言語によって明示的な WAI-ARIA 上書きが許可されている場合を除き、 WAI-ARIA の状態およびプロパティのセマンティクスに加えて、 ネイティブセマンティクスを引き続き公開しなければなりません (MUST)。 例えば、HTML の checkbox は aria-labelledby 属性を持つ場合がありますが、 ネイティブの HTML セマンティクスは引き続き 公開されなければなりません。
  3. ユーザーエージェントは、ロールマッピング表で定義されるとおりに、特定のロールマッピング表について追加の状態を公開しなければなりません (MUST)。
  4. ユーザーエージェントは、関連する WAI-ARIA 属性について状態を算出し、 アクセシビリティ API に、状態およびプロパティのマッピング表で指定されるとおりにマップしなければなりません (MUST)。関連する WAI-ARIA 属性を決定するには、 ロールの定義 [WAI-ARIA-1.2]] を参照してください。著者が必須属性に値を提供していない場合、ユーザーエージェントは、 既定値が提供されたものとして処理するべきです (SHOULD)。
  5. 一部の WAI-ARIA プロパティは グローバルではなく、特定のロールでのみサポートされます。非グローバルの WAI-ARIA 状態またはプロパティが、 サポートされていない場所で使用されている場合、ユーザーエージェントは、与えられた WAI-ARIA プロパティをプラットフォームの アクセシビリティ API にマップするべきではありません (SHOULD NOT)。 例えば、aria-checked="true"<div role="grid"> に指定されている場合、それは MSAA 実装において STATE_SYSTEM_CHECKED として公開されるべきではありません。
  6. 明示的または継承された none または presentation のロールが 要素に適用されている場合、ユーザーエージェントは、 Accessible Rich Internet Applications (WAI-ARIA) 1.2 [WAI-ARIA-1.2]] で定義される none または presentationロールの規則を 実装しなければなりません (MUST)。

3.5.2 状態およびプロパティの マッピング表

3.5.2.1 マップされない

表の中には、与えられた状態またはプロパティが「マップされない」と宣言されている箇所がいくつかあります。 場合によっては、これは状態/プロパティの既定値について発生し、その不在と 同等です。ユーザーエージェントは、それが既定値かどうかを確認するよりも、値をマップする方が速いと 判断する場合があります。計算効率のために、ユーザーエージェントは、それを行うことがマップしないことと 同等である場合、その状態または プロパティ値を公開してもよいです (MAY)。これらの場合は アスタリスクで示されます。

その他の場合には、その状態/プロパティをマップしてはならないことが必須です。なぜなら、それを公開すると 関連するアフォーダンスが示唆されるためです。例として aria-grabbed があります。その不在は、アクセシブルオブジェクトがつかまれていないことを示すだけでなく、さらにそれが つかめないものとして定義されることも意味します。これらの場合は、アスタリスクなしで「マップされない」と示されます。

3.5.2.2 aria-activedescendant
ARIA 仕様 aria-activedescendant
MSAA + IAccessible2 フォーカスの変更を参照。
UIA フォーカスの変更を参照。
ATK/AT-SPI フォーカスの変更を参照。
AX API フォーカスの変更を参照。
プロパティ: AXSelectedRows: アクティブな 子孫ノードへのポインター
Android

未定

3.5.2.3 aria-atomic=true
ARIA 仕様 aria-atomic=true
MSAA + IAccessible2 オブジェクト属性: atomic:true
オブジェクト属性: container-atomic:true
オブジェクト属性: すべての 子孫上の container-atomic:true
関係: この要素 (atomic root) を指す IA2_RELATION_MEMBER_OF
関連項目: 文書コンテンツまたは ノード可視性の変更
UIA プロパティ: AriaProperties.atomic: true
関連項目: 文書コンテンツまたは ノード可視性の変更
ATK/AT-SPI オブジェクト属性: atomic:true
オブジェクト属性: container-atomic:true
オブジェクト属性: すべての 子孫上の container-atomic:true
関係: この 要素 (atomic root) を指す RELATION_MEMBER_OF
関連項目: 文書コンテンツまたは ノード可視性の変更
AX API プロパティ: AXARIAAtomic: YES
関連項目: 文書コンテンツまたは ノード可視性の変更
Android

未定

3.5.2.4 aria-atomic=false
ARIA 仕様 aria-atomic=false
MSAA + IAccessible2 マップされない*、ただし マップする場合:
オブジェクト属性: atomic:false
オブジェクト属性: container-atomic:false
オブジェクト属性: すべての 子孫上の container-atomic:false
関係: この要素 (atomic root) を指す IA2_RELATION_MEMBER_OF
関連項目: 文書コンテンツまたは ノード可視性の変更
UIA プロパティ: AriaProperties.atomic: false
関連項目: 文書コンテンツまたは ノード可視性の変更
ATK/AT-SPI マップされない*、ただし マップする場合:
オブジェクト属性: atomic:false
オブジェクト属性: container-atomic:false
オブジェクト属性: すべての 子孫上の container-atomic:false
関係: この 要素 (atomic root) を指す RELATION_MEMBER_OF
関連項目: 文書コンテンツまたは ノード可視性の変更
AX API プロパティ: AXARIAAtomic: NO
関連項目: 文書コンテンツまたは ノード可視性の変更
Android

未定

3.5.2.5 aria-autocomplete=inline, list, または both
ARIA 仕様 aria-autocomplete=inline, list, または both
MSAA + IAccessible2 オブジェクト属性: autocomplete:<value>
状態: IA2_STATE_SUPPORTS_AUTOCOMPLETION
UIA マップされない
ATK/AT-SPI オブジェクト属性: autocomplete:<value>
状態: STATE_SUPPORTS_AUTOCOMPLETION
AX API マップされない
Android

未定

3.5.2.6 aria-autocomplete=none
ARIA 仕様 aria-autocomplete=none
MSAA + IAccessible2 マップされない*
UIA マップされない*
ATK/AT-SPI マップされない*
AX API マップされない*
Android

未定

3.5.2.7 aria-braillelabel
ARIA 仕様 aria-braillelabel
MSAA + IAccessible2 オブジェクト属性: braillelabel:<value>
UIA プロパティ: AriaProperties.braillelabel: <value>
ATK/AT-SPI オブジェクト属性: braillelabel:<value>
AX API プロパティ: AXBrailleLabel
Android

未定

3.5.2.8 aria-brailleroledescription
ARIA 仕様 aria-brailleroledescription
MSAA + IAccessible2 オブジェクト属性: brailleroledescription:<value>
UIA プロパティ: AriaProperties.brailleroledescription: <value>
ATK/AT-SPI オブジェクト属性: brailleroledescription:<value>
AX API プロパティ: AXBrailleRoleDescription
Android

未定

3.5.2.9 aria-brailleroledescription が未定義または空文字列
ARIA 仕様 aria-brailleroledescription が未定義または空文字列
MSAA + IAccessible2 マップされない
UIA マップされない
ATK/AT-SPI マップされない
AX API マップされない
Android

未定

3.5.2.10 aria-busy=true
ARIA 仕様 aria-busy=true
MSAA + IAccessible2 状態: STATE_SYSTEM_BUSY
UIA プロパティ: AriaProperties.busy: true
ATK/AT-SPI 状態: STATE_BUSY
AX API プロパティ: AXElementBusy: YES
Android

未定

3.5.2.11 aria-busy=false
ARIA 仕様 aria-busy=false
MSAA + IAccessible2 状態: STATE_SYSTEM_BUSY は公開されない
UIA プロパティ: AriaProperties.busy: false
ATK/AT-SPI 状態: STATE_BUSY は公開されない
AX API プロパティ: AXElementBusy: NO
Android

未定

3.5.2.12 aria-checked=true
ARIA 仕様 aria-checked=true
MSAA + IAccessible2 状態: STATE_SYSTEM_CHECKED
オブジェクト属性: checkable:true
UIA プロパティ: Toggle.ToggleState: On (1)
プロパティ: SelectionItem.IsSelected: radio および menuitemradio については True
ATK/AT-SPI 状態: STATE_CHECKABLE
状態: STATE_CHECKED
AX API プロパティ: AXValue: 1
プロパティ: AXMenuItemMarkChar: menuitemcheckbox および menuitemradio については
Android

未定

3.5.2.13 aria-checked=false
ARIA 仕様 aria-checked=false
MSAA + IAccessible2 状態: STATE_SYSTEM_CHECKED は 公開されない
オブジェクト属性: checkable:true
UIA プロパティ: Toggle.ToggleState: Off (0)
プロパティ: SelectionItem.IsSelected: radio および menuitemradio については False
ATK/AT-SPI 状態: STATE_CHECKABLE
状態: STATE_CHECKED は公開されない
AX API プロパティ: AXValue: 0
プロパティ: AXMenuItemMarkChar: menuitemcheckbox および menuitemradio については <nil>
Android

未定

3.5.2.14 aria-checked=mixed
ARIA 仕様 aria-checked=mixed
MSAA + IAccessible2 状態: STATE_SYSTEM_MIXED
オブジェクト属性: checkable:true
UIA プロパティ: Toggle.ToggleState: Indeterminate (2)
ATK/AT-SPI 状態: STATE_INDETERMINATE
状態: STATE_CHECKABLE
状態: STATE_CHECKED は公開されない
AX API プロパティ: AXValue: 2
プロパティ: AXMenuItemMarkChar: menuitemcheckbox および menuitemradio については <nil>
Android

未定

3.5.2.15 aria-checked が 未定義
ARIA 仕様 aria-checked が未定義
MSAA + IAccessible2 マップされない
UIA マップされない
ATK/AT-SPI マップされない
AX API マップされない
Android

未定

3.5.2.16 aria-colcount
ARIA 仕様 aria-colcount
MSAA + IAccessible2 オブジェクト属性: colcount:<value>
メソッド: IAccessible2::groupPosition(): セルおよびヘッダー上の similarItemsInGroup=<value>
UIA プロパティ: Grid.ColumnCount: <value>
ATK/AT-SPI オブジェクト属性: colcount には、 著者が提供した値を含めるべきです。
メソッド: atk_table_get_n_columns() は、 実際の列数を返すべきです。
AX API プロパティ: AXARIAColumnCount: <value>
Android

未定

3.5.2.17 aria-colindex
ARIA 仕様 aria-colindex
MSAA + IAccessible2 オブジェクト属性: colindex:<value>
メソッド: IAccessible2::groupPosition(): セルおよびヘッダー上の positionInGroup=<value>
UIA プロパティ: GridItem.Column: <value> (ゼロ始まり)
ATK/AT-SPI オブジェクト属性: colindex には、 著者が提供した値を含めるべきです。
メソッド: atk_table_cell_get_position() は、 実際の (ゼロ始まりの) 列インデックスを返すべきです。
AX API プロパティ: AXARIAColumnIndex: <value>
Android

未定

3.5.2.18 aria-colindextext
ARIA 仕様 aria-colindextext
MSAA + IAccessible2 オブジェクト属性: colindextext:<value>
UIA プロパティ: AriaProperties.colindextext: <value>
ATK/AT-SPI オブジェクト属性: colindextext:<value>
AX API プロパティ: AXColumnIndexDescription: <value>
Android

未定

3.5.2.19 aria-colspan
ARIA 仕様 aria-colspan
MSAA + IAccessible2 オブジェクト属性: colspan:<value>
メソッド: IAccessibleTableCell::columnExtent(): <value>
UIA プロパティ: GridItem.ColumnSpan: <value>
ATK/AT-SPI オブジェクト属性: colspan には、 著者が提供した値を含めるべきです。
メソッド: atk_table_cell_get_row_column_span() は、実際の列スパンを返すべきです。
AX API プロパティ: AXColumnIndexRange.length: <value>
Android

未定

3.5.2.20 aria-controls
ARIA 仕様 aria-controls
MSAA + IAccessible2 関係: IA2_RELATION_CONTROLLER_FOR は、 IDREF に一致するアクセシブルノードを指す
逆関係: IA2_RELATION_CONTROLLED_BY は要素を指す
関連項目: 追加の 関係のマッピング
UIA プロパティ: ControllerFor: IDREF に一致する アクセシブルノードへのポインター
ATK/AT-SPI 関係: RELATION_CONTROLLER_FOR は、 IDREF に一致するアクセシブルノードを指す
逆関係: RELATION_CONTROLLED_BY は 要素を指す
関連項目: 追加の 関係のマッピング
AX API プロパティ: AXLinkedUIElements: IDREF に一致する アクセシブルノードへのポインター
Android

未定

3.5.2.21 aria-current に non-false の許可値を持つ場合
ARIA 仕様 aria-current に non-false の許可値を持つ場合
MSAA + IAccessible2 オブジェクト属性: current:<value>
UIA プロパティ: AriaProperties.current: <value>
ATK/AT-SPI オブジェクト属性: current:<value>
状態: STATE_ACTIVE
AX API プロパティ: AXARIACurrent: <value>
Android

未定

3.5.2.22 認識されない値を持つ aria-current
ARIA 仕様 aria-current に認識されない値を持つ場合
MSAA + IAccessible2 オブジェクト属性: current:true
UIA プロパティ: AriaProperties.current: true
ATK/AT-SPI オブジェクト属性: current:true
状態: STATE_ACTIVE
AX API プロパティ: AXARIACurrent: true
Android

未定

3.5.2.23 aria-currentfalse または未定義
ARIA 仕様 aria-currentfalse または未定義
MSAA + IAccessible2 マップされない*
UIA マップされない*
ATK/AT-SPI マップされない*
AX API マップされない*
Android

未定

3.5.2.24 aria-describedby
ARIA 仕様 aria-describedby
MSAA + IAccessible2 プロパティ: accDescription: <value>
関係: IA2_RELATION_DESCRIBED_BY は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: IA2_RELATION_DESCRIPTION_FOR は要素を指す
関連項目: 名前の 算出および 追加の 関係のマッピング
UIA プロパティ: FullDescription: <value>
関連項目: 名前の 算出
ATK/AT-SPI プロパティ: Description: <value>
関係: RELATION_DESCRIBED_BY は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: RELATION_DESCRIPTION_FOR は要素を指す
関連項目: 名前の 算出および 追加の 関係のマッピング
AX API accessibilityCustomContent API では、 { label: "description" } を持つ AXCustomContent オブジェクトとして公開し、 `value` には説明文字列を設定します。
- 関連項目: 名前の 算出
Android

未定

3.5.2.25 aria-description
ARIA 仕様 aria-description
MSAA + IAccessible2 プロパティ: accDescription: <value>
関連項目: 名前の 算出
UIA プロパティ: FullDescription: <value>
関連項目: 名前の 算出
ATK/AT-SPI プロパティ: Description: <value>
関連項目: 名前の 算出
AX API accessibilityCustomContent API では、 { label: "description" } を持つ AXCustomContent オブジェクトとして公開し、 `value` には説明文字列を設定します。
関連項目: 名前の 算出
Android

未定

3.5.2.26 aria-details
ARIA 仕様 aria-details
MSAA + IAccessible2 関係: IA2_RELATION_DETAILS は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: IA2_RELATION_DETAILS_FOR は要素を指す
関連項目: 追加の 関係のマッピング
UIA プロパティ: DescribedBy: 参照されるオブジェクトが アクセシビリティツリー内にある場合、IDREF に一致するアクセシブルノードを指す
ATK/AT-SPI 関係: RELATION_DETAILS は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: RELATION_DETAILS_FOR は 要素を指す
関連項目: 追加の 関係のマッピング
AX API マップされない*
Android

未定

3.5.2.27 aria-disabled=true
ARIA 仕様 aria-disabled=true
MSAA + IAccessible2 状態: STATE_SYSTEM_UNAVAILABLE
STATE_SYSTEM_FOCUSABLE を持つすべての 子孫上の状態: STATE_SYSTEM_UNAVAILABLE
UIA プロパティ: IsEnabled: false
ATK/AT-SPI 状態: STATE_ENABLED は公開されない
AX API プロパティ: AXEnabled: NO
Android

未定

3.5.2.28 aria-disabled=false
ARIA 仕様 aria-disabled=false
MSAA + IAccessible2 状態: STATE_SYSTEM_UNAVAILABLE は 公開されない
UIA プロパティ: IsEnabled: true
ATK/AT-SPI 状態: STATE_ENABLED
AX API プロパティ: AXEnabled: YES
Android

未定

3.5.2.30 aria-dropeffect=none (非推奨)
ARIA 仕様 aria-dropeffect=none
MSAA + IAccessible2 他に有効なトークンがない場合、オブジェクト属性: dropeffect:none
著者によって指定されていない場合、マップされない*
UIA マップされない*
ATK/AT-SPI 他に有効なトークンがない場合、オブジェクト属性: dropeffect:none
著者によって指定されていない場合、マップされない*
AX API マップされない*
Android

未定

3.5.2.31 aria-errormessage
ARIA 仕様 aria-errormessage
MSAA + IAccessible2 関係: IA2_RELATION_ERROR は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: IA2_RELATION_ERROR_FOR は 要素を指す
関連項目: 追加の 関係のマッピング
UIA プロパティ: ControllerFor: 対象の アクセシブルオブジェクトへのポインター
ATK/AT-SPI 関係: RELATION_ERROR_MESSAGE は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: RELATION_ERROR_FOR は 要素を指す
関連項目: 追加の 関係のマッピング
AX API プロパティ: AXErrorMessageElements: IDREF に一致する アクセシブルノードへのポインター
Android

未定

3.5.2.32 aria-expanded=true
ARIA 仕様 aria-expanded=true
MSAA + IAccessible2 状態: STATE_SYSTEM_EXPANDED
UIA プロパティ: ExpandCollapse.ExpandCollapseState: Expanded
ATK/AT-SPI 状態: STATE_EXPANDABLE
状態: STATE_EXPANDED
AX API プロパティ: AXExpanded: YES
Android

未定

3.5.2.33 aria-expanded=false
ARIA 仕様 aria-expanded=false
MSAA + IAccessible2 状態: STATE_SYSTEM_COLLAPSED
UIA プロパティ: ExpandCollapse.ExpandCollapseState: Collapsed
ATK/AT-SPI 状態: STATE_EXPANDABLE
状態: STATE_EXPANDED は公開されない
AX API プロパティ: AXExpanded: NO
Android

未定

3.5.2.34 aria-expanded が 未定義
ARIA 仕様 aria-expanded が未定義
MSAA + IAccessible2 マップされない
UIA マップされない
ATK/AT-SPI マップされない
AX API マップされない
Android

未定

3.5.2.35 aria-flowto
ARIA 仕様 aria-flowto
MSAA + IAccessible2 関係: IA2_RELATION_FLOW_TO は、 IDREF に一致するアクセシブルノードを指す
逆関係: IA2_RELATION_FLOW_FROM は 要素を指す
関連項目: 追加の 関係のマッピング
UIA プロパティ: FlowsTo: IDREF に一致する アクセシブルノードへのポインター
ATK/AT-SPI 関係: RELATION_FLOWS_TO は、IDREF に一致する アクセシブルノードを指す
逆関係: RELATION_FLOWS_FROM は 要素を指す
関連項目: 追加の 関係のマッピング
AX API プロパティ: AXLinkedUIElements: IDREF に一致する アクセシブルノードへのポインター
Android

未定

3.5.2.36 aria-grabbed=true
ARIA 仕様 aria-grabbed=true
MSAA + IAccessible2 オブジェクト属性: grabbed:true
UIA プロパティ: AriaProperties.grabbed: true
ATK/AT-SPI オブジェクト属性: grabbed:true
AX API プロパティ: AXGrabbed: YES
Android

未定

3.5.2.37 aria-grabbed=false
ARIA 仕様 aria-grabbed=false
MSAA + IAccessible2 オブジェクト属性: grabbed:false
UIA プロパティ: AriaProperties.grabbed: false
ATK/AT-SPI オブジェクト属性: grabbed:false
AX API プロパティ: AXGrabbed: NO
Android

未定

3.5.2.38 aria-grabbed が 未定義
ARIA 仕様 aria-grabbed が未定義
MSAA + IAccessible2 マップされない
UIA マップされない
ATK/AT-SPI マップされない
AX API マップされない
Android

未定

3.5.2.39 aria-haspopup=true
ARIA 仕様 aria-haspopup=true
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP
オブジェクト属性: haspopup:menu
UIA コントロールパターン: ExpandCollapse 関連項目: aria-expanded
ATK/AT-SPI 状態: STATE_HAS_POPUP
オブジェクト属性: haspopup:menu
AX API プロパティ: AXPopupValue:menu
アクション: AXShowMenu
Android

未定

3.5.2.40 aria-haspopup=false
ARIA 仕様 aria-haspopup=false
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP は 公開されない
オブジェクト属性: haspopup:false
UIA マップされない*
ATK/AT-SPI マップされない*
AX API マップされない*
Android

未定

3.5.2.41 aria-haspopup=dialog
ARIA 仕様 aria-haspopup=dialog
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP
オブジェクト属性: haspopup:dialog
UIA コントロールパターン: ExpandCollapse
関連項目: aria-expanded
ATK/AT-SPI 状態: STATE_HAS_POPUP
オブジェクト属性: haspopup:dialog
AX API プロパティ: AXPopupValue:dialog
アクション: AXShowMenu
Android

未定

3.5.2.42 aria-haspopup=grid
ARIA 仕様 aria-haspopup=grid
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP
オブジェクト属性: haspopup:grid
UIA コントロールパターン: ExpandCollapse
関連項目: aria-expanded
ATK/AT-SPI 状態: STATE_HAS_POPUP
オブジェクト属性: haspopup:grid
AX API プロパティ: AXPopupValue:grid
アクション: AXShowMenu
Android

未定

3.5.2.43 aria-haspopup=listbox
ARIA 仕様 aria-haspopup=listbox
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP
オブジェクト属性: haspopup:listbox
UIA コントロールパターン: ExpandCollapse
関連項目: aria-expanded
ATK/AT-SPI 状態: STATE_HAS_POPUP
オブジェクト属性: haspopup:listbox
AX API プロパティ: AXPopupValue:listbox
アクション: AXShowMenu
Android

未定

3.5.2.44 aria-haspopup=menu
ARIA 仕様 aria-haspopup=menu
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP
オブジェクト属性: haspopup:menu
UIA コントロールパターン: ExpandCollapse
関連項目: aria-expanded
ATK/AT-SPI 状態: STATE_HAS_POPUP
オブジェクト属性: haspopup:menu
AX API プロパティ: AXPopupValue:menu
アクション: AXShowMenu
Android

未定

3.5.2.45 aria-haspopup=tree
ARIA 仕様 aria-haspopup=tree
MSAA + IAccessible2 状態: STATE_SYSTEM_HASPOPUP
オブジェクト属性: haspopup:tree
UIA コントロールパターン: ExpandCollapse
関連項目: aria-expanded
ATK/AT-SPI 状態: STATE_HAS_POPUP
オブジェクト属性: haspopup:tree
AX API プロパティ: AXPopupValue:tree
アクション: AXShowMenu
Android

未定

3.5.2.46 フォーカスされていない要素上の aria-hidden=true
ARIA 仕様 aria-hidden=true がフォーカスされていない要素上にある場合
MSAA + IAccessible2 要素は公開されるべきではありません (SHOULD NOT)
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
UIA 要素は公開されるべきではありません (SHOULD NOT)
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
ATK/AT-SPI 要素は公開されるべきではありません (SHOULD NOT)
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
AX API 要素は公開されるべきではありません (SHOULD NOT)
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
Android

未定

3.5.2.47 要素がフォーカスされている、またはアクセシビリティイベントを発火する場合の aria-hidden=true
ARIA 仕様 aria-hidden=true が、要素がフォーカスされている、またはアクセシビリティイベントを発火する場合
MSAA + IAccessible2 オブジェクト属性: hidden:true
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
UIA プロパティ: AriaProperties.hidden: true
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
ATK/AT-SPI オブジェクト属性: hidden:true
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
AX API マップされない
関連項目: WAI-ARIA 仕様におけるアクセシビリティツリーへの要素の包含
Android

未定

3.5.2.48 aria-hidden=false
ARIA 仕様 aria-hidden=false
MSAA + IAccessible2 マップされない
UIA マップされない
ATK/AT-SPI マップされない
AX API マップされない
Android

未定

3.5.2.49 aria-invalid=true
ARIA 仕様 aria-invalid=true
MSAA + IAccessible2 状態: IA2_STATE_INVALID_ENTRY
テキスト属性: invalid:true
UIA プロパティ: IsDataValidForForm: false
ATK/AT-SPI 状態: STATE_INVALID_ENTRY
テキスト属性: invalid:true
AX API プロパティ: AXInvalid: true
Android

未定

3.5.2.50 aria-invalid=false
ARIA 仕様 aria-invalid=false
MSAA + IAccessible2 状態: IA2_STATE_INVALID_ENTRY は 公開されない
UIA プロパティ: IsDataValidForForm: true
ATK/AT-SPI 状態: STATE_INVALID_ENTRY は公開されない
AX API プロパティ: AXInvalid: false
Android

未定

3.5.2.51 aria-invalid=spelling または grammar
ARIA 仕様 aria-invalid=spelling または grammar
MSAA + IAccessible2 状態: IA2_STATE_INVALID_ENTRY
テキスト属性: invalid:<value>
UIA プロパティ: IsDataValidForForm: <value>
ATK/AT-SPI 状態: STATE_INVALID_ENTRY
テキスト属性: invalid:<value>
AX API プロパティ: AXInvalid: <value>
Android

未定

3.5.2.52 認識されない値を持つ aria-invalid
ARIA 仕様 aria-invalid が認識されない値を持つ場合
MSAA + IAccessible2 状態: IA2_STATE_INVALID_ENTRY
テキスト属性: invalid:true
UIA プロパティ: IsDataValidForForm: false
ATK/AT-SPI 状態: STATE_INVALID_ENTRY
テキスト属性: invalid:true
AX API プロパティ: AXInvalid: true
Android

未定

3.5.2.53 aria-keyshortcuts
ARIA 仕様 aria-keyshortcuts
MSAA + IAccessible2 プロパティ: accKeyboardShortcut: <value>
UIA プロパティ: AcceleratorKey: <value>
ATK/AT-SPI オブジェクト属性: keyshortcuts:<value>
AX API プロパティ: AXKeyShortcutsValue: <value>
Android

未定

3.5.2.54 aria-label
ARIA 仕様 aria-label
MSAA + IAccessible2 プロパティ: accName: <value>
関連項目: 名前の 算出
UIA プロパティ: Name: <value>
関連項目: 名前の 算出
ATK/AT-SPI プロパティ: Name: <value>
関連項目: 名前の 算出
AX API プロパティ: AXTitle: <value>
関連項目: 名前の 算出
Android

未定

3.5.2.55 aria-labelledby
ARIA 仕様 aria-labelledby
MSAA + IAccessible2 プロパティ: accName: <value>
関係: IA2_RELATION_LABELLED_BY は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: IA2_RELATION_LABEL_FOR は 要素を指す
関連項目: 名前の 算出および 追加の 関係のマッピング
UIA プロパティ: Name: <value>
プロパティ: LabeledBy: 参照されるオブジェクトが アクセシビリティツリー内にある場合、IDREF に一致するアクセシブルノードを指す
関連項目: 名前の 算出
ATK/AT-SPI プロパティ: Name: <value>
関係: RELATION_LABELLED_BY は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: RELATION_LABEL_FOR は 要素を指す
関連項目: 名前の 算出および 追加の 関係のマッピング
AX API プロパティ: AXTitle: <value>
プロパティ: AXTitleUIElement は、参照される要素が 1 つで、 アクセシビリティツリー内にある場合、IDREF に一致するアクセシブル ノードを指す
関連項目: 名前の 算出
Android

未定

3.5.2.56 aria-level が non-heading 上にある場合
ARIA 仕様 aria-level が non-heading 上にある場合
MSAA + IAccessible2 オブジェクト属性: level:<value>
メソッド: IAccessible2::groupPosition(): aria-posinset および aria-setsize をサポートする ロール上の groupLevel=<value>
関連項目: groupPosition()
UIA プロパティ: AriaProperties.level: <value>
ATK/AT-SPI オブジェクト属性: level:<value>
AX API プロパティ: AXDisclosureLevel: <value> (ゼロ始まり)。アウトライン行 (例えば treeitem または group) 上で使用される場合
Android

未定

3.5.2.57 heading 上の aria-level
ARIA 仕様 aria-levelheading 上にある場合
MSAA + IAccessible2 オブジェクト属性: level:<value>
UIA プロパティ: AriaProperties.level: <value>
プロパティ: StyleId_Heading: <value>
ATK/AT-SPI オブジェクト属性: level:<value>
AX API プロパティ: AXValue: <value>
Android

未定

3.5.2.58 aria-live=assertive
ARIA 仕様 aria-live=assertive
MSAA + IAccessible2 オブジェクト属性: live:assertive
オブジェクト属性: container-live:assertive
オブジェクト属性: すべての子孫上の container-live:assertive
関連項目: 文書コンテンツまたは ノード可視性の変更
UIA プロパティ: LiveSetting: "assertive"
関連項目: 文書コンテンツまたは ノード可視性の変更
ATK/AT-SPI オブジェクト属性: live:assertive
オブジェクト属性: container-live:assertive
オブジェクト属性: すべての子孫上の container-live:assertive
関連項目: 文書コンテンツまたは ノード可視性の変更
AX API プロパティ: AXARIALive: "assertive"
関連項目: 文書コンテンツまたは ノード可視性の変更
Android

未定

3.5.2.59 aria-live=polite
ARIA 仕様 aria-live=polite
MSAA + IAccessible2 オブジェクト属性: live:polite
オブジェクト属性: container-live:polite
オブジェクト属性: すべての子孫上の container-live:polite
関連項目: 文書コンテンツまたは ノード可視性の変更
UIA プロパティ: LiveSetting: "polite"
関連項目: 文書コンテンツまたは ノード可視性の変更
ATK/AT-SPI オブジェクト属性: live:polite
オブジェクト属性: container-live:polite
オブジェクト属性: すべての子孫上の container-live:polite
関連項目: 文書コンテンツまたは ノード可視性の変更
AX API プロパティ: AXARIALive: "polite"
関連項目: 文書コンテンツまたは ノード可視性の変更
Android

未定

3.5.2.60 aria-live=off
ARIA 仕様 aria-live=off
MSAA + IAccessible2 オブジェクト属性: live:off
オブジェクト属性: container-live:off
オブジェクト属性: すべての子孫上の container-live:off
UIA プロパティ: LiveSetting: "off"
ATK/AT-SPI オブジェクト属性: live:off
オブジェクト属性: container-live:off
オブジェクト属性: すべての子孫上の container-live:off
AX API プロパティ: AXARIALive: "off"
Android

未定

3.5.2.61 aria-modal=true
ARIA 仕様 aria-modal=true
MSAA + IAccessible2 状態: IA2_STATE_MODAL
UIA プロパティ: Window.IsModal: true
ATK/AT-SPI 状態: STATE_MODAL
AX API 背景コンテンツがもはや公開されないように、アクセシビリティツリーを刈り込みます。 aria-modal="true" を持つ 要素に対応する アクセシブル オブジェクト上には、特定のプロパティは設定されません。 そのモーダルアクセシブルオブジェクトをルートとするツリーのみが公開されます。
Android

未定

3.5.2.62 aria-modal=false
ARIA 仕様 aria-modal=false
MSAA + IAccessible2 状態: IA2_STATE_MODAL は公開されない
UIA プロパティ: Window.IsModal: false
ATK/AT-SPI 状態: STATE_MODAL は公開されない
AX API 背景コンテンツが公開されるように、アクセシビリティツリーを拡張します。 aria-modal="false" を持つ 要素に対応する アクセシブル オブジェクト上には、特定のプロパティは設定されません。
Android

未定

3.5.2.63 aria-multiline=true
ARIA 仕様 aria-multiline=true
MSAA + IAccessible2 状態: IA2_STATE_MULTI_LINE
状態: IA2_STATE_SINGLE_LINE は公開されない
UIA プロパティ: AriaProperties.multiline: true
ATK/AT-SPI 状態: STATE_MULTI_LINE
状態: STATE_SINGLE_LINE は公開されない
AX API マップされない
関連項目: ロールマッピング表の textbox
Android

未定

3.5.2.64 aria-multiline=false
ARIA 仕様 aria-multiline=false
MSAA + IAccessible2 状態: IA2_STATE_SINGLE_LINE
状態: IA2_STATE_MULTI_LINE は公開されない
UIA マップされない
ATK/AT-SPI 状態: STATE_SINGLE_LINE
状態: STATE_MULTI_LINE は公開されない
AX API マップされない
関連項目: ロールマッピング表の textbox
Android

未定

3.5.2.65 aria-multiselectable=true
ARIA 仕様 aria-multiselectable=true
MSAA + IAccessible2 状態: STATE_SYSTEM_MULTISELECTABLE
状態: STATE_SYSTEM_EXTSELECTABLE
関連項目: アクセシビリティイベントの詳細については 選択
UIA プロパティ: Selection.CanSelectMultiple: true
関連項目: アクセシビリティイベントの詳細については 選択
ATK/AT-SPI 状態: STATE_MULTISELECTABLE
関連項目: アクセシビリティイベントの詳細については 選択
AX API プロパティ: AXIsMultiSelectable: YES
関連項目: アクセシビリティイベントの詳細については 選択
Android

未定

3.5.2.66 aria-multiselectable=false
ARIA 仕様 aria-multiselectable=false
MSAA + IAccessible2 状態: STATE_SYSTEM_MULTISELECTABLE は 公開されない
状態: STATE_SYSTEM_EXTSELECTABLE は 公開されない
関連項目: アクセシビリティイベントの詳細については 選択
UIA マップされない*
ATK/AT-SPI 状態: STATE_MULTISELECTABLE は公開されない
AX API マップされない*
Android

未定

3.5.2.67 aria-orientation=horizontal
ARIA 仕様 aria-orientation=horizontal
MSAA + IAccessible2 状態: IA2_STATE_HORIZONTAL
状態: IA2_STATE_VERTICAL は公開されない
UIA プロパティ: Orientation: horizontal
ATK/AT-SPI 状態: STATE_HORIZONTAL
状態: STATE_VERTICAL は公開されない
AX API プロパティ: AXOrientation: AXHorizontalOrientation
Android

未定

3.5.2.68 aria-orientation=vertical
ARIA 仕様 aria-orientation=vertical
MSAA + IAccessible2 状態: IA2_STATE_VERTICAL
状態: IA2_STATE_HORIZONTAL は公開されない
UIA プロパティ: Orientation: vertical
ATK/AT-SPI 状態: STATE_VERTICAL
状態: STATE_HORIZONTAL は公開されない
AX API プロパティ: AXOrientation: AXVerticalOrientation
Android

未定

3.5.2.69 aria-orientation が未定義
ARIA 仕様 aria-orientation が未定義
MSAA + IAccessible2 マップされない*
UIA マップされない*
ATK/AT-SPI 状態: STATE_VERTICAL は公開されない
状態: STATE_HORIZONTAL は公開されない
AX API プロパティ: AXOrientation: AXUnknownOrientation
Android

未定

3.5.2.70 aria-owns
ARIA 仕様 aria-owns
MSAA + IAccessible2

ユーザーエージェントは、このプロパティによって参照される要素を、現在の要素の子として 公開してもよいです (MAY)。その場合、複数の aria-owns 関係が見つかったなら、最初のものだけを使用します。アクセシビリティツリーが 変更されない場合は、次のように公開します:

関係: IA2_RELATION_NODE_PARENT_OF は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: IA2_RELATION_NODE_CHILD_OF は要素を指す
関連項目: 追加の 関係のマッピング
UIA このプロパティによって参照される要素を、現在の要素の子として公開します。複数の aria-owns 関係が見つかった場合は、最初のものだけを使用します。
ATK/AT-SPI

ユーザーエージェントは、このプロパティによって参照される要素を、現在の要素の子として 公開してもよいです (MAY)。その場合、複数の aria-owns 関係が見つかったなら、最初のものだけを使用します。アクセシビリティツリーが 変更されない場合は、次のように公開します:

関係: RELATION_NODE_PARENT_OF は、 参照されるオブジェクトがアクセシビリティツリー内にある場合、IDREF に一致する アクセシブルノードを指す
逆関係: RELATION_NODE_CHILD_OF は 要素を指す
関連項目: 追加の 関係のマッピング
AX API プロパティ: AXOwns: IDREF に一致する アクセシブルノードへのポインター
Android

未定

3.5.2.71 aria-placeholder
ARIA 仕様 aria-placeholder
MSAA + IAccessible2 オブジェクト属性: placeholder-text:<value>
UIA プロパティ: HelpText: <value>
ATK/AT-SPI オブジェクト属性: placeholder-text:<value>
AX API プロパティ: AXPlaceholderValue: <value>
Android

未定

3.5.2.72 aria-posinset
ARIA 仕様 aria-posinset
MSAA + IAccessible2 オブジェクト属性: posinset:<value>
関連項目: グループ 位置
UIA プロパティ: AriaProperties.posinset: <value>
関連項目: グループ 位置
ATK/AT-SPI オブジェクト属性: posinset:<value>
関連項目: グループ 位置
AX API プロパティ: AXARIAPosInSet: <value>
関連項目: グループ 位置
Android

未定

3.5.2.73 aria-pressed=true
ARIA 仕様 aria-pressed=true
MSAA + IAccessible2 状態: STATE_SYSTEM_PRESSED
関連項目: aria-pressed の定義済み値を持つ button
UIA プロパティ: Toggle.ToggleState: On (1)
ATK/AT-SPI 状態: STATE_PRESSED
関連項目: aria-pressed の定義済み値を持つ button
AX API プロパティ: AXValue: 1
関連項目: aria-pressed の定義済み値を持つ button
Android

未定

3.5.2.74 aria-pressed=mixed
ARIA 仕様 aria-pressed=mixed
MSAA + IAccessible2 状態: STATE_SYSTEM_MIXED
関連項目: aria-pressed の定義済み値を持つ button
UIA プロパティ: Toggle.ToggleState: Indeterminate (2)
ATK/AT-SPI 状態: STATE_INDETERMINATE
関連項目: aria-pressed の定義済み値を持つ button
AX API プロパティ: AXValue: 2
関連項目: aria-pressed の定義済み値を持つ button
Android

未定

3.5.2.75 aria-pressed=false
ARIA 仕様 aria-pressed=false
MSAA + IAccessible2 状態: STATE_SYSTEM_PRESSED は 公開されない
関連項目: aria-pressed の定義済み値を持つ button
UIA プロパティ: Toggle.ToggleState: Off (3)
ATK/AT-SPI 状態: STATE_PRESSED は公開されない
関連項目: aria-pressed の定義済み値を持つ button
AX API プロパティ: AXValue: 0
関連項目: aria-pressed の定義済み値を持つ button
Android

未定

3.5.2.76 aria-pressed が 未定義
ARIA 仕様 aria-pressed が未定義
MSAA + IAccessible2 マップされない*
UIA マップされない*
ATK/AT-SPI マップされない*
AX API マップされない*
Android

未定

3.5.2.77 aria-readonly=true
ARIA 仕様 aria-readonly=true
MSAA + IAccessible2 状態: STATE_SYSTEM_READONLY
UIA プロパティ: Value.IsReadOnly: true。 要素が IValueProvider を実装している場合。
プロパティ: RangeValue.IsReadOnly: true。要素が IRangeValueProvider を実装している場合。
プロパティ: AriaProperties.readonly: true
ATK/AT-SPI 状態: STATE_READ_ONLY
状態: テキスト入力ロール上で STATE_EDITABLE は 公開されない
状態: aria-checked をサポートするロール上で STATE_CHECKABLE は公開されない
状態: radiogroup 上で使用される場合、その radio 子孫上で STATE_CHECKABLE は公開されない
AX API メソッド: AXUIElementIsAttributeSettable(AXValue): NO
Android

未定

3.5.2.78 aria-readonly=false
ARIA 仕様 aria-readonly=false
MSAA + IAccessible2 状態: STATE_SYSTEM_READONLY は 公開されない
状態: IA2_STATE_EDITABLE
UIA プロパティ: Value.IsReadOnly: false。 要素が IValueProvider を実装している場合。
プロパティ: RangeValue.IsReadOnly: false。要素が IRangeValueProvider を実装している場合。
プロパティ: AriaProperties.readonly: false
ATK/AT-SPI 状態: STATE_READ_ONLY は公開されない
AX API メソッド: AXUIElementIsAttributeSettable(AXValue): YES
Android

未定

3.5.2.79 gridcell 上で aria-readonly が指定されていない場合
ARIA 仕様 aria-readonlygridcell 上で指定されていない場合
MSAA + IAccessible2 gridcell は、包含する grid または treegrid から、著者が提供した aria-readonly の値を継承しなければなりません (MUST)。 継承された値を、aria-readonly="true" および aria-readonly="false" について説明されているように gridcell 上で公開します。
UIA gridcell は、包含する grid または treegrid から、著者が提供した aria-readonly の値を継承しなければなりません (MUST)。 継承された値を、aria-readonly="true" および aria-readonly="false" について説明されているように gridcell 上で公開します。
ATK/AT-SPI gridcell は、包含する grid または treegrid から、著者が提供した aria-readonly の値を継承しなければなりません (MUST)。 継承された値を、aria-readonly="true" および aria-readonly="false" について説明されているように gridcell 上で公開します。
AX API gridcell は、包含する grid または treegrid から、著者が提供した aria-readonly の値を継承しなければなりません (MUST)。 継承された値を、aria-readonly="true" および aria-readonly="false" について説明されているように gridcell 上で公開します。
Android

未定

3.5.2.80 aria-relevant
ARIA 仕様 aria-relevant
MSAA + IAccessible2 オブジェクト属性: relevant:<value>
オブジェクト属性: container-relevant:<value>
オブジェクト属性: すべての子孫上の container-relevant:<value>
関連項目: 文書コンテンツまたは ノード可視性の変更
UIA プロパティ: AriaProperties.relevant: <value>
関連項目: 文書コンテンツまたは ノード可視性の変更
ATK/AT-SPI オブジェクト属性: relevant:<value>
オブジェクト属性: container-relevant:<value>
オブジェクト属性: すべての子孫上の container-relevant:<value>
関連項目: 文書コンテンツまたは ノード可視性の変更
AX API プロパティ: AXARIARelevant: <value>
関連項目: 文書コンテンツまたは ノード可視性の変更
Android

未定

3.5.2.81 aria-required=true
ARIA 仕様 aria-required=true
MSAA + IAccessible2 状態: IA2_STATE_REQUIRED
UIA プロパティ: IsRequiredForForm: true
ATK/AT-SPI 状態: STATE_REQUIRED
AX API プロパティ: AXRequired: YES
Android

未定

3.5.2.82 aria-required=false
ARIA 仕様 aria-required=false
MSAA + IAccessible2 マップされない*
UIA マップされない*
ATK/AT-SPI マップされない*
AX API マップされない*
Android

未定

3.5.2.83 aria-roledescription
ARIA 仕様 aria-roledescription
MSAA + IAccessible2 メソッド: localizedExtendedRole(): <value>
UIA ローカライズされたコントロールタイプ: <value>
ATK/AT-SPI オブジェクト属性: roledescription:<value>
AX API プロパティ: AXRoleDescription: <value>
Android

未定

3.5.2.84 aria-roledescription が未定義または空文字列
ARIA 仕様 aria-roledescription が未定義 または空文字列
MSAA + IAccessible2 マップされない
UIA ローカライズされたコントロールタイプは、その要素のロールに対して指定されたものとして 定義されます。role 属性が提供されている場合は明示的なロールに基づき、 それ以外の場合はホスト言語の暗黙の ロールに基づきます。
ATK/AT-SPI マップされない
AX API AXRoleDescription は、その要素のロールに対して指定されたものとして 定義されます。role 属性が提供されている場合は明示的なロールに基づき、 それ以外の場合はホスト言語の暗黙のロールに 基づきます。
Android

未定

3.5.2.85 aria-rowcount
ARIA 仕様 aria-rowcount
MSAA + IAccessible2 オブジェクト属性: rowcount:<value>
メソッド: IAccessible2::groupPosition(): 行上の similarItemsInGroup=<value>
UIA プロパティ: Grid.RowCount: <value>
ATK/AT-SPI オブジェクト属性: rowcount には、 著者が提供した値を含めるべきです。
メソッド: atk_table_get_n_rows() は、 実際の行数を返すべきです。
AX API プロパティ: AXARIARowCount: <value>
Android

未定

3.5.2.86 aria-rowindex
ARIA 仕様 aria-rowindex
MSAA + IAccessible2 オブジェクト属性: rowindex:<value>
メソッド: IAccessible2::groupPosition(): 行上の positionInGroup=<value>
UIA プロパティ: GridItem.Row: <value> (ゼロ始まり)
ATK/AT-SPI オブジェクト属性: rowindex には、 著者が提供した値を含めるべきです。
メソッド: atk_table_cell_get_position() は、 実際の (ゼロ始まりの) 行インデックスを返すべきです。
AX API プロパティ: AXARIARowIndex: <value>
Android

未定

3.5.2.87 aria-rowindextext
ARIA 仕様 aria-rowindextext
MSAA + IAccessible2 オブジェクト属性: rowindextext:<value>
UIA プロパティ: AriaProperties.rowindextext: <value>
ATK/AT-SPI オブジェクト属性: rowindextext:<value>
AX API プロパティ: AXRowIndexDescription: <value>
Android

未定

3.5.2.88 aria-rowspan
ARIA 仕様 aria-rowspan
MSAA + IAccessible2 オブジェクト属性: rowspan:<value>
メソッド: IAccessibleTableCell::rowExtent(): column=<value>
UIA プロパティ: GridItem.RowSpan: <value>
ATK/AT-SPI オブジェクト属性: rowspan には、 著者が提供した値を含めるべきです。
メソッド: atk_table_cell_get_row_column_span() は、実際の行スパンを返すべきです。
AX API プロパティ: AXRowIndexRange.length: <value>
Android

未定

3.5.2.89 aria-selected=true
ARIA 仕様 aria-selected=true
MSAA + IAccessible2 状態: STATE_SYSTEM_SELECTABLE
状態: STATE_SYSTEM_SELECTED
関連項目: アクセシビリティイベントの詳細については 選択
UIA プロパティ: SelectionItem.IsSelected: true
ATK/AT-SPI 状態: STATE_SELECTABLE
状態: STATE_SELECTED
関連項目: アクセシビリティイベントの詳細については 選択
AX API プロパティ: AXSelected: YES
Android

未定

3.5.2.90 aria-selected=false
ARIA 仕様 aria-selected=false
MSAA + IAccessible2 状態: STATE_SYSTEM_SELECTABLE
状態: STATE_SYSTEM_SELECTED は 公開されない
関連項目: アクセシビリティイベントの詳細については 選択
UIA プロパティ: SelectionItem.IsSelected: false
ATK/AT-SPI 状態: STATE_SELECTABLE
状態: STATE_SELECTED は公開されない
関連項目: アクセシビリティイベントの詳細については 選択
AX API プロパティ: AXSelected: NO
Android

未定

3.5.2.91 aria-selected が 未定義
ARIA 仕様 aria-selected が未定義
MSAA + IAccessible2 マップされない
UIA マップされない
ATK/AT-SPI マップされない
AX API マップされない
Android

未定

3.5.2.92 aria-setsize
ARIA 仕様 aria-setsize
MSAA + IAccessible2 オブジェクト属性: setsize:<value>
関連項目: グループ 位置
UIA プロパティ: AriaProperties.setsize: <value>
関連項目: グループ 位置
ATK/AT-SPI

著者が提供した aria-setsize の値が -1 の場合、 公開される値は DOM 内のオブジェクト数に基づくべきです。

オブジェクト属性: setsize:<value>
状態: 著者が提供した値が -1 の場合 STATE_INDETERMINATE
関連項目: グループ 位置
AX API プロパティ: AXARIASetSize: <value>
関連項目: グループ 位置
Android

未定

3.5.2.93 aria-sort=ascending
ARIA 仕様 aria-sort=ascending
MSAA + IAccessible2 オブジェクト属性: sort:ascending
UIA プロパティ: AriaProperties.sort: ascending
プロパティ: ItemStatus: 要素が HeaderItem コントロールタイプにマップされる場合 ascending
ATK/AT-SPI オブジェクト属性: sort:ascending
AX API プロパティ: AXSortDirection: AXAscendingSortDirection
Android

未定

3.5.2.94 aria-sort=descending
ARIA 仕様 aria-sort=descending
MSAA + IAccessible2 オブジェクト属性: sort:descending
UIA プロパティ: AriaProperties.sort: descending
プロパティ: ItemStatus: 要素が HeaderItem コントロールタイプにマップされる場合 descending
ATK/AT-SPI オブジェクト属性: sort:descending
AX API プロパティ: AXSortDirection: AXDescendingSortDirection
Android

未定

3.5.2.95 aria-sort=other
ARIA 仕様 aria-sort=other
MSAA + IAccessible2 オブジェクト属性: sort:other
UIA プロパティ: AriaProperties.sort: other
プロパティ: ItemStatus: 要素が HeaderItem コントロールタイプにマップされる場合 other
ATK/AT-SPI オブジェクト属性: sort:other
AX API プロパティ: AXSortDirection: AXUnknownSortDirection
Android

未定

3.5.2.96 aria-sort=none
ARIA 仕様 aria-sort=none
MSAA + IAccessible2 オブジェクト属性: sort:none。値が未指定でない場合
UIA マップされない*
ATK/AT-SPI オブジェクト属性: sort:none。値が未指定でない場合
AX API マップされない*
Android

未定

3.5.2.97 aria-valuemax
ARIA 仕様 aria-valuemax
MSAA + IAccessible2 メソッド: IAccessibleValue::maximumValue(): <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
UIA プロパティ: RangeValue.Maximum: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
ATK/AT-SPI メソッド: atk_value_get_maximum_value(): <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
AX API プロパティ: AXMaxValue: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
Android

未定

3.5.2.98 aria-valuemin
ARIA 仕様 aria-valuemin
MSAA + IAccessible2 メソッド: IAccessibleValue::minimumValue(): <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
UIA プロパティ: RangeValue.Minimum: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
ATK/AT-SPI メソッド: atk_value_get_minimum_value(): <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
AX API プロパティ: AXMinValue: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
Android

未定

3.5.2.99 aria-valuenow
ARIA 仕様 aria-valuenow
MSAA + IAccessible2 メソッド: IAccessibleValue::currentValue(): <value>
メソッド: IAccessible::get_accValue(): aria-valuetext が定義されていない場合 <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
UIA プロパティ: RangeValue.Value: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
ATK/AT-SPI メソッド: atk_value_get_current_value(): <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
AX API プロパティ: AXValue: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
Android

未定

3.5.2.100 aria-valuetext
ARIA 仕様 aria-valuetext
MSAA + IAccessible2 メソッド: IAccessible::get_accValue(): <value>
オブジェクト属性: valuetext:<value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
UIA プロパティ: Value.Value: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
ATK/AT-SPI オブジェクト属性: valuetext:<value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
AX API プロパティ: AXValueDescription: <value>
関連項目: 状態およびプロパティに関する 著者エラーの処理
Android

未定

3.6 追加 計算を必要とする特別な処理

3.6.1 名前および説明

アクセシブルな名前または アクセシブルな説明を 算出する方法については、 アクセシブルな名前および 説明の算出仕様の アクセシブルな名前および説明の算出という題名のセクションを参照してください。

3.6.2 関係

GUI では、多くの場合、ウィジェット間に、支援技術へプログラム的に 公開できる関係があります。WAI-ARIA は、任意の要素にグローバルに適用可能な関係プロパティを いくつか提供します: aria-controls, aria-describedby, aria-flowto, aria-labelledby, aria-owns, aria-posinset, および aria-setsize。したがって、それらを算出する前に ロールを確認することは重要ではありません。ユーザーエージェントは、 これらの関係を、 アクセシビリティ API に、 状態およびプロパティのマッピングという題名のセクションで定義されるように 単純にマップできます。

3.6.2.1 逆関係

逆関係は、ある要素の ID が別のプロパティによって 参照される場合に存在します。逆関係をサポートする API については、ある要素の ID が別の要素の関係プロパティによって参照され、参照される要素がアクセシビリティツリー内にある場合、ユーザーエージェント状態およびプロパティのマッピング表で定義された マッピングを使用しなければなりません (MUST)。 すべての WAI-ARIA 参照は、アクセシビリティツリー内で アクセシブルオブジェクトとして公開されている要素を指さなければなりません。参照されるオブジェクトが アクセシビリティツリー内で公開されていない場合 (例えば、hidden であるため)、 参照は null です。aria-labelledby および aria-describedby には、 参照される要素からフラット化された文字列を取り出して、アクセシビリティ API の名前または説明フィールドを 埋めることを可能にする追加機能があります。この機能は、 名前および説明セクションで説明されています。

特別な場合: aria-labelledbyHTML <label for= … > の両方が使用されている場合、ユーザーエージェントは WAI-ARIA 関係を使用しなければならず (MUST)、 HTML label 関係を無視しなければなりません (MUST)。

aria-describedby は、ユーザーが コンテンツの異なるセクションへナビゲートできるようにしたい構造化情報または インタラクティブ情報を参照する場合があることに注意してください。ユーザーエージェントは、 aria-describedby によって 参照される構造化情報へユーザーがナビゲートするための手段を提供してもよく (MAY)、支援技術はそのような方法を 提供するべきです (SHOULD)。

3.6.2.2 暗黙の逆 関係

WAI-ARIA プロパティによって定義される 明示的な関係に加えて、逆関係は他の 2 つの状況でも暗黙に示されます: 祖先が aria-owns プロパティを持たない、role="treeitem" を持つ要素、および aria-atomic プロパティを持つ要素の子孫。

role="treeitem" の場合、 aria-owns が 使用されていないなら、逆関係が API によって サポートされている場合、ユーザー エージェントは次を行うべきです (SHOULD):

  • 現在の treeitemaria-level を使用する場合、 より低い aria-level を持つ treeitem が見つかるまでツリーを後方にたどり、 その要素に RELATION_NODE_CHILD_OF を設定します。ツリーの先頭に 到達した場合は、tree 要素自体に RELATION_NODE_CHILD_OF を設定します。
  • treeitem の親が ロール group を持つ場合、treeitem のロールを持つ要素が 見つかるまで group から後方にたどり、その要素に RELATION_NODE_CHILD_OF を設定します。

aria-atomic の場合、逆関係が API によってサポートされているなら:

  • ユーザーエージェントは、祖先要素の連鎖に aria-atomic="true" があるかを確認するべきです (SHOULD)。 見つかった場合、ユーザーエージェントは、 aria-atomic="true" を設定する祖先を指すように RELATION_MEMBER_OF 関係を設定するべきです (SHOULD)。

3.6.3 グループ位置

aria-level, aria-posinset, および aria-setsize はすべて 1 始まりです。 プロパティが存在しない、または "0" である場合、そのプロパティが算出されていない、またはサポートされていないことを示します。 これらのプロパティのいずれかが、著者によって "0" または負の数として指定された場合、ユーザーエージェントは代わりに "1" を使用するべきです (SHOULD)。

aria-level が、 ロール treeitem または comment の要素について提供または継承されていない場合、 IAccessible2 または ATK/AT-SPI を実装する ユーザーエージェントは、明示的または算出された RELATION_NODE_CHILD_OF 関係に従って それを算出しなければなりません (MUST)。

aria-posinset および aria-setsize が提供されていない場合、 ユーザーエージェントは次のように算出しなければなりません (MUST):

  • role="treeitem" および role="comment" については、 明示的または算出されたレベルが現在の項目のレベルより低くなるまで、ツリーを後方および前方に たどります。現在の項目と同じレベルにある場合にのみ項目を数えます。
  • それ以外の場合、ロールが aria-posinset および aria-setsize をサポートしているなら、 同じロールを持つ項目を数えて、親 (DOM 親または aria-owns によって定義される親) を 処理します。
  • これらの値は 1 始まりであるため、算出に現在の項目を含めます。aria-posinset については、 現在の項目と、DOM 内で現在の項目より前にある場合は他のグループ項目を 含めます。aria-setsize については、それに DOM 内で現在の項目より後にある同じグループ内の項目数を 加えます。

著者が aria-setsize および aria-posinset の 1 つ以上を提供する場合、 セット内のすべての要素についてそれらを提供する責任は著者にあります。この場合に欠落値を ユーザーエージェントが補正することは定義されていません。

MSAA/IAccessible2 API マッピングでは、 groupPosition() [IAccessible2] という追加関数が関与します。 これは、 aria-level, aria-posinset, および/または aria-setsize が要素上に存在する、 またはユーザーエージェントによって算出される場合です。これが発生した場合:

  • aria-levelgroupPosition()groupLevel パラメーターで公開されます。
  • aria-setsizesimilarItemsInGroup パラメーターで公開されます。
  • aria-posinsetpositionInGroup パラメーターで公開されます。

3.7 アクション

ロールマッピングで定義されるアクセシブルオブジェクトへのロールの マッピングの一環として、ユーザーエージェントは、そのオブジェクト上に既定のアクションを公開します。

注記

著者は、DOM 内の WAI-ARIA 状態およびプロパティを それに応じて更新する、それらのクリックイベント用のハンドラーを作成する必要があります。 これにより、それらの更新済み状態をユーザーエージェントが Accessibility API に反映できるようになります。

3.8 イベント

ユーザーエージェントは、ユーザー操作、WAI-ARIA 状態の変更、 文書コンテンツまたはノード可視性の変更、選択の変更、およびメニューの操作について、 以下のセクションで定義されるようにイベントを発火します。

3.8.1 状態およびプロパティ 変更イベント

ユーザーエージェントは、 下の表で定義されるように、状態変更を支援技術に通知しなければならず (MUST)、アクセシビリティ API がそのプロパティについて変更イベントを定義している場合、プロパティ変更を 支援技術に通知するべきであり (SHOULD)、 アクセシビリティ API がそのプロパティについて 変更イベントを定義していない場合、プロパティ変更を支援技術に通知するべきではありません (SHOULD NOT)。例えば、IAccessible2 は、 aria-activedescendant が変更された場合に 使用されるイベントを定義しています。 変更されることが期待される WAI-ARIA プロパティには、 aria-activedescendant, aria-valuenow, および aria-valuetext が含まれます。

注記

一部の API では、AT は、自身が購読しているイベントについてのみ 通知を受けます。

単純さおよび性能のために、ユーザーエージェントは、現在フォーカスを持たないウィンドウ内で 発生しているイベントなど、支援技術が通常無視する 状態またはプロパティ変更の変更イベントを取り除いてもよいです (MAY)。

注記

翻訳者向け: 次の表およびそのトグルボタンに関連付けられたラベルテキストについては、この文書の <head> セクション内の mappingTableLabels オブジェクトを 参照してください。

3.8.1.1 aria-activedescendant
ARIA 仕様 aria-activedescendant
MSAA + IAccessible2 イベント フォーカスの変更を参照。

さらに:

IA2_EVENT_ACTIVE_DESCENDANT_CHANGED

UIA イベント フォーカスの変更を参照。

さらに:

PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント フォーカスの変更を参照。
AX API 通知 フォーカスの変更を参照。

さらに: AXSelectedChildrenChanged

Android

未定

3.8.1.2 aria-busy (状態)
ARIA 仕様 aria-busy (状態)
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:state-changed:busy
AX API 通知 AXElementBusyChanged
Android

未定

3.8.1.3 aria-checked (状態)
ARIA 仕様 aria-checked (状態)
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaPropertiestoggle パターンの一部としての ToggleState

ATK/AT-SPI イベント object:state-changed:checked
AX API 通知 AXValueChanged
Android

未定

3.8.1.4 aria-current (状態)
ARIA 仕様 aria-current (状態)
MSAA + IAccessible2 イベント IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:state-changed:active
AX API 通知 AXCurrentStateChanged
Android

未定

3.8.1.5 aria-disabled (状態)
ARIA 仕様 aria-disabled (状態)
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties, IsEnabled

ATK/AT-SPI イベント object:state-changed:enabled および object:state-changed:sensitive
AX API 通知 AXDisabledStateChanged
Android

未定

3.8.1.6 aria-describedby
ARIA 仕様 aria-describedby
MSAA + IAccessible2 イベント EVENT_OBJECT_DESCRIPTIONCHANGE
UIA イベント PropertyChangedEvent

プロパティ: DescribedBy

ATK/AT-SPI イベント object:property-change:accessible-description
AX API 通知 AXDescribedByChanged
Android

未定

3.8.1.7 aria-dropeffect (プロパティ、非推奨)
ARIA 仕様 aria-dropeffect (プロパティ、非推奨)
MSAA + IAccessible2 イベント IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:property-change
AX API 通知 AXDropEffectChanged
Android

未定

3.8.1.8 aria-expanded (状態)
ARIA 仕様 aria-expanded (状態)
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties, ExpandCollapse パターンの一部としての ExpandCollapseState

ATK/AT-SPI イベント object:state-changed:expanded
AX API 通知 AXRowExpanded,
AXRowCollapsed,
AXRowCountChanged
Android

未定

3.8.1.9 aria-grabbed (状態、 非推奨)
ARIA 仕様 aria-grabbed (状態、非推奨)
MSAA + IAccessible2 イベント

EVENT_OBJECT_SELECTION

IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED

UIA イベント PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:property-change
AX API 通知 AXGrabbedStateChanged
Android

未定

3.8.1.10 aria-hidden (状態)
ARIA 仕様 aria-hidden (状態)
MSAA + IAccessible2 イベント IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED
UIA イベント StructureChangedEvent

PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:property-change
AX API 通知 AXUIElementDestroyed,
AXUIElementCreated
Android

未定

3.8.1.11 aria-invalid (状態)
ARIA 仕様 aria-invalid (状態)
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties, IsDataValidForForm

ATK/AT-SPI イベント object:state-changed:invalid_entry
AX API 通知 AXInvalidStatusChanged
Android

未定

3.8.1.12 aria-label および aria-labelledby
ARIA 仕様 aria-label および aria-labelledby
MSAA + IAccessible2 イベント EVENT_OBJECT_NAMECHANGE
UIA イベント PropertyChangedEvent

aria-label のプロパティ: AriaProperties

aria-labelledby のプロパティ: LabeledBy

ATK/AT-SPI イベント object:property-change:accessible-name
AX API 通知 AXLabelCreated
Android

未定

3.8.1.13 aria-pressed (状態)
ARIA 仕様 aria-pressed (状態)
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties, toggle パターンの一部としての ToggleState

ATK/AT-SPI イベント object:state-changed:pressed
AX API 通知 AXPressedStateChanged
Android

未定

3.8.1.14 aria-readonly
ARIA 仕様 aria-readonly
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:state-changed:readonly
AX API 通知 AXReadOnlyStatusChanged
Android

未定

3.8.1.15 aria-required
ARIA 仕様 aria-required
MSAA + IAccessible2 イベント EVENT_OBJECT_STATECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties, IsRequiredForForm

ATK/AT-SPI イベント object:state-changed:required
AX API 通知 AXRequiredStatusChanged
Android

未定

3.8.1.16 aria-selected (状態)
ARIA 仕様 aria-selected (状態)
MSAA + IAccessible2 イベント 詳細については 選択セクションを参照。
UIA イベント 詳細については 選択セクションを参照。
ATK/AT-SPI イベント 詳細については 選択セクションを参照。
AX API 通知 詳細については 選択セクションを参照。
Android

未定

3.8.1.17 aria-valuenow
ARIA 仕様 aria-valuenow
MSAA + IAccessible2 イベント EVENT_OBJECT_VALUECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties、要素が RangeValue コントロール パターンでマップされる場合は RangeValueValue も含む

ATK/AT-SPI イベント object:property-change:accessible-value
AX API 通知 AXValueChanged
Android

未定

3.8.1.18 aria-valuetext
ARIA 仕様 aria-valuetext
MSAA + IAccessible2 イベント EVENT_OBJECT_VALUECHANGE
UIA イベント PropertyChangedEvent

プロパティ: AriaProperties

ATK/AT-SPI イベント object:property-change:accessible-value
AX API 通知 AXValueChanged
Android

未定

3.8.2 文書コンテンツまたはノード可視性の変更

文書変更の処理は、WAI-ARIA に関係なく重要です。下の表で 説明されるイベントは、ユーザーエージェントがアクセシビリティツリーを介して DOM の変更を AT に通知するために使用されます。この標準への適合の目的で、 Web ページ上の動的コンテンツに WAI-ARIA 属性が適用されている場合は常に、ユーザー エージェントはこのセクションで説明される動作を実装しなければなりません (MUST)。

API で発火される文書変更シナリオおよびイベントの表
シナリオ MSAA + IAccessible2 イベント UIA イベント ATK/AT-SPI イベント AX API 通知
テキストが削除される場合 IA2_EVENT_TEXT_REMOVED EVENT_OBJECT_LIVEREGIONCHANGED text_changed::delete ライブ領域内の場合、 AXLiveRegionChanged
aria-errormessage 内の場合、 AXValidationErrorChanged
テキストが挿入される場合 IA2_EVENT_TEXT_INSERTED EVENT_OBJECT_LIVEREGIONCHANGED text_changed::insert ライブ領域内の場合、 AXLiveRegionChanged
aria-errormessage 内の場合、 AXValidationErrorChanged
テキストが変更される場合 IA2_EVENT_TEXT_REMOVE および IA2_EVENT_TEXT_INSERTED EVENT_OBJECT_LIVEREGIONCHANGED text_changed::delete および text_changed::insert ライブ領域内の場合、 AXLiveRegionChanged
aria-errormessage 内の場合、 AXValidationErrorChanged

対象のノードが要素であり、アクセシブルオブジェクトを持つ ノード変更について、次のイベントを発火します。ノードの アクセシビリティサブツリーとは、アクセシビリティ ツリー内のそのアクセシブルオブジェクトと、 そのすべてのアクセシビリティ 子孫です。そのツリー内で親子以外の関係を持つオブジェクトは含まれません。例えば、 aria-flowto によってリンクされるオブジェクトは、 それらのオブジェクトがアクセシビリティツリー内の 子孫でもない限り、含まれません。

API で発火される文書変更シナリオおよびイベントの表
シナリオ MSAA Microsoft UIA イベント ATK/AT-SPI イベント AX API 通知
アクセシビリティ サブツリーhidden になる場合 EVENT_OBJECT_HIDE
EVENT_OBJECT_DESTROY という MSAA イベントは使用されません。これは安定性の問題の履歴があり、支援技術がそれを避けるためです。 いずれの場合でも、ユーザーの観点からは、何かが隠されることと破棄されることの間に違いはありません。
AutomationElement..::.StructureChangedEvent children_changed::remove

AXUIElementDestroyed

ライブ領域内の場合、AXLiveRegionChanged

アクセシビリティサブツリーが削除される場合 EVENT_OBJECT_REORDER
EVENT_OBJECT_DESTROY という MSAA イベントは使用されません。これは安定性の問題の履歴があり、支援技術がそれを避けるためです。 いずれの場合でも、ユーザーの観点からは、何かが隠されることと破棄されることの間に違いはありません。
AutomationElement..::.StructureChangedEvent children_changed::remove

AXUIElementDestroyed

ライブ領域内の場合、AXLiveRegionChanged

アクセシビリティサブツリーが表示される場合 EVENT_OBJECT_SHOW   children_changed::add

AXUIElementCreated

ライブ領域内の場合、AXLiveRegionChanged

アクセシビリティサブツリーが挿入される場合 EVENT_OBJECT_REORDER   children_changed::add

AXUIElementCreated

ライブ領域内の場合、AXLiveRegionChanged

アクセシビリティサブツリーが移動される場合 ある場所からの削除および別の場所への挿入として扱う ある場所からの削除および別の場所への挿入として扱う ある場所からの削除および別の場所への挿入として扱う

AXUIElementDestroyed/ AXUIElementCreated

ライブ領域内の場合、AXLiveRegionChanged

アクセシビリティサブツリーが変更される場合 (例えば replaceNode) 削除および挿入として扱う 削除および挿入として扱う 削除および挿入として扱う

AXUIElementDestroyed/ AXUIElementCreated

ライブ領域内の場合、AXLiveRegionChanged

場合によっては、ノードが要素でない、またはアクセシブルオブジェクトを持たない場所でノード変更が 発生することがあります。例えば、番号付きリストの箇条書き記号 ("12.") はアクセシビリティツリー内に ノードを持つ場合がありますが、DOM ツリー内には持ちません。 HTML<strong> として マークされた段落内のテキストについては、<strong> 要素は DOM ツリー内にノードを持ちますが、 アクセシビリティツリー内には持たない場合があります。もちろん、テキスト自体は、strong として 書式設定されたテキスト範囲の識別情報とともにアクセシビリティツリー内にあります。上の表で説明される 変更のいずれかがそのようなノード上で発生する場合、ユーザーエージェントは、上で説明されるように 関連するテキスト変更イベントを算出して発火するべきです (SHOULD)。

ユーザーエージェントは、プロセス内で実行されている支援技術が、ノードの削除前にその削除についての 通知を受け取れるようにするべきです (SHOULD)。これにより、 スクリーンリーダーなどの支援技術は、削除される対応する DOM ノードを後から参照できます。これは、削除が重要な ライブ領域にとって重要です。 例えば、スクリーンリーダーは、別のユーザーがチャットルームを退出したことをユーザーに通知したいでしょう。 MSAA におけるイベントは EVENT_OBJECT_HIDE です。 ATK/AT-SPI では、これは children_changed::remove です。そして macOS では、イベントは AXLiveRegionChanged です。これには、削除される一意のノードを識別する一意の ID を、 ユーザーエージェントが アクセシビリティ API 通知内で提供することも必要です。

上記の変更イベントのいずれかを発火する場合、その変更がユーザー入力によって引き起こされたか (ページ読み込みから開始されたタイムアウトなどではなく) についての情報を提供することは非常に有用です。 これにより、支援技術は、ユーザー操作からの変更ではなく現実世界からの変更を提示するために 異なる規則を持つことができます。マウスホバーは、マウスの偶発的な接触から発生し得るため、 明示的なユーザー入力とは見なされません。

変更がユーザー入力から発生したかどうかを公開するには:

  • ATK/AT-SPI では、ユーザーが その変更を引き起こしていない場合に、イベント名に文字列 ":system" を追加することで提供できます。
  • スクリーンリーダーが通常同じスレッド上のプロセス内でアクセスする IAccessible2 では、 ユーザーが変更を引き起こした場合、そのイベントのアクセシブルオブジェクト上に オブジェクト属性 event-from-user-input:true を公開することがベストプラクティスです。

変更のコンテキストについて追加の有用な情報を公開する:

  • ATK/AT-SPI および IAccessible2 では、 アクセシブルイベントの対象アクセシブルオブジェクト上の RELATION_MEMBER_OF 関係は、(もしあれば) aria-atomic="true" を持つ任意の祖先を指すべきです (SHOULD)。
  • ATK/AT-SPI および IAccessible2 では、 container-live, container-relevant, container-busy, container-atomic オブジェクト属性をアクセシブルイベントオブジェクト上に公開し、関連する WAI-ARIA プロパティの算出値を提供する べきです (SHOULD)。算出値は最も近い祖先の値です。 既定値が使用されている場合、オブジェクト属性を公開しないことが推奨されます。

追加の MSAA イベントが必要な場合があります:

  • ROLE_SYSTEM_ALERT のマップ済み MSAA ロールを持つ祖先内で何かが変更された場合、 alert について EVENT_SYSTEM_ALERT イベントを発火するべきです (SHOULD)。 alert ロールには、 aria-live プロパティについて "assertive" の暗黙値があります。
  • メニューイベントを発火する必要がある場合があります。メニュー用の特別な イベントを参照してください。

3.8.3 フォーカスの変更

次の表は、アクセシビリティ API のキーボードフォーカス状態およびイベントを定義します。

フォーカス状態および イベントについての アクセシビリティ API の表
  MSAA Microsoft UIA ATK/AT-SPI AX API
フォーカス可能状態 STATE_SYSTEM_FOCUSABLE 現在の状態は IUIAutomationElement::CurrentIsKeyboardFocusable に反映され、 UIA_IsKeyboardFocusablePropertyId プロパティ識別子を使用して IUIAutomationElement::GetCurrentPropertyValue メソッドで取得できます。 STATE_FOCUSABLE boolean AXFocused: AXUIElementIsAttributeSettable メソッドは YES を返します。
フォーカス済み状態 STATE_SYSTEM_FOCUSED 現在の状態は IUIAutomationElement::CurrentHasKeyboardFocus に反映され、 UIA_HasKeyboardFocusPropertyId プロパティ識別子を使用して IUIAutomationElement::GetCurrentPropertyValue メソッドで 取得できます。 STATE_FOCUSED boolean AXFocused
フォーカスイベント EVENT_OBJECT_FOCUS クライアントは、コールバックインターフェイス IUIAutomationFocusChangedEventHandler を 使用して IUIAutomation::AddFocusChangedEventHandler で購読できます object:state-changed:focused および: AXFocusedUIElementChanged

3.8.4 選択

選択には 2 つの場合があります:

  • 単一選択
  • 複数選択

単一選択の場合、選択はフォーカスに従います (フォーカスイベントに関する情報については 「フォーカス状態およびイベント表」セクションを参照してください)。 aria-selected が変更される場合、ユーザーエージェントは次のイベントを発火しなければなりません (MUST):

単一選択イベント
シナリオ MSAA Microsoft UIA ATK/AT-SPI AX API
フォーカス変更 新しくフォーカスされた項目上で EVENT_OBJECT_SELECTION および EVENT_OBJECT_STATECHANGE 新しくフォーカスされた要素上で UIA_SelectionItem_ElementSelectedEventId

gridcell, row, option, または tab 上の場合、UIA_SelectionItem_ElementSelectedEventId を 発火します。

  • 現在のコンテナー上で object:selection-changed
  • 選択が変更された子孫のアクセシブル オブジェクト上で object:state-changed:selected:
    • 選択されたばかりの子孫については detail1 = 1
    • 選択解除されたばかりの子孫については detail1 = 0
AXSelectedChildrenChanged

複数選択の場合は、そのロールがそのプロパティをサポートする要素上に aria-multiselectable="true" がある場合に発生します。子孫上で aria-selected が変更される場合、ユーザーエージェントは次のイベントを次のように発火しなければなりません (MUST):

複数選択の場合は、そのロールがそのプロパティをサポートする要素上に aria-multiselectable="true" がある場合に発生します。いくつかの重要な側面があります:

  1. Microsoft UIA では、Selection および SelectionItem コントロールパターンが、選択の可用性、状態、および メソッドを公開します。
  2. 子孫上で aria-selected が変更される場合、ユーザーエージェントは次のイベントを次のように発火しなければなりません (MUST):
複数選択イベント
シナリオ MSAA Microsoft UIA ATK/AT-SPI AX API
aria-selected を トグルする 項目上で EVENT_OBJECT_SELECTIONADD/EVENT_OBJECT_SELECTIONREMOVE SelectionItem Control Pattern: 項目上で UIA_SelectionItem_ElementAddedToSelectionEventId または UIA_SelectionItem_ElementRemovedFromSelectionEventId
  • 現在のコンテナー上で object:selection-changed
  • 選択が変更された任意の子孫アクセシブル オブジェクト上で object:state-changed:selected:
    • 選択されたばかりの任意の子孫については detail1 = 1
    • 選択解除されたばかりの任意の子孫については detail1 = 0
AXSelectedChildrenChanged
選択がフォーカスに従う 新しくフォーカスされた項目上で EVENT_OBJECT_SELECTION および EVENT_OBJECT_STATECHANGE FocusChangedEvent を発火するべきですが、冗長性を避けるため、 個別の選択イベントは発生しない場合があります。 AXSelectedChildrenChanged
多数の項目を一度に選択または選択解除する ユーザーエージェントは EVENT_OBJECT_SELECTIONWITHIN を発火してもよいです (MAY)。 このイベントが発火される場合、上記の他のイベントは性能のために取り除かれてもよいです (MAY)。 選択または選択解除された各要素について、現在のコンテナー上で SelectionItem コントロールパターン: UIA_SelectionItem_ElementAddedToSelectionEventId または UIA_SelectionItem_ElementRemovedFromSelectionEventId を発火します。 ユーザーエージェントは、Selection コントロールパターン Invalidated イベントを 発火することを選択してもよく (MAY)、これはコンテナー内の選択が 大幅に変更され、InvalidateLimit 定数が許可するよりも多くの追加および削除イベントを 送信する必要があることを示します。 AXSelectedChildrenChanged

3.8.5 メニュー用の特別なイベント

一部の API は、メニューが開かれる、または 閉じられるたびに特別なイベントを提供します。ユーザーエージェントは、 下の表で説明されるようにイベントを提供するべきです (SHOULD)。提供される場合、メニューはさまざまな技術を使用して可視にしたり hidden にしたりできるため、ユーザー エージェントは、イベントが入れ子で対称であることを保証しなければなりません (MUST)。

多くの場合、menubar は、メニューの階層を 編成するために使用されます。そのような場合、menubar は、関連付けられた menuitem たちの DOM 親、または aria-owns によって定義される親でなければなりません (MUST)。それ以外の場合、menubar が関与しないこともあります。例えば、 menu がツールバーボタンに関連付けられている場合、 またはコンテキストメニューである場合です。 それでも、関連するメニューイベントは次の表で説明されるように提供されます。

メニューイベント
シナリオ MSAA Microsoft UIA AX API

Menubar が現在アクティブではなく、ユーザーが他の場所から menubar へフォーカスを移動し、 それによって menubar がアクティブ化される。その結果、menubar 内の menuitem に フォーカスが置かれる。

menubar をアクティブ化し、menubar のアクセシブルオブジェクト上で EVENT_SYSTEM_MENUSTART を発火します。 menu のアクセシブルオブジェクト上で MenuModeStartEvent AXMenuOpenedNotification

menubar がアクティブ化されている間に menuitem にフォーカスする、または menu 内の menuitem にフォーカスする。

EVENT_OBJECT_FOCUS AutomationFocusChangedEvent AXMenuItemSelectedNotification

Menu popup が可視になる (menu が開かれる)。

menu が閉じられて再度開かれるまで、一度だけ発火されるべきです。

EVENT_SYSTEM_MENUPOPUPSTART MenuOpenedEvent、その後 menuitem 上で focus イベント。 AXMenuOpenedNotification
Menu popup が hidden になる (menu が閉じられる)。 アクセシブル menu オブジェクトについて一度だけ、かつ EVENT_SYSTEM_MENUPOPUPSTART がそれについて発火された場合にのみ EVENT_SYSTEM_MENUPOPUPEND MenuClosedEvent AXMenuClosedNotification
サブメニューを含む開いている任意の menu が閉じられ、ユーザーがフォーカスを menubar から 移動する。menubar は非アクティブ化される。 menubar 上で EVENT_SYSTEM_MENUEND を発火し、menubar を非アクティブ化します。 MenuClosedEvent、その後 MenuModeEndEvent AXMenuClosedNotification

4. アルゴリズム

一部の API は、特定の アルゴリズムに従う必要があるメソッドを提供します。以下のセクションでは、 これらのメソッドについてのアルゴリズムマッピング表を提供します。

4.1 ARIANotifyMixin アルゴリズムマッピング表

ARIANotifyMixin は、支援技術へコンテンツを通知するためのメソッドを提供します。 以下のアルゴリズムマッピングは、支援技術のユーザーに一貫した動作を保証するために、 これらの通知が異なるアクセシビリティ API 間で どのように実装されるかを指定します。

4.1.1 ariaNotify

node, announcement, および priority が与えられたときに aria notify するには:

ARIA 仕様 aria notify
事前条件

nodeアクセシビリティツリーから 除外されている場合、これらの手順を中止します。

言語

ユーザーエージェントおよび支援技術は、次のソースから最初の有効な BCP 47 言語タグを取得することにより、通知の言語を決定しなければなりません (MUST):

  1. node の最も近い祖先要素の lang 属性 (node 自身を含む)。
  2. 文書要素の lang 属性 (文書上で呼び出された場合を含む)。
  3. ユーザーエージェントまたはプラットフォームの既定値。

支援技術は、その言語を使用して通知を提示しなければなりません (MUST) (例えば、音声、発音規則、点字表)。

MSAA + IAccessible2

実装は指定されていません (フォールバック注記を参照)。

UIA
  1. priority が "high" である場合は NotificationProcessing_ImportantAll、それ以外の場合は NotificationProcessing_Allmapped_priority とします。

  2. node, NotificationKind_ActionCompleted, mapped_priority, announcement, および空 文字列を指定して UiaRaiseNotificationEvent を呼び出します。

注記

プラットフォームのアクセシビリティ実装が、nodeUIA Control view または Content view に表されていないと判断した場合、ユーザーエージェントは代わりに、 UIA Control として表されている 最も近い祖先上で通知イベントを発生させるべきです (SHOULD)。そのような祖先が存在しない場合、 ユーザーエージェントは、Control view または Content view のいずれかにあることが 期待される文書ルート上で通知イベントを発生させるべきです (SHOULD)。これにより、Control view または Content view にない 要素上のイベントを無視する支援技術が通知を受け取れることを保証します。

ATK
  1. priority が "high" である場合は Atk.Live.ATK_LIVE_ASSERTIVE、 それ以外の場合は Atk.Live.ATK_LIVE_POLITEmapped_priority とします。

  2. node, "notification", announcement, および mapped_priority を指定して g_signal_emit_by_name を呼び出します。

ATK 2.50.0 より前の古い Linux アクセシビリティスタックでは、ユーザーエージェントはフォールバックを使用してもよいです (MAY); フォールバック注記を参照

AT-SPI
  1. priority が "high" である場合は ATSPI_LIVE_ASSERTIVE、 それ以外の場合は ATSPI_LIVE_POLITEmapped_priority とします。

  2. node, "announcement", announcement, および mapped_priority を指定して、DBUS シグナル ATSPI_DBUS_INTERFACE_EVENT_OBJECT を送信します。

AX API
  1. priority が "high" である場合は NSAccessibilityPriorityHigh、 それ以外の場合は NSAccessibilityPriorityMediummapped_priority とします。

  2. 次のキーを持つ NSDictionaryuserInfo とします:

    1. NSAccessibilityAnnouncementKeyannouncement として
    2. NSAccessibilityPriorityKeymapped_priority として
  3. node, NSAccessibilityAnnouncementRequestedNotification, および userInfo を指定して NSAccessibilityPostNotificationWithUserInfo を呼び出します。

注記

適切なプラットフォーム通知 API が利用できない場合 (例えば、新しい notification シグナルを欠く ATK 2.50.0 より前の 古い Linux アクセシビリティスタック、または Windows 上でユーザーエージェントが UIA を使用できない場合)、ユーザーエージェントは aria notify 通知を伝えるために、アクセシビリティツリー内に一時的な支援技術専用の ライブ領域を合成してもよいです (MAY)。そのような フォールバックノードは Web コンテンツへ公開されず、Web コンテンツから検出することもできず、 この動作は必須ではありません。

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

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

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

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

A. 変更履歴

A.1 最後の Candidate Recommendation Snapshot 以降の実質的な変更

A.2 Core Accessibility API Mappings 1.1 Recommendation 以降の実質的な変更

B. 謝辞

このセクションは非規範的です。

以下の人々がこの文書の開発に貢献しました。

B.1 公開時点の ARIA WG 参加者

B.2 支援資金提供者

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

C. 参考文献

C.1 規範参照

[HTML-AAM]
HTML Accessibility API Mappings 1.0. Scott O'Hara; Rahim Abdi. W3C. 24 April 2026. W3C Working Draft. URL: https://www.w3.org/TR/html-aam-1.0/
[IAccessible2]
IAccessible2. Linux Foundation. URL: https://wiki.linuxfoundation.org/accessibility/iaccessible2/
[infra]
Infra Standard. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/
[RFC2119]
Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]
Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174
[wai-aria]
Accessible Rich Internet Applications (WAI-ARIA) 1.0. James Craig; Michael Cooper et al. W3C. 20 March 2014. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria/
[WAI-ARIA-1.2]
Accessible Rich Internet Applications (WAI-ARIA) 1.2. Joanmarie Diggs; James Nurthen; Michael Cooper; Carolyn MacLeod. W3C. 6 June 2023. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria-1.2/

C.2 参考参照

[accname-1.2]
Accessible Name and Description Computation 1.2. Bryan Garaventa; Melanie Sumner. W3C. 24 April 2026. W3C Working Draft. URL: https://www.w3.org/TR/accname-1.2/
[Android-Accessibility-API]
Android Accessibility API. Google. URL: https://developer.android.com/guide/topics/ui/accessibility
[AT-SPI]
Assistive Technology Service Provider Interface. The GNOME Project. URL: https://gnome.pages.gitlab.gnome.org/at-spi2-core/libatspi/
[ATK]
ATK - Accessibility Toolkit. The GNOME Project. URL: https://developer.gnome.org/atk/stable/
[AXAPI]
The NSAccessibility Protocol for macOS. Apple, Inc. URL: https://developer.apple.com/documentation/appkit/nsaccessibility
[CORE-AAM-1.1]
Core Accessibility API Mappings 1.1. Joanmarie Diggs; Joseph Scheuhammer; Richard Schwerdtfeger; Michael Cooper; Andi Snow-Weaver; Aaron Leventhal. W3C. 14 December 2017. W3C Recommendation. URL: https://www.w3.org/TR/core-aam-1.1/
[dom]
DOM Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/
[UI-AUTOMATION]
UI Automation. Microsoft Corporation. URL: https://docs.microsoft.com/en-us/windows/win32/winauto/ui-automation-specification
[UIA-EXPRESS]
The IAccessibleEx Interface. Microsoft Corporation. URL: https://docs.microsoft.com/en-us/windows/win32/winauto/iaccessibleex
[WAI-ARIA-ROADMAP]
Roadmap for Accessible Rich Internet Applications (WAI-ARIA Roadmap). Richard Schwerdtfeger. W3C. 4 February 2008. W3C Working Draft. URL: https://www.w3.org/TR/wai-aria-roadmap/