コアアクセシビリティ API マッピング 1.2
W3C 勧告候補草案 2026年4月30日
この文書についての詳細
このバージョン:
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. )
Cynthia Shelly (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
(プル
リクエスト ,
新しい課題 ,
未解決の課題 )
Copyright
©
2014-2026
World Wide Web Consortium .
W3C ®
liability ,
trademark and
permissive document license rules apply.
概要
この文書は、ユーザー
エージェント が 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 スイートの一部です。
目次
概要
この文書の状態
1. はじめに
1.1 アクセシビリティ
API
1.2
アクセシビリティ API の比較
1.2.1
ATK /AT -SPI
1.2.2
UIA (UI Automation)
1.2.3 Android Accessibility API
1.2.4 アクセシブルな名前と説明
2. 適合性
2.1 WAI-ARIA で非推奨とされた機能
3. WAI-ARIA からアクセシビリティ API へのマッピング
3.1 WAI-ARIA
セマンティクスを公開するための一般規則
3.2
ネイティブマークアップセマンティクスと WAI-ARIA
の競合
3.3
アクセシビリティ API
プロパティに直接マップされない属性の公開
3.4 ロール
マッピング
3.4.1 一般規則
3.4.2 算出ロール
3.4.3
ロールマッピング表
3.4.3.1 alert
3.4.3.2 alertdialog
3.4.3.3 application
3.4.3.4 article
3.4.3.5 banner
3.4.3.6 blockquote
3.4.3.7 aria-pressed および
aria-haspopup の既定値を持つ button
3.4.3.8 aria-haspopup に
non-false 値を持つ button
3.4.3.9 aria-pressed に定義済み値を持つ
button
3.4.3.10 caption
3.4.3.11 cell
3.4.3.12 checkbox
3.4.3.13 code
3.4.3.14 columnheader
3.4.3.15 combobox
3.4.3.16 comment
3.4.3.17 complementary
3.4.3.18 contentinfo
3.4.3.19 definition
3.4.3.20 deletion
3.4.3.21 dialog
3.4.3.22 directory (非推奨)
3.4.3.23 document
3.4.3.24 emphasis
3.4.3.25 feed
3.4.3.26 figure
3.4.3.27 アクセシブルな
名前を持つ form
3.4.3.28 アクセシブルな
名前を持たない form
3.4.3.29 generic
3.4.3.30 grid
3.4.3.31 gridcell
3.4.3.32 group
3.4.3.33 heading
3.4.3.34 image
3.4.3.35 img
3.4.3.36 insertion
3.4.3.37 link
3.4.3.38 list
3.4.3.39 combobox の
アクセシビリティ親を持たない listbox
3.4.3.40 combobox のアクセシビリティ
親を持つ listbox
3.4.3.41 listitem
3.4.3.42 log
3.4.3.43 main
3.4.3.44 mark
3.4.3.45 marquee
3.4.3.46 math
3.4.3.47 menu
3.4.3.48 menubar
3.4.3.49 menuitem
3.4.3.50 menuitemcheckbox
3.4.3.51 menuitemradio
3.4.3.52 meter
3.4.3.53 navigation
3.4.3.54 none
3.4.3.55 note
3.4.3.56 combobox 内にない
option
3.4.3.57 combobox 内の
option
3.4.3.58 paragraph
3.4.3.59 presentation
3.4.3.60 progressbar
3.4.3.61 radio
3.4.3.62 radiogroup
3.4.3.63 アクセシブルな
名前を持つ region
3.4.3.64 アクセシブルな
名前を持たない region
3.4.3.65 treegrid 内にない
row
3.4.3.66 treegrid 内の
row
3.4.3.67 rowgroup
3.4.3.68 rowheader
3.4.3.69 scrollbar
3.4.3.70 search
3.4.3.71 searchbox
3.4.3.72 sectionfooter
3.4.3.73 sectionheader
3.4.3.74 separator (フォーカス不可)
3.4.3.75 separator (フォーカス可能)
3.4.3.76 slider
3.4.3.77 spinbutton
3.4.3.78 status
3.4.3.79 strong
3.4.3.80 subscript
3.4.3.81 suggestion
3.4.3.82 superscript
3.4.3.83 switch
3.4.3.84 tab
3.4.3.85 table
3.4.3.86 tablist
3.4.3.87 tabpanel
3.4.3.88 term
3.4.3.89 aria-multiline が
false の場合の textbox
3.4.3.90 aria-multiline が
true の場合の textbox
3.4.3.91 time
3.4.3.92 timer
3.4.3.93 toolbar
3.4.3.94 tooltip
3.4.3.95 tree
3.4.3.96 treegrid
3.4.3.97 treeitem
3.5
状態およびプロパティのマッピング
3.5.1 一般規則
3.5.2 状態およびプロパティのマッピング表
3.5.2.1
マップされない
3.5.2.2 aria-activedescendant
3.5.2.3
aria-atomic=true
3.5.2.4
aria-atomic=false
3.5.2.5
aria-autocomplete=inline, list,
または both
3.5.2.6
aria-autocomplete=none
3.5.2.7 aria-braillelabel
3.5.2.8 aria-brailleroledescription
3.5.2.9
aria-brailleroledescription が未定義または空の
文字列
3.5.2.10
aria-busy=true
3.5.2.11
aria-busy=false
3.5.2.12
aria-checked=true
3.5.2.13
aria-checked=false
3.5.2.14
aria-checked=mixed
3.5.2.15 aria-checked が未定義
3.5.2.16 aria-colcount
3.5.2.17 aria-colindex
3.5.2.18 aria-colindextext
3.5.2.19 aria-colspan
3.5.2.20 aria-controls
3.5.2.21 non-false の許可値を持つ
aria-current
3.5.2.22 認識されない
値を持つ aria-current
3.5.2.23 aria-current が
false または未定義
3.5.2.24 aria-describedby
3.5.2.25 aria-description
3.5.2.26 aria-details
3.5.2.27
aria-disabled=true
3.5.2.28
aria-disabled=false
3.5.2.29
aria-dropeffect=copy, move,
link, execute, または popup (非推奨)
3.5.2.30
aria-dropeffect=none (非推奨)
3.5.2.31 aria-errormessage
3.5.2.32
aria-expanded=true
3.5.2.33
aria-expanded=false
3.5.2.34 aria-expanded が未定義
3.5.2.35 aria-flowto
3.5.2.36
aria-grabbed=true
3.5.2.37
aria-grabbed=false
3.5.2.38 aria-grabbed が未定義
3.5.2.39
aria-haspopup=true
3.5.2.40
aria-haspopup=false
3.5.2.41
aria-haspopup=dialog
3.5.2.42
aria-haspopup=grid
3.5.2.43
aria-haspopup=listbox
3.5.2.44
aria-haspopup=menu
3.5.2.45
aria-haspopup=tree
3.5.2.46 フォーカスされていない要素上の
aria-hidden=true
3.5.2.47 要素がフォーカスされている場合、またはアクセシビリティイベントを発火する場合の
aria-hidden=true
3.5.2.48
aria-hidden=false
3.5.2.49
aria-invalid=true
3.5.2.50
aria-invalid=false
3.5.2.51
aria-invalid=spelling または
grammar
3.5.2.52 認識されない
値を持つ aria-invalid
3.5.2.53 aria-keyshortcuts
3.5.2.54
aria-label
3.5.2.55 aria-labelledby
3.5.2.56
non-heading 上の aria-level
3.5.2.57 heading 上の
aria-level
3.5.2.58
aria-live=assertive
3.5.2.59
aria-live=polite
3.5.2.60 aria-live=off
3.5.2.61
aria-modal=true
3.5.2.62
aria-modal=false
3.5.2.63
aria-multiline=true
3.5.2.64
aria-multiline=false
3.5.2.65
aria-multiselectable=true
3.5.2.66
aria-multiselectable=false
3.5.2.67
aria-orientation=horizontal
3.5.2.68
aria-orientation=vertical
3.5.2.69 aria-orientation が
未定義
3.5.2.70
aria-owns
3.5.2.71 aria-placeholder
3.5.2.72 aria-posinset
3.5.2.73
aria-pressed=true
3.5.2.74
aria-pressed=mixed
3.5.2.75
aria-pressed=false
3.5.2.76 aria-pressed が未定義
3.5.2.77
aria-readonly=true
3.5.2.78
aria-readonly=false
3.5.2.79
gridcell 上で aria-readonly が指定されていない
3.5.2.80 aria-relevant
3.5.2.81
aria-required=true
3.5.2.82
aria-required=false
3.5.2.83 aria-roledescription
3.5.2.84 aria-roledescription が
未定義または空の文字列
3.5.2.85 aria-rowcount
3.5.2.86 aria-rowindex
3.5.2.87 aria-rowindextext
3.5.2.88 aria-rowspan
3.5.2.89
aria-selected=true
3.5.2.90
aria-selected=false
3.5.2.91 aria-selected が未定義
3.5.2.92 aria-setsize
3.5.2.93
aria-sort=ascending
3.5.2.94
aria-sort=descending
3.5.2.95
aria-sort=other
3.5.2.96
aria-sort=none
3.5.2.97 aria-valuemax
3.5.2.98 aria-valuemin
3.5.2.99 aria-valuenow
3.5.2.100 aria-valuetext
3.6
追加の計算を必要とする特別な処理
3.6.1 名前と説明
3.6.2 関係
3.6.2.1 逆関係
3.6.2.2
暗黙の逆関係
3.6.3 グループ位置
3.7
アクション
3.8
イベント
3.8.1 状態およびプロパティ変更イベント
3.8.1.1 aria-activedescendant
3.8.1.2 aria-busy (状態)
3.8.1.3 aria-checked (状態)
3.8.1.4 aria-current (状態)
3.8.1.5 aria-disabled (状態)
3.8.1.6 aria-describedby
3.8.1.7 aria-dropeffect (プロパティ,
非推奨)
3.8.1.8 aria-expanded (状態)
3.8.1.9 aria-grabbed (状態,
非推奨)
3.8.1.10 aria-hidden (状態)
3.8.1.11 aria-invalid (状態)
3.8.1.12 aria-label および
aria-labelledby
3.8.1.13 aria-pressed (状態)
3.8.1.14 aria-readonly
3.8.1.15 aria-required
3.8.1.16 aria-selected (状態)
3.8.1.17 aria-valuenow
3.8.1.18 aria-valuetext
3.8.2 文書コンテンツまたはノード可視性の変更
3.8.3 フォーカスの変更
3.8.4 選択
3.8.5
メニューのための特別なイベント
4. アルゴリズム
4.1 ARIANotifyMixin アルゴリズムマッピング表
4.1.1 ariaNotify
5. プライバシーに関する
考慮事項
6.
セキュリティに関する
考慮事項
A. 変更履歴
A.1 最後の 勧告候補スナップショット 以降の実質的な変更
A.2 Core
Accessibility API Mappings 1.1
勧告 以降の実質的な変更
B.
謝辞
B.1 公開時点の ARIA WG
参加者
B.2 支援資金提供者
C. 参考文献
C.1
規範参照
C.2
参考参照
プラットフォームのアクセシビリティ 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 固有の状態 およびプロパティ を設定することを指します。
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 セマンティクスを持つホスト言語機能に対応する場合、
値が同期しなくなると問題になることがあります。例えば、
HTML の checked 属性と
aria-checked 属性が競合する値を持つ可能性があります。したがって、
支援技術に競合する状態およびプロパティを提供することを防ぐために、ホスト言語は、
ホスト言語要素上での WAI-ARIA 属性の使用が、
その要素のネイティブ属性と競合する箇所を明示的に宣言します。ホスト言語が、ある要素について
WAI-ARIA の属性 が
ネイティブ属性と直接的なセマンティック競合にあると宣言する場合、ユーザー
エージェントはその WAI-ARIA
属性を無視し、代わりに同じ暗黙のセマンティクスを持つホスト
言語属性を使用しなければなりません (MUST )。
ホスト言語は、WAI-ARIA で上書きできない機能も文書化することがあります
(これらは「強いネイティブ
セマンティクス」と呼ばれます)。これらは、暗黙の WAI-ARIA
セマンティクスを持つ機能である場合もあれば、
WAI-ARIA によってセマンティクスが変更された場合に処理が
不確実になる機能である場合もあります。適合性チェッカーは、強い
ネイティブセマンティクスを持つ要素上で WAI-ARIA ロールが使用された場合に、
エラーまたは警告を通知することがありますが、ユーザーエージェントは、その要素をアクセシビリティ
API に公開する際に、
WAI-ARIA ロールのセマンティクスの値を引き続き使用しなければなりません (MUST )。
プラットフォームのアクセシビリティ API には、
WAI-ARIA に存在しない機能がある場合があります。同様に、
WAI-ARIA は、公開時点でアクセシビリティ
API によってサポートされていない機能を公開します。通常、すべての
WAI-ARIA 属性 と
プラットフォームのアクセシビリティ API の間には、一対一の関係はありません。
WAI-ARIA のロール 、状態 、およびプロパティ がアクセシビリティ
API に直接マップされず、
その API に
WAI-ARIA のロール、状態、プロパティ、および
それらの値を公開するためのメカニズムがある場合、ユーザーエージェント は
そのメカニズムを使用して、次のように
WAI-ARIA データを公開しなければなりません (MUST ):
IAccessible2 および ATK /AT-SPI では、オブジェクト属性を使用して、
API で直接サポートされていないセマンティクス を公開します。オブジェクト属性は
名前-値ペアであり、緩やかに指定されていて、アクセシビリティ API に
特定のインターフェイスが存在しないものを公開するために非常に柔軟です。例えば、
現時点では、aria-live
属性は、アクセシビリティ
API にそのような利用可能なプロパティがないため、
オブジェクト属性を介して公開できます。オブジェクト属性の名前-値ペアを公開するための具体的な規則は
この文書全体で説明され、一般的な場合の規則は状態および
プロパティのマッピング にあります。
Microsoft UIA では、AriaRole および
AriaProperties プロパティを使用して、コントロールタイプで直接
サポートされていないセマンティクスを公開します。
注記
MSAA は、
API に直接マップされない属性を公開するための
メカニズムを提供しておらず、実装者の間でも、それをどのように行うかについて合意はありません。
ユーザーエージェントは、このメカニズムを通じてロール文字列全体も公開しなければならず (MUST )、
アクセシビリティ API への直接マッピングがある場合であっても、
このメカニズムを通じて WAI-ARIA 属性および値を公開してもよいです (MAY )。
ブラウザー実装者には、関連する情報を公開するための自らの API
メソッドを公に文書化することが推奨されます。これにより、
支援技術 開発者が、
ユーザー機能をサポートするためにその API を使用できるようになります。
プラットフォームのアクセシビリティ API は、従来、そのプラットフォーム上の
支援技術 が想定する、事前定義された有限個の
ロール の集合を持っており、
公開できるロールは 1 つまたは 2 つだけである場合があります。これに対して、
WAI-ARIA では、複数のロールを、
空白で区切られた有効なロールトークンの順序付き集合として指定できます。追加のロールは、
第一候補のフォントタイプがサポートされていない場合に備えて複数のフォントを指定する概念と同様の、
フォールバックロールです。
ユーザーエージェントは、API がそのためのメカニズムをサポートする場合、
WAI-ARIA ロール文字列を公開しなければなりません
(MUST )。これにより、支援技術はロールに対して独自の追加処理を行うことができます。
MSAA :
サポートされていません 。ユーザーエージェントは、
MSAA の accRole プロパティに
カスタムロールを公開すべきではありません (SHOULD
NOT )。
IAccessible2: オブジェクト属性ペア (xml-roles:"string") として公開します
UIA : AriaRole プロパティとして公開します。
AriaRole property は、空白を区切り文字として使用することで、二次的なロールもサポートできます。
ATK /AT-SPI : オブジェクト属性ペア
(xml-roles:"string") として公開します
要素の computedrole は、ブラウザーエンジンによって算出された要素のロールを表す文字列です。
computedrole は、主に開発者ツール、仕様適合性、および相互運用性テストの目的で使用されます。
注記
要素がロールを持っているものの、必要な文脈内に含まれていない場合
(例えば、必要なロール list のアクセシブルな親を持たない、
孤立した listitem)、これはオーサリングエラーですが、ユーザーエージェントの動作は
単一の規則として指定されていません。ほとんどのロールについて、ユーザーエージェントは、
ロールを無視してエラーから回復することも、実装が無害であると判断したシナリオにおいて
著者が意図したロールを尊重することもできます。エンジンが著者のロールエラーをどのように扱うかに関する
この寛容さは、[HTML-AAM ] のような言語固有のマッピング文書によって
上書きされる場合があることに注意してください。
ホスト言語要素が、有効で非抽象のロールに対する正確な、または同等のマッピングを持たない場合、
関連する Accessibility API Mapping
拡張仕様は、相互運用性テスト目的の戻り値として、一意の
computedrole 文字列を指定してもよいです (MAY )。例えば、
[HTML-AAM ] における
<video> -> "html-video" などです。
しかし、著者は、トークンが有効で定義済みのロール (例えば
dpub-chapter) にも一致する場合を除き、
role 属性でホスト言語接頭辞付きの computedrole 文字列
(例えば html-video) を使用してはなりません (MUST NOT )。
ユーザーエージェントは、抽象ロールまたは無効なロールトークンを無視しなければなりません
(MUST )。
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
未定
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
未定
ARIA 仕様
application
算出ロール
application
MSAA + IAccessible2
ロール: ROLE_SYSTEM_APPLICATION
UIA
コントロールタイプ: Pane
ローカライズされたコントロールタイプ: application
ATK /AT-SPI
ロール: ROLE_EMBEDDED
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXWebApplication
Android
未定
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
未定
ARIA 仕様
banner
算出ロール
banner
MSAA + IAccessible2
ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:banner
UIA
コントロールタイプ: Group
ローカライズされたコントロールタイプ: banner
ランドマークタイプ: Custom
ローカライズされたランドマークタイプ: banner
ATK /AT-SPI
ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:banner
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXLandmarkBanner
Android
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
dialog
算出ロール
dialog
MSAA + IAccessible2
ロール: ROLE_SYSTEM_DIALOG
UIA
コントロールタイプ: Pane
ATK /AT-SPI
ロール: ROLE_DIALOG
インターフェイス: Window
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXApplicationDialog
Android
未定
ARIA 仕様
directory
算出ロール
list
MSAA + IAccessible2
ロール: ROLE_SYSTEM_LIST
UIA
コントロールタイプ: List
ATK /AT-SPI
ロール: ROLE_LIST
AX API [注記 1 ]
AXRole: AXList
AXSubrole: AXContentList
Android
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
group
算出ロール
group
MSAA + IAccessible2
ロール: ROLE_SYSTEM_GROUPING
UIA
コントロールタイプ: Group
ATK /AT-SPI
ロール: ROLE_PANEL
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXApplicationGroup
Android
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
link
算出ロール
link
MSAA + IAccessible2
ロール: ROLE_SYSTEM_LINK
状態: STATE_SYSTEM_LINKED
状態: STATE_SYSTEM_LINKED をその子孫上に設定
インターフェイス: IAccessibleHypertext
UIA
コントロールタイプ: HyperLink
コントロールパターン: Value
ATK /AT-SPI
ロール: ROLE_LINK
インターフェイス: HyperlinkImpl
AX API [注記 1 ]
AXRole: AXLink
AXSubrole: <nil>
Android
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
math
算出ロール
math
MSAA + IAccessible2
ロール: ROLE_SYSTEM_EQUATION
UIA
コントロールタイプ: Group
ローカライズされたコントロールタイプ: math
ATK /AT-SPI
ロール: ROLE_MATH
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXDocumentMath
Android
未定
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
未定
ARIA 仕様
navigation
算出ロール
navigation
MSAA + IAccessible2
ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:navigation
UIA
コントロールタイプ: Group
ローカライズされたコントロールタイプ: navigation
ランドマークタイプ: Navigation
ATK /AT-SPI
ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:navigation
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXLandmarkNavigation
Android
未定
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
未定
ARIA 仕様
note
算出ロール
note
MSAA + IAccessible2
ロール: IA2_ROLE_NOTE
UIA
コントロールタイプ: Group
ローカライズされたコントロールタイプ: note
ATK /AT-SPI
ロール: ROLE_COMMENT
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXDocumentNote
Android
未定
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
未定
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
未定
ARIA 仕様
progressbar
算出ロール
progressbar
MSAA + IAccessible2
ロール: ROLE_SYSTEM_PROGRESSBAR
状態: STATE_SYSTEM_READONLY
インターフェイス: IAccessibleValue
UIA
コントロールタイプ: ProgressBar
aria-valuenow、aria-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
未定
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
未定
ARIA 仕様
radiogroup
算出ロール
radiogroup
MSAA + IAccessible2
ロール: ROLE_SYSTEM_GROUPING
UIA
コントロールタイプ: List
ATK /AT-SPI
ロール: ROLE_PANEL
AX API [注記 1 ]
AXRole: AXRadioGroup
AXSubrole: <nil>
Android
未定
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
未定
ARIA 仕様
region
without an accessible name
算出ロール
ネイティブホスト言語ロールを使用します。
MSAA + IAccessible2
要素 を
ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
UIA
要素 を
ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
ATK /AT-SPI
要素 を
ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
AX API [注記 1 ]
要素 を
ランドマークとして公開しません。代わりに、その要素のネイティブホスト言語ロールを使用します。
Android
未定
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
未定
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
未定
ARIA 仕様
rowgroup
算出ロール
rowgroup
MSAA + IAccessible2
ロール: ROLE_SYSTEM_GROUPING
UIA
コントロールタイプ: Group
ATK /AT-SPI
ロール: ROLE_PANEL
AX API [注記 1 ]
マップされない
Android
未定
ARIA 仕様
search
算出ロール
search
MSAA + IAccessible2
ロール: IA2_ROLE_LANDMARK
オブジェクト属性: xml-roles:search
UIA
コントロールタイプ: Group
ローカライズされたコントロールタイプ: search
ランドマークタイプ: Search
ATK /AT-SPI
ロール: ROLE_LANDMARK
オブジェクト属性: xml-roles:search
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXLandmarkSearch
Android
未定
ARIA 仕様
searchbox
算出ロール
searchbox
MSAA + IAccessible2
ロール: ROLE_SYSTEM_TEXT
オブジェクト属性: text-input-type:search
UIA
コントロールタイプ: Edit
ローカライズされたコントロールタイプ: search box
ATK /AT-SPI
ロール: ROLE_ENTRY
オブジェクト属性: xml-roles:searchbox
オブジェクト属性: text-input-type:search
aria-readonly が
"true" でない場合、インターフェイス:
EditableText
AX API [注記 1 ]
AXRole: AXTextField
AXSubrole: AXSearchField
Android
未定
ARIA 仕様
separator
(フォーカス不可)
算出ロール
seperator
MSAA + IAccessible2
ロール: ROLE_SYSTEM_SEPARATOR
UIA
コントロールタイプ: Separator
ATK /AT-SPI
ロール: ROLE_SEPARATOR
AX API [注記 1 ]
AXRole: AXSplitter
AXSubrole: <nil>
Android
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
timer
算出ロール
timer
MSAA + IAccessible2
オブジェクト属性: xml-roles:timer
UIA
コントロールタイプ: Group
ローカライズされたコントロールタイプ: timer
ATK /AT-SPI
ロール: ROLE_TIMER
AX API [注記 1 ]
AXRole: AXGroup
AXSubrole: AXApplicationTimer
Android
未定
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
未定
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
未定
注記
[注記 1]
ユーザーエージェントは、ユーザーに提示可能なローカライズ済み文字列値を
AXRoleDescription に対して返すべきです。
注記
[注記 2] この仕様には現在、ユーザー
エージェントがいつ system alert イベントを発火すべきかについてのガイダンスは含まれていません。
後日、この仕様に何らかのガイダンスが追加される可能性がありますが、それは推奨
(SHOULD ) であり、要件
(MUST ) ではありません。
このセクションでは、WAI-ARIA の
状態 およびプロパティ を公開する方法を説明します。
ユーザーエージェント は、管理対象状態
VISIBLE/INVISIBLE、SHOWING/OFFSCREEN などを
算出しなければなりません (MUST )。これは通常、WAI-ARIA 属性が存在しない通常の
要素 の場合と同じ方法で行われます。
FOCUSABLE/FOCUSED 状態は、aria-activedescendant の影響を受ける場合があります。
ユーザーエージェントは、ホスト言語によって明示的な
WAI-ARIA 上書きが許可されている場合を除き、
WAI-ARIA の状態およびプロパティのセマンティクスに加えて、
ネイティブセマンティクスを引き続き公開しなければなりません (MUST )。
例えば、HTML の
checkbox は
aria-labelledby
属性を持つ場合がありますが、
ネイティブの HTML セマンティクスは引き続き
公開されなければなりません。
ユーザーエージェントは、ロール マッピング表で定義されるとおりに、特定のロールマッピング表 について追加の状態を公開しなければなりません (MUST )。
ユーザーエージェントは、関連する WAI-ARIA 属性 について状態を算出し、
アクセシビリティ API に、状態およびプロパティのマッピング表 で指定されるとおりにマップしなければなりません (MUST )。関連する
WAI-ARIA 属性を決定するには、
ロールの定義
[WAI-ARIA-1.2 ]]
を参照してください。著者が必須属性に値を提供していない場合、ユーザーエージェントは、
既定値が提供されたものとして処理するべきです (SHOULD )。
一部の WAI-ARIA プロパティは
グローバルではなく、特定のロールでのみサポートされます。非グローバルの
WAI-ARIA 状態またはプロパティが、
サポートされていない場所で使用されている場合、ユーザーエージェントは、与えられた
WAI-ARIA プロパティをプラットフォームの
アクセシビリティ API にマップするべきではありません (SHOULD NOT )。
例えば、aria-checked="true" が <div role="grid"> に指定されている場合、それは
MSAA 実装において
STATE_SYSTEM_CHECKED として公開されるべきではありません。
明示的または継承された none または presentation のロールが
要素に適用されている場合、ユーザーエージェントは、
Accessible Rich Internet Applications (WAI-ARIA ) 1.2
[WAI-ARIA-1.2 ]]
で定義される none または presentation のロール の規則を
実装しなければなりません (MUST )。
表の中には、与えられた状態またはプロパティが「マップされない」と宣言されている箇所がいくつかあります。
場合によっては、これは状態/プロパティの既定値について発生し、その不在と
同等です。ユーザーエージェントは、それが既定値かどうかを確認するよりも、値をマップする方が速いと
判断する場合があります。計算効率のために、ユーザーエージェントは、それを行うことがマップしないことと
同等である場合、その状態または
プロパティ値を公開してもよいです (MAY )。これらの場合は
アスタリスクで示されます。
その他の場合には、その状態/プロパティをマップしてはならないことが必須です。なぜなら、それを公開すると
関連するアフォーダンスが示唆されるためです。例として
aria-grabbed
があります。その不在は、アクセシブルオブジェクトがつかまれていないことを示すだけでなく、さらにそれが
つかめないものとして定義されることも意味します。これらの場合は、アスタリスクなしで「マップされない」と示されます。
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
未定
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
未定
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
未定
ARIA 仕様
aria-braillelabel
MSAA + IAccessible2
オブジェクト属性:
braillelabel:<value>
UIA
プロパティ: AriaProperties.braillelabel:
<value>
ATK /AT-SPI
オブジェクト属性:
braillelabel:<value>
AX API
プロパティ: AXBrailleLabel
Android
未定
ARIA 仕様
aria-brailleroledescription
MSAA + IAccessible2
オブジェクト属性:
brailleroledescription:<value>
UIA
プロパティ: AriaProperties.brailleroledescription:
<value>
ATK /AT-SPI
オブジェクト属性:
brailleroledescription:<value>
AX API
プロパティ: AXBrailleRoleDescription
Android
未定
ARIA 仕様
aria-busy =true
MSAA + IAccessible2
状態: STATE_SYSTEM_BUSY
UIA
プロパティ: AriaProperties.busy:
true
ATK /AT-SPI
状態: STATE_BUSY
AX API
プロパティ: AXElementBusy: YES
Android
未定
ARIA 仕様
aria-busy =false
MSAA + IAccessible2
状態: STATE_SYSTEM_BUSY は公開されない
UIA
プロパティ: AriaProperties.busy:
false
ATK /AT-SPI
状態: STATE_BUSY は公開されない
AX API
プロパティ: AXElementBusy: NO
Android
未定
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
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-colindextext
MSAA + IAccessible2
オブジェクト属性:
colindextext:<value>
UIA
プロパティ: AriaProperties.colindextext:
<value>
ATK /AT-SPI
オブジェクト属性:
colindextext:<value>
AX API
プロパティ: AXColumnIndexDescription:
<value>
Android
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-current
に認識されない値を持つ場合
MSAA + IAccessible2
オブジェクト属性: current:true
UIA
プロパティ: AriaProperties.current:
true
ATK /AT-SPI
オブジェクト属性: current:true
状態: STATE_ACTIVE
AX API
プロパティ: AXARIACurrent:
true
Android
未定
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
未定
ARIA 仕様
aria-description
MSAA + IAccessible2
プロパティ: accDescription:
<value>
関連項目: 名前の
算出
UIA
プロパティ: FullDescription:
<value>
関連項目: 名前の
算出
ATK /AT-SPI
プロパティ: Description:
<value>
関連項目: 名前の
算出
AX API
accessibilityCustomContent API では、
{ label: "description" } を持つ
AXCustomContent オブジェクトとして公開し、
`value` には説明文字列を設定します。
関連項目: 名前の
算出
Android
未定
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
未定
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
未定
ARIA 仕様
aria-disabled =false
MSAA + IAccessible2
状態: STATE_SYSTEM_UNAVAILABLE は
公開されない
UIA
プロパティ: IsEnabled: true
ATK /AT-SPI
状態: STATE_ENABLED
AX API
プロパティ: AXEnabled: YES
Android
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-grabbed =true
MSAA + IAccessible2
オブジェクト属性: grabbed:true
UIA
プロパティ: AriaProperties.grabbed:
true
ATK /AT-SPI
オブジェクト属性: grabbed:true
AX API
プロパティ: AXGrabbed: YES
Android
未定
ARIA 仕様
aria-grabbed =false
MSAA + IAccessible2
オブジェクト属性: grabbed:false
UIA
プロパティ: AriaProperties.grabbed:
false
ATK /AT-SPI
オブジェクト属性: grabbed:false
AX API
プロパティ: AXGrabbed: NO
Android
未定
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
未定
ARIA 仕様
aria-invalid =false
MSAA + IAccessible2
状態: IA2_STATE_INVALID_ENTRY は
公開されない
UIA
プロパティ: IsDataValidForForm:
true
ATK /AT-SPI
状態: STATE_INVALID_ENTRY は公開されない
AX API
プロパティ: AXInvalid: false
Android
未定
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
未定
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
未定
ARIA 仕様
aria-keyshortcuts
MSAA + IAccessible2
プロパティ: accKeyboardShortcut:
<value>
UIA
プロパティ: AcceleratorKey:
<value>
ATK /AT-SPI
オブジェクト属性:
keyshortcuts:<value>
AX API
プロパティ: AXKeyShortcutsValue:
<value>
Android
未定
ARIA 仕様
aria-label
MSAA + IAccessible2
プロパティ: accName:
<value>
関連項目: 名前の
算出
UIA
プロパティ: Name:
<value>
関連項目: 名前の
算出
ATK /AT-SPI
プロパティ: Name:
<value>
関連項目: 名前の
算出
AX API
プロパティ: AXTitle:
<value>
関連項目: 名前の
算出
Android
未定
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
未定
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
未定
ARIA 仕様
aria-level
が heading 上にある場合
MSAA + IAccessible2
オブジェクト属性: level:<value>
UIA
プロパティ: AriaProperties.level:
<value>
プロパティ: StyleId_Heading:
<value>
ATK /AT-SPI
オブジェクト属性: level:<value>
AX API
プロパティ: AXValue:
<value>
Android
未定
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
未定
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
未定
ARIA 仕様
aria-modal =true
MSAA + IAccessible2
状態: IA2_STATE_MODAL
UIA
プロパティ: Window.IsModal:
true
ATK /AT-SPI
状態: STATE_MODAL
AX API
背景コンテンツがもはや公開されないように、アクセシビリティツリーを刈り込みます。
aria-modal="true" を持つ
要素 に対応する
アクセシブル
オブジェクト 上には、特定のプロパティは設定されません。
そのモーダルアクセシブルオブジェクトをルートとするツリーのみが公開されます。
Android
未定
ARIA 仕様
aria-modal =false
MSAA + IAccessible2
状態: IA2_STATE_MODAL は公開されない
UIA
プロパティ: Window.IsModal:
false
ATK /AT-SPI
状態: STATE_MODAL は公開されない
AX API
背景コンテンツが公開されるように、アクセシビリティツリーを拡張します。
aria-modal="false" を持つ
要素 に対応する
アクセシブル
オブジェクト 上には、特定のプロパティは設定されません。
Android
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-multiselectable =false
MSAA + IAccessible2
状態: STATE_SYSTEM_MULTISELECTABLE は
公開されない
状態: STATE_SYSTEM_EXTSELECTABLE は
公開されない
関連項目: アクセシビリティイベントの詳細については
選択
UIA
マップされない*
ATK /AT-SPI
状態: STATE_MULTISELECTABLE は公開されない
AX API
マップされない*
Android
未定
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
未定
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
未定
ARIA 仕様
aria-orientation
が未定義
MSAA + IAccessible2
マップされない*
UIA
マップされない*
ATK /AT-SPI
状態: STATE_VERTICAL は公開されない
状態: STATE_HORIZONTAL は公開されない
AX API
プロパティ: AXOrientation:
AXUnknownOrientation
Android
未定
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
未定
ARIA 仕様
aria-placeholder
MSAA + IAccessible2
オブジェクト属性:
placeholder-text:<value>
UIA
プロパティ: HelpText:
<value>
ATK /AT-SPI
オブジェクト属性:
placeholder-text:<value>
AX API
プロパティ: AXPlaceholderValue:
<value>
Android
未定
ARIA 仕様
aria-posinset
MSAA + IAccessible2
オブジェクト属性:
posinset:<value>
関連項目: グループ
位置
UIA
プロパティ: AriaProperties.posinset:
<value>
関連項目: グループ
位置
ATK /AT-SPI
オブジェクト属性:
posinset:<value>
関連項目: グループ
位置
AX API
プロパティ: AXARIAPosInSet:
<value>
関連項目: グループ
位置
Android
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-required =true
MSAA + IAccessible2
状態: IA2_STATE_REQUIRED
UIA
プロパティ: IsRequiredForForm:
true
ATK /AT-SPI
状態: STATE_REQUIRED
AX API
プロパティ: AXRequired: YES
Android
未定
ARIA 仕様
aria-roledescription
MSAA + IAccessible2
メソッド: localizedExtendedRole():
<value>
UIA
ローカライズされたコントロールタイプ: <value>
ATK /AT-SPI
オブジェクト属性:
roledescription:<value>
AX API
プロパティ: AXRoleDescription:
<value>
Android
未定
ARIA 仕様
aria-roledescription が未定義
または空文字列
MSAA + IAccessible2
マップされない
UIA
ローカライズされたコントロールタイプは、その要素のロールに対して指定されたものとして
定義されます。role 属性が提供されている場合は明示的なロールに基づき、
それ以外の場合はホスト言語の暗黙の
ロールに基づきます。
ATK /AT-SPI
マップされない
AX API
AXRoleDescription は、その要素のロールに対して指定されたものとして
定義されます。role 属性が提供されている場合は明示的なロールに基づき、
それ以外の場合はホスト言語の暗黙のロールに
基づきます。
Android
未定
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
未定
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
未定
ARIA 仕様
aria-rowindextext
MSAA + IAccessible2
オブジェクト属性:
rowindextext:<value>
UIA
プロパティ: AriaProperties.rowindextext:
<value>
ATK /AT-SPI
オブジェクト属性:
rowindextext:<value>
AX API
プロパティ: AXRowIndexDescription:
<value>
Android
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-sort =none
MSAA + IAccessible2
オブジェクト属性: sort:none。値が未指定でない場合
UIA
マップされない*
ATK /AT-SPI
オブジェクト属性: sort:none。値が未指定でない場合
AX API
マップされない*
Android
未定
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 が要素上に存在する、
またはユーザーエージェントによって算出される場合です。これが発生した場合:
ロールマッピング で定義されるアクセシブルオブジェクトへのロールの
マッピングの一環として、ユーザーエージェントは、そのオブジェクト上に既定のアクションを公開します。
MSAA : AT がアクセシブルオブジェクト上で
DoDefaultAction を呼び出す場合、ユーザーエージェントは、そのアクセシブルオブジェクトに
マップされる
DOM 要素上のクリックをシミュレートするべきです
(SHOULD )。
IAccessible2: AT がアクセシブルオブジェクト上で
IAccessibleAction を呼び出す場合、ユーザーエージェントは、そのアクセシブルオブジェクトに
マップされる
DOM 要素上のクリックをシミュレートするべきです
(SHOULD )。
UIA Automation: AT がアクセシブルオブジェクト上で任意の UIA パターンメソッドを呼び出す場合、ユーザー
エージェントは、そのアクセシブルオブジェクトにマップされる DOM 要素上のクリックをシミュレートするべきです
(SHOULD )。
ATK /AT-SPI : AT がアクセシブルオブジェクト上で
アクションを呼び出す場合、ユーザーエージェントは、そのアクセシブルオブジェクトにマップされる
DOM 要素上のクリックをシミュレートするべきです
(SHOULD )。
AX API : AT がアクセシブルオブジェクト上で AXPress
アクションをトリガーする場合、ユーザーエージェントは、そのアクセシブルオブジェクトにマップされる
DOM 要素上のクリックをシミュレートするべきです
(SHOULD )。
注記
著者は、DOM 内の WAI-ARIA 状態およびプロパティを
それに応じて更新する、それらのクリックイベント用のハンドラーを作成する必要があります。
これにより、それらの更新済み状態をユーザーエージェントが Accessibility
API に反映できるようになります。
ユーザーエージェント は、ユーザー操作、WAI-ARIA 状態 の変更、
文書コンテンツまたはノード可視性の変更、選択の変更、およびメニューの操作について、
以下のセクションで定義されるようにイベント を発火します。
ユーザーエージェント は、
下の表で定義されるように、状態 変更を支援技術 に通知しなければならず
(MUST )、アクセシビリティ API がそのプロパティについて変更イベント を定義している場合、プロパティ 変更を
支援技術に通知するべきであり (SHOULD )、
アクセシビリティ API がそのプロパティについて
変更イベントを定義していない場合、プロパティ変更を支援技術に通知するべきではありません
(SHOULD NOT )。例えば、IAccessible2 は、
aria-activedescendant
が変更された場合に
使用されるイベントを定義しています。
変更されることが期待される WAI-ARIA
プロパティには、
aria-activedescendant ,
aria-valuenow , および aria-valuetext が含まれます。
注記
一部の API では、AT は、自身が購読しているイベントについてのみ
通知を受けます。
単純さおよび性能のために、ユーザーエージェントは、現在フォーカスを持たないウィンドウ内で
発生しているイベントなど、支援技術 が通常無視する
状態またはプロパティ変更の変更イベントを取り除いてもよいです (MAY )。
注記
翻訳者向け: 次の表およびそのトグルボタンに関連付けられたラベルテキストについては、この文書の
<head> セクション内の mappingTableLabels オブジェクトを
参照してください。
ARIA 仕様
aria-activedescendant
MSAA + IAccessible2 イベント
フォーカスの変更 を参照。
さらに:
IA2_EVENT_ACTIVE_DESCENDANT_CHANGED
UIA イベント
フォーカスの変更 を参照。
さらに:
PropertyChangedEvent
プロパティ: AriaProperties
ATK /AT-SPI イベント
フォーカスの変更 を参照。
AX API 通知
フォーカスの変更 を参照。
さらに: AXSelectedChildrenChanged
Android
未定
ARIA 仕様
aria-busy
(状態)
MSAA + IAccessible2 イベント
EVENT_OBJECT_STATECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties
ATK /AT-SPI イベント
object:state-changed:busy
AX API 通知
AXElementBusyChanged
Android
未定
ARIA 仕様
aria-checked
(状態)
MSAA + IAccessible2 イベント
EVENT_OBJECT_STATECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties、toggle パターンの一部としての
ToggleState
ATK /AT-SPI イベント
object:state-changed:checked
AX API 通知
AXValueChanged
Android
未定
ARIA 仕様
aria-current
(状態)
MSAA + IAccessible2 イベント
IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties
ATK /AT-SPI イベント
object:state-changed:active
AX API 通知
AXCurrentStateChanged
Android
未定
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
未定
ARIA 仕様
aria-describedby
MSAA + IAccessible2 イベント
EVENT_OBJECT_DESCRIPTIONCHANGE
UIA イベント
PropertyChangedEvent
プロパティ: DescribedBy
ATK /AT-SPI イベント
object:property-change:accessible-description
AX API 通知
AXDescribedByChanged
Android
未定
ARIA 仕様
aria-dropeffect
(プロパティ、非推奨)
MSAA + IAccessible2 イベント
IA2_EVENT_OBJECT_ATTRIBUTE_CHANGED
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties
ATK /AT-SPI イベント
object:property-change
AX API 通知
AXDropEffectChanged
Android
未定
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
未定
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
未定
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
未定
ARIA 仕様
aria-invalid
(状態)
MSAA + IAccessible2 イベント
EVENT_OBJECT_STATECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties, IsDataValidForForm
ATK /AT-SPI イベント
object:state-changed:invalid_entry
AX API 通知
AXInvalidStatusChanged
Android
未定
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
未定
ARIA 仕様
aria-pressed
(状態)
MSAA + IAccessible2 イベント
EVENT_OBJECT_STATECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties, toggle パターンの一部としての
ToggleState
ATK /AT-SPI イベント
object:state-changed:pressed
AX API 通知
AXPressedStateChanged
Android
未定
ARIA 仕様
aria-readonly
MSAA + IAccessible2 イベント
EVENT_OBJECT_STATECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties
ATK /AT-SPI イベント
object:state-changed:readonly
AX API 通知
AXReadOnlyStatusChanged
Android
未定
ARIA 仕様
aria-required
MSAA + IAccessible2 イベント
EVENT_OBJECT_STATECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties, IsRequiredForForm
ATK /AT-SPI イベント
object:state-changed:required
AX API 通知
AXRequiredStatusChanged
Android
未定
ARIA 仕様
aria-selected
(状態)
MSAA + IAccessible2 イベント
詳細については 選択 セクションを参照。
UIA イベント
詳細については 選択 セクションを参照。
ATK /AT-SPI イベント
詳細については 選択 セクションを参照。
AX API 通知
詳細については 選択 セクションを参照。
Android
未定
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
未定
ARIA 仕様
aria-valuetext
MSAA + IAccessible2 イベント
EVENT_OBJECT_VALUECHANGE
UIA イベント
PropertyChangedEvent
プロパティ: AriaProperties
ATK /AT-SPI イベント
object:property-change:accessible-value
AX API 通知
AXValueChanged
Android
未定
文書変更の処理は、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" の暗黙値があります。
メニューイベントを発火する必要がある場合があります。メニュー用の特別な
イベント を参照してください。
次の表は、アクセシビリティ 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
選択には 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"
がある場合に発生します。いくつかの重要な側面があります:
Microsoft UIA では、Selection および
SelectionItem コントロールパターンが、選択の可用性、状態、および
メソッドを公開します。
子孫上で 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 を発火するべきですが、冗長性を避けるため、
個別の選択イベントは発生しない場合があります。
現在のコンテナー上で object:selection-changed、
選択が変更された任意の子孫アクセシブル
オブジェクト 上で
object:state-changed:selected:
AXSelectedChildrenChanged
多数の項目を一度に選択または選択解除する
ユーザーエージェントは
EVENT_OBJECT_SELECTIONWITHIN を発火してもよいです (MAY )。
このイベントが発火される場合、上記の他のイベントは性能のために取り除かれてもよいです
(MAY )。
選択または選択解除された各要素について、現在のコンテナー上で SelectionItem
コントロールパターン: UIA_SelectionItem_ElementAddedToSelectionEventId または
UIA_SelectionItem_ElementRemovedFromSelectionEventId を発火します。
ユーザーエージェントは、Selection コントロールパターン Invalidated イベントを
発火することを選択してもよく (MAY )、これはコンテナー内の選択が
大幅に変更され、InvalidateLimit 定数が許可するよりも多くの追加および削除イベントを
送信する必要があることを示します。
ユーザーエージェントは性能のために、複数のイベントではなく、コンテナー上で単一の
object:selection-changed イベントを発火してもよいです
(MAY )。
選択が変更された任意の子孫アクセシブル
オブジェクト 上で object:state-changed:selected:
AXSelectedChildrenChanged
一部の API は、特定の
アルゴリズムに従う必要があるメソッドを提供します。以下のセクションでは、
これらのメソッドについてのアルゴリズムマッピング表を提供します。
ARIANotifyMixin は、支援技術へコンテンツを通知するためのメソッドを提供します。
以下のアルゴリズムマッピングは、支援技術のユーザーに一貫した動作を保証するために、
これらの通知が異なるアクセシビリティ API 間で
どのように実装されるかを指定します。
node , announcement , および priority が与えられたときに
aria notify するには:
ARIA 仕様
aria notify
事前条件
node がアクセシビリティツリーから
除外されている 場合、これらの手順を中止します。
言語
ユーザーエージェントおよび支援技術は、次のソースから最初の有効な BCP 47
言語タグを取得することにより、通知の言語を決定しなければなりません
(MUST ):
node の最も近い祖先要素の lang 属性
(node
自身を含む)。
文書要素の lang 属性 (文書上で呼び出された場合を含む)。
ユーザーエージェントまたはプラットフォームの既定値。
支援技術は、その言語を使用して通知を提示しなければなりません
(MUST ) (例えば、音声、発音規則、点字表)。
MSAA + IAccessible2
実装は指定されていません (フォールバック注記を参照 )。
UIA
priority が "high" である場合は
NotificationProcessing_ImportantAll、それ以外の場合は
NotificationProcessing_All を
mapped_priority とします。
node ,
NotificationKind_ActionCompleted, mapped_priority ,
announcement , および空
文字列を指定して UiaRaiseNotificationEvent を呼び出します。
注記
プラットフォームのアクセシビリティ実装が、node が
UIA
Control
view または
Content
view に表されていないと判断した場合、ユーザーエージェントは代わりに、
UIA Control として表されている
最も近い祖先上で通知イベントを発生させるべきです
(SHOULD )。そのような祖先が存在しない場合、
ユーザーエージェントは、Control view または Content view のいずれかにあることが
期待される文書ルート上で通知イベントを発生させるべきです
(SHOULD )。これにより、Control view または Content view にない
要素上のイベントを無視する支援技術が通知を受け取れることを保証します。
ATK
priority が "high" である場合は Atk.Live.ATK_LIVE_ASSERTIVE、
それ以外の場合は
Atk.Live.ATK_LIVE_POLITE を mapped_priority とします。
node ,
"notification", announcement , および
mapped_priority を指定して
g_signal_emit_by_name を呼び出します。
ATK 2.50.0 より前の古い Linux
アクセシビリティスタックでは、ユーザーエージェントはフォールバックを使用してもよいです
(MAY ); フォールバック注記を参照 。
AT-SPI
priority が "high" である場合は ATSPI_LIVE_ASSERTIVE、
それ以外の場合は ATSPI_LIVE_POLITE を
mapped_priority とします。
node , "announcement",
announcement , および
mapped_priority を指定して、DBUS シグナル
ATSPI_DBUS_INTERFACE_EVENT_OBJECT を送信します。
AX API
priority が "high" である場合は NSAccessibilityPriorityHigh、
それ以外の場合は
NSAccessibilityPriorityMedium を mapped_priority
とします。
次のキーを持つ NSDictionary を userInfo とします:
NSAccessibilityAnnouncementKey を announcement
として
NSAccessibilityPriorityKey を mapped_priority
として
node ,
NSAccessibilityAnnouncementRequestedNotification , および
userInfo を指定して
NSAccessibilityPostNotificationWithUserInfo を呼び出します。
注記
適切なプラットフォーム通知 API が利用できない場合 (例えば、新しい
notification シグナルを欠く ATK 2.50.0 より前の
古い Linux アクセシビリティスタック、または Windows 上でユーザーエージェントが
UIA を使用できない場合)、ユーザーエージェントは
aria notify 通知を伝えるために、アクセシビリティツリー内に一時的な支援技術専用の
ライブ領域を合成してもよいです (MAY )。そのような
フォールバックノードは Web コンテンツへ公開されず、Web コンテンツから検出することもできず、
この動作は必須ではありません。
Web Platform
Design Principles に従い、この仕様は、情報が支援技術によって使用されているかどうかを
判定するプログラム的インターフェイスを提供しません。しかし、この仕様は、支援技術を使用しない
ユーザーに利用可能な情報とは異なる情報を、支援技術のユーザーへ著者が提示することを許可します。
これは、Web 技術スタックの多くの他の部分を使用して可能であるのと同様に、ARIA および CORE-AAM
仕様の多くの機能を使用して可能です。このコンテンツの不一致は、支援技術のユーザーに対する
能動的フィンガープリンティング を
実行するために悪用される可能性があります。
この仕様は、新たなセキュリティに関する考慮事項を導入しません。
14-Nov-2022: colindextext/rowindextext について新しい AX
API マッピングを追加
4-Jan-2024: 修正: treegrid row の誤った算出ロール
31-Oct-2023: UIA aria-readonly マッピングを更新
31-Oct-2023: aria-haspopup='grid' マッピングを追加
31-Oct-2023: AXAPI 通知を修正
26-Oct-2023: aria-describedby UIA マッピングから
UIA_DescribedBy プロパティを削除
12-Oct-2023: haspopup='true' マッピングを haspopup='menu' と同一にする
1-Sep-2023: AX API aria-haspopup マッピングを修正
25-Aug-2023: role=image (img の同義語) のマップを追加
17-Aug-2023: computedrole について規範的な期待事項および例を追加
16-Aug-2023: aria-errormessage のマッピングを更新
15-May-2023: 算出ロールセクションおよびマッピングを追加
8-May-2023: UIA ins/del を更新
13-Apr-2023: aria-braillelabel および aria-brailleroledescription のマッピングを追加
9-Apr-2023: annotation roles AXAPI マッピングを更新
6-Apr-2023: aria-describedby および aria-description AXAPI を更新
6-Apr-2023: role='meter' subrole for AXAPI を更新
1-Feb-2023: AXAPI 固有の「group 内の menuitem」ガイダンスを削除
1-Feb-2023: aria-keyshortcuts の AXAPI マッピングを更新
1-Feb-2023: IA2 role='blockquote' map を更新
1-Feb-2023: paragraph
および time および caption について MSAA マッピングを更新
1-Nov-2022: privacy および security をドラフト
13-Oct-2022: 修正: label および legend を削除
12-Oct-2022: label および legend のマッピングを削除。
05-Apr-2021: aria-colindex, aria-colspan, aria-colcount,
aria-rowindex, aria-rowspan, および
aria-rowcount について ATK マッピングを更新。
06-Apr-2020: alert
および alertdialog について ATK マッピングを更新。
25-Feb-2020: comment, mark, および suggestion
ロールのマッピングを追加。aria-label および group
position の算出に comment を含める。
25-Feb-2020: aria-description のマッピングを追加。
03-Nov-2019: AX API について明示的な AXRoleDescription
値を削除。
ユーザーエージェントは注記で説明されるガイダンスに従うべきです。
22-Oct-2019: AX API について strong および
emphasis ロールのマッピングを追加。
22-Oct-2019: AX API について code
ロールのマッピングを追加。
21-Oct-2019: ATK , IA2, および UIA について aria-colindextext および
aria-rowindextext
ロールのマッピングを追加。
21-Oct-2019: ATK , IA2, および UIA について strong および
emphasis ロールのマッピングを追加。
21-Oct-2019: ATK , IA2, および UIA について code ロールのマッピングを追加。
18-Sep-2019: subscript および superscript について
MSAA マッピングを更新
10-Sep-2019: generic ロールのマッピングを追加。
09-Jul-2019: insertion および deletion ロールのマッピングを追加。
14-May-2019: legend ロールのマッピングを追加。
14-May-2019: label ロールのマッピングを追加。
14-May-2019: time ロールのマッピングを追加。
25-Apr-2019: subscript および superscript ロールのマッピングを追加。
25-Feb-2019: meter ロールのマッピングを追加。
05-Feb-2019: UIA 状態およびプロパティ変更
イベントを更新。
06-Jun-2018: aria-placeholder について UIA
マッピングを
更新。
04-Jun-2018: blockquote, caption, および
paragraph ロールのマッピングを追加。
05-Mar-2018: AXAPI についてレンダリングされたラベルを公開するための AXTitle の言及を追加。
05-Mar-2018: aria-label, aria-labelledby, および
aria-describedby のイベントを追加。
↑