目次
概要
この文書の状態
1. 序論
1.1 アクセシビリティ
API
2. 適合性
2.1
非推奨
3.
HTML からアクセシビリティ API へのマッピング
3.1
WAI-ARIA セマンティクスを公開するための
一般規則
3.2
ネイティブマークアップのセマンティクスと WAI-ARIA との競合
3.3
アクセシビリティ API に
直接マップされない HTML 機能の公開
3.4 最小ロールを必要とする
HTML 機能の公開
3.5
HTML 要素ロールのマッピング
3.6 HTML 属性の
状態およびプロパティのマッピング
4. アクセシブル名および説明の計算
4.1
HTML 要素ごとのアクセシブル名の計算
4.2
アクセシブル説明の計算
5. プライバシー
に関する考慮事項
6. セキュリティ
に関する考慮事項
A. 付録
A.1 変更履歴
A.2
謝辞
B. 参考文献
B.1
規範的参考文献
B.2
参考情報としての参考文献
最小ロール
とは、要素がより具体的な暗黙のロールまたはプラットフォームロールのマッピング、たとえば非ジェネリックな
ロールを持たない場合に、その要素がマップされる同等の
WAI-ARIA ロールである。これは、そうでなければ
ロールが公開されない、一般的に使用される妥当な HTML
マークアップについて、支援技術のユーザーが可能な限り最良の体験を得られるようにするのに役立つ。
最小ロールは、次の条件がすべて真である場合に提供される:
著者がその要素に妥当な明示的 WAI-ARIA ロールを指定していない、
または 指定されたロールが none、presentation、または
generic のいずれかである;
その要素に暗黙の WAI-ARIA ロールまたはプラットフォームロールの
マッピングがない、または暗黙の generic または none の計算済みロールを持つ;
かつ、著者がその要素に最小ロールマッピングを必要とする属性を指定している。
HTML 属性の状態およびプロパティのマッピング 節では、
要素が最小ロールにマップされることを必要とする特定のグローバル属性を識別する。
これらの条件が満たされる場合、ユーザーエージェントは、指定された最小ロールについて CORE-AAM で定義される
マッピングを用いてオブジェクトを公開しなければならない。要素に、当該要素の計算済みロールとして最小ロールが
返されることを必要とする属性が複数指定されている場合は、ARIA タクソノミーにおいてより具体的な
ロールを優先する。
ユーザーエージェントは、暗黙の WAI-ARIA ロール
セマンティクスを持つ HTML
要素を、[core-aam-1.2 ] 仕様で定義される、
識別された WAI-ARIA ロールマッピングに従って、
プラットフォームの アクセシビリティ API にマップしなければならない。
"マップされない" とは、その要素を アクセシビリティ
API を介して公開する必要がないことを意味する。
これは通常、その要素がユーザーインターフェイスの一部として表示されないためである。しかし、著者はこれらの
要素の一部をレンダリングするように強制できる。たとえば、ユーザーエージェントのスタイルを上書きして、
本来 display: none に設定されるはずだった要素をレンダリングする場合である。このような場合、
ユーザーエージェントは、そのような要素を generic のロールに
マップするべきである。ただし、より具体的な最小ロール の公開を必要とする他の
HTML 機能が指定されている場合はこの限りでない。
要素が "対応する(WAI-ARIA )ロールなし" と示されている場合、
または generic ロールに
マップされる場合、ユーザーエージェントは、その要素が明示的で適合する role 属性値を持ち、
かつ [WAI-ARIA-1.2 ] が
aria-roledescription の使用を禁止していない場合を除き、
aria-roledescription
プロパティ値をアクセシビリティツリー 内に
公開してはならない。
一部の HTML 要素は、アクセシブル名 が提供されているかどうかに
応じて、暗黙の WAI-ARIA ロールを公開する。要素が自身または他の要素の
アクセシブル名 および/または
アクセシブル説明 の計算に
どのように関与するかは、この文書の
アクセシブル名および説明の計算 節で説明される。
HTML 仕様
abbr
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-abbr
MSAA + IAccessible2
ロール: ROLE_SYSTEM_TEXT;
IA2_ROLE_TEXT_FRAME
オブジェクト属性:
単一の子である場合、包含する
td 上の "abbr" 属性。
テキスト内容が値として使用される
UIA
コントロール型: Text
[ATK ]
ロール: ATK_ROLE_STATIC
オブジェクト属性:
単一の子である場合、包含する
td 上の "abbr" 属性。
テキスト内容が値として使用される
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
HTML 仕様
audio
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-audio
MSAA + IAccessible2
ロール: ROLE_SYSTEM_GROUPING
UIA
コントロール型: Group
ローカライズ済みコントロール型:
"audio"
ユーザーエージェントは、以下を
アクセシビリティ
ツリー に含め、非表示またはオフスクリーンとして印付けしてもよい:
読み込みメッセージまたはエラーメッセージ
現在表示されていない UI コントロール
[ATK ]
ロール: ATK_ROLE_AUDIO
AX
AXRole: AXGroup
AXSubrole: AXAudio
AXRoleDescription:
"audio playback"
コメント
HTML 仕様
canvas
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-canvas
MSAA + IAccessible2
ロール: ROLE_SYSTEM_GRAPHIC;
IA2_ROLE_CANVAS
UIA
コントロール型: Image
canvas 要素の子孫は個別にマップされる。
[ATK ]
ロール: ATK_ROLE_CANVAS
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: ""
コメント
HTML 仕様
cite
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-cite
MSAA + IAccessible2
アクセシブルオブジェクトなし。使用されるスタイルは、そのテキストコンテナー上の
テキスト属性にマップされる。
UIA
アクセシブルオブジェクトなし。使用されるスタイルは、親アクセシブルオブジェクト上に
実装される TextRange コントロールパターンの UIA テキスト属性によって公開される。
[ATK ]
アクセシブルオブジェクトなし。使用されるスタイルは、そのテキストコンテナー上の
テキスト属性にマップされる。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
HTML 仕様
dl
[wai-aria-1.2 ]
list ロール
計算済みロール
list
MSAA + IAccessible2
ロール: ROLE_SYSTEM_LIST
状態: STATE_SYSTEM_READONLY
UIA
コントロール型: List
[ATK ]
ロール: ATK_ROLE_DESCRIPTION_LIST
AX
AXRole: AXList
AXSubrole: AXDefinitionList
AXRoleDescription:
"definition list"
コメント
HTML 仕様
embed
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-embed
MSAA + IAccessible2
ロール: ROLE_SYSTEM_CLIENT;
IA2_ROLE_EMBEDDED_OBJECT
状態:
ウィンドウなしプラグインの場合は STATE_SYSTEM_UNAVAILABLE
UIA
コントロール型: Pane
[ATK ]
ロール: ATK_ROLE_EMBEDDED
AX
データファイルの形式に依存する
コメント
HTML 仕様
kbd
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-kbd
MSAA + IAccessible2
アクセシブルオブジェクトなし。
テキスト属性:
テキストコンテナー上の font-family:monospace
UIA
アクセシブルオブジェクトなし。使用されるスタイルは、親アクセシブルオブジェクト上に実装される
TextRange コントロールパターンの UIA テキスト属性識別子によって公開される。
[ATK ]
アクセシブルオブジェクトなし。そのテキストコンテナー上の "font-family:monospace" テキスト属性に
マップされる。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
HTML 仕様
label
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-label
MSAA + IAccessible2
ロール: ROLE_SYSTEM_STATICTEXT;
IA2_ROLE_LABEL
関係:
label の子である
ラベル付け可能な
要素 、または
label 要素の
for 属性によって参照されるラベル付け可能な
要素との
IA2_RELATION_LABEL_FOR。関連付けられたラベル付け可能な
要素は
label を指す
IA2_RELATION_LABELLED_BY を持つ。
UIA
コントロール型: Group
関係:
label 要素が
ラベル付け可能な
要素 を含む場合、その要素の
LabeledBy プロパティは
label 要素の UIA 要素を指す。
label 要素が
for 属性を持ち、
ラベル付け可能な
要素 を参照している場合、参照先要素の
LabeledBy
プロパティは
label 要素の UIA 要素を指す。
[ATK ]
ロール: ATK_ROLE_LABEL
関係:
子の
ラベル付け可能な
要素 、または
for 属性によって参照されるラベル付け可能な
要素についての
ATK_RELATION_LABEL_FOR。なお、関連するラベル付け可能な
要素は
label を指す
ATK_RELATION_LABELLED_BY を提供する。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
注記
label 要素がアクセシビリティツリーから非表示 にされている場合、
その要素は、関連付けられた
ラベル付け可能な
要素 にアクセシブル名を提供しない。
HTML 仕様
legend
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-legend
MSAA + IAccessible2
ロール: ROLE_SYSTEM_STATICTEXT;
IA2_ROLE_LABEL
関係:
親
fieldset との
IA2_RELATION_LABEL_FOR
UIA
コントロール型: Text
その他のプロパティ:
親
fieldset の
LabeledBy プロパティは、
legend 要素の UIA 要素を指す。
[ATK ]
ロール: ATK_ROLE_LABEL
関係:
親
fieldset 要素との
ATK_RELATION_LABEL_FOR
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
HTML 仕様
map
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-map
MSAA + IAccessible2
イメージマップとして使用される場合はマップされない。それ以外の場合:
ロール: IA2_ROLE_TEXT_FRAME
UIA
マップされない
[ATK ]
イメージマップとして使用される場合はマップされない。それ以外の場合:
ロール: ATK_ROLE_STATIC
AX
ロール: イメージマップとして使用される場合は AXImageMap。
それ以外の場合、
ロール: alt を持たない img と関連付けられている場合は
AXGroup。それ以外の場合、
img と関連付けられていない場合はマップされない。
コメント
HTML 仕様
object
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-object
MSAA + IAccessible2
データファイルの形式に依存する。プラグインを含む場合:
ロール: IA2_ROLE_EMBEDDED_OBJECT
状態:
ウィンドウなしプラグインの場合は STATE_SYSTEM_UNAVAILABLE
UIA
データファイルの形式に依存する。
[ATK ]
データファイルの形式に依存する。プラグインを含む場合:
ロール:
ATK_ROLE_EMBEDDED
AX
データファイルの形式に依存する。
コメント
HTML 仕様
ruby
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-ruby
MSAA + IAccessible2
ロール: ROLE_SYSTEM_TEXT;
IA2_ROLE_TEXT_FRAME
UIA
コントロール型: Text
ローカライズ済みコントロール型:
"ruby"
[ATK ]
ロール: ATK_ROLE_STATIC
AX
AXRole: AXGroup
AXSubrole: AXRubyInline
AXRoleDescription: "group"
コメント
HTML 仕様
summary
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
要素が親 details 要素内でその型の最初の子である場合:
html-summary
そうでない場合、つまり親 details 要素のその型の最初の子でない場合、
または details 要素の子でない場合:
generic
ロール
MSAA + IAccessible2
ロール: ROLE_SYSTEM_PUSHBUTTON
状態:
STATE_SYSTEM_EXPANDED / STATE_SYSTEM_COLLAPSED
アクション: expand /
collapse
UIA
コントロール型: Button
コントロールパターン:
ExpandCollapse
[ATK ]
ロール: ROLE_TOGGLE_BUTTON
関係:
ATK_RELATION_DETAILS
AX
AXRole: AXDisclosureTriangle
AXSubrole: (nil)
AXRoleDescription:
"disclosure triangle"
コメント
summary 要素が details 要素の子でない場合、または親
details の最初の summary 要素でない場合、
ユーザーエージェントは summary 要素を
generic ロールで公開しなければならない。
HTML 仕様
var
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-var
MSAA + IAccessible2
アクセシブルオブジェクトなし。使用されるスタイルは、
そのテキストコンテナー上のテキスト属性にマップされる。
UIA
アクセシブルオブジェクトなし。使用されるスタイルは、親アクセシブルオブジェクト上に
実装される TextRange コントロールパターンの UIA テキスト属性識別子によって公開される。
[ATK ]
アクセシブルオブジェクトなし。使用されるスタイルは、
そのテキストコンテナー上のテキスト属性にマップされる。
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
HTML 仕様
video
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
html-video
MSAA + IAccessible2
ロール: ROLE_SYSTEM_GROUPING
UIA
コントロール型: Group
ローカライズ済みコントロール型:
"group"
ユーザーエージェントは、以下を
アクセシビリティ
ツリー に含め、それらを非表示または画面外としてマークしても
よい :
読み込みメッセージまたはエラーメッセージ
現在表示されていない UI コントロール
[ATK ]
ロール: ATK_ROLE_VIDEO
AX
AXRole: AXGroup
AXSubrole: AXVideo
AXRoleDescription:
"video playback"
コメント
HTML 仕様
wbr
[wai-aria-1.2 ]
対応するロールなし
計算済みロール
マップされない
MSAA + IAccessible2
改行が追加された場合は、テキストコンテナー上の
IAccessibleText で公開する
UIA
マップされない
[ATK ]
追加された場合の改行は、そのテキストコンテナー上の Text インターフェイスを介して
公開される
AX
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
コメント
ユーザーエージェントは、既定の WAI-ARIA 状態
およびプロパティセマンティクスを持つ HTML
属性を、[core-aam-1.2 ] 仕様で定義される
識別された WAI-ARIA 状態およびプロパティ
マッピングに従って、プラットフォームの アクセシビリティ API にマップしなければならない。
セル内の '?' は、データがまだ提供されていないことを示す。
"マップされない"(該当なし)は、その属性をアクセシビリティ API を介して公開する必要がないことを意味する。
これは通常、その属性がユーザーインターフェイスの一部として表示されないためである。
注記
場合によっては、アクセシビリティ
API
に直接公開されなくても、属性が要素の
アクセシビリティに影響することがある。例:
autoplay
は
video または
audio
要素の再生を自動的に開始する。
IAccessible2 マッピングでアクセシブルオブジェクトを持つすべての要素は、
IAccessible、IAccessible2 および IAccessible2_2 インターフェイスを実装することが想定される。
特定の HTML 要素とのユーザーインタラクションは、
要素のdirty
value flag を設定する。[HTML ] で識別される
これらの要素は、その要素の既定値または既定状態を表す属性を持つことがある。dirty フラグが設定されている場合、
その既定値または既定状態は、要素または対応するアクセシブルノードの値または状態を必ずしも決定しない。
HTML 仕様
autocomplete
要素
form
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
マップされない
UIA
マップされない
[ATK ]
マップされない
AX
マップされない
コメント
注記
注記: aria-autocomplete 属性と
HTML autocomplete
属性は異なる機能を持つ。aria-autocomplete 属性は、
HTML
form 要素、または明示的な ARIA form
ロールを持つ要素ではサポートされない。
HTML 仕様
autocomplete
要素
input,
select および textarea
[WAI-ARIA-1.2 ]
注記
注記: aria-autocomplete 属性と
HTML
autocomplete 属性は異なる機能を持つが、ユーザーエージェントが
コントロールの自動補完対応を公開するための仕組みとしては重なり合う。
MSAA + IAccessible2
UIA
[ATK ]
AX
コメント
フォームコントロールに autocomplete=off が指定されており
(属性の明示的な使用によるものか、autocomplete=off を持つ親
form 要素から off 状態を継承したことによるものかを問わない)、
かつ有効な値を持つ aria-autocomplete 属性も指定されている場合、
ユーザーエージェントは aria-autocomplete 属性値のみを公開しなければならない。
それ以外の場合で、フォームコントロールに有効なトークン値を持つ
autocomplete 属性と aria-autocomplete 属性が
指定されている場合、ユーザーエージェントは
autocomplete 属性値のみを公開しなければならない。
HTML 仕様
checked(存在する場合)
要素
input
type=checkbox または type=radio
[WAI-ARIA-1.2 ]
aria-checked ="true"
MSAA + IAccessible2
UIA
プロパティ: Toggle.ToggleState: On (1)
[ATK ]
AX
AXValue: 1
コメント
checkbox または radio 状態の input 要素が、
checked 属性と、有効な値を持つ aria-checked
属性の両方を含む場合、ユーザーエージェントは
checked 属性値のみを公開しなければならない。
HTML 仕様
checked(存在しない場合)
要素
input
type=checkbox または type=radio
[WAI-ARIA-1.2 ]
aria-checked ="false"
MSAA + IAccessible2
UIA
プロパティ: Toggle.ToggleState: Off (0)
[ATK ]
AX
AXValue: 0
コメント
checked 属性を持たない、checkbox または radio 状態の
input 要素は、暗黙的な "false" 状態を持つ。ユーザーエージェントは、ネイティブ要素の
暗黙的な checked 状態と競合する aria-checked 属性を無視しなければならない。
HTML 仕様
commandfor
要素
button
[WAI-ARIA-1.2 ]
コメントを参照
MSAA + IAccessible2
コメントを参照
UIA
コメントを参照
ATK
コメントを参照
AX
コメントを参照
コメント
commandfor 属性は、button 要素に関連付けられた要素を識別する。
指定された command 状態は、button とそのプログラム的に
関連付けられた要素との間の関係マッピングを公開する必要があるかどうかを決定する。
HTML 仕様
contenteditable
要素
HTML 要素
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
要素が編集可能状態である場合、以下のマッピングは、その要素およびすべてのネストされた
アクセシブルオブジェクトに適用される。ただし、
false 状態に指定されたものは例外である。
状態:
IA2_STATE_EDITABLE および IA2_STATE_MULTI_LINE
インターフェイス:
IAccessibleEditableText
要素が false 状態である場合: マップされない。
要素が inherit 状態である場合: その親要素の編集可能状態に一致する。
UIA
要素が編集可能状態である場合、以下のマッピングは、その要素およびすべてのネストされた
アクセシブルオブジェクトに適用される。ただし、
false 状態に指定されたものは例外である。
コントロールパターン: TextEdit
プロパティ:
AriaProperties.multiline:true
要素が false 状態である場合: マップされない。
要素が inherit 状態である場合: その親要素の編集可能状態に一致する。
[ATK ]
要素が編集可能状態である場合、以下のマッピングは、その要素およびすべてのネストされた
アクセシブルオブジェクトに適用される。ただし、
false 状態に指定されたものは例外である。
状態:
ATK_STATE_EDITABLE および ATK_STATE_MULTI_LINE
インターフェイス:
AtkEditableText
要素が false 状態である場合: マップされない。
要素が inherit 状態である場合: その親要素の編集可能状態に一致する。
AX
ロール:
AXTextArea
コメント
要素が contenteditable に設定され、かつ
aria-readonly="true" である場合、ユーザーエージェントは
contenteditable 状態のみを公開しなければならない。
HTML 仕様
coords
要素
area
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
アクセシブルオブジェクトの寸法を定義する
(IAccessible::accLocation)
UIA
アクセシブルオブジェクトの寸法を定義する
(BoundingRectangle)
[ATK ]
アクセシブルオブジェクトの寸法を定義し、
atk_component_get_position および atk_component_get_size
を介して公開される
AX
アクセシブルオブジェクトの寸法を定義し、
Frame プロパティを介して公開される
コメント
HTML 仕様
dir
要素
HTML 要素
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
テキストコンテナー上の "writing-mode" テキスト属性として公開される。
UIA
親アクセシブルオブジェクト上に実装される
TextRange コントロールパターンの TextFlowDirections
属性によって公開される。
[ATK ]
テキストコンテナー上の "writing-mode" テキスト属性として公開される。
AX
マップされない
コメント
HTML 仕様
dir
要素
bdo
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
テキストコンテナー上の "writing-mode" テキスト属性として公開される。
UIA
親アクセシブルオブジェクト上に実装される
TextRange コントロールパターンの TextFlowDirections
属性によって公開される。
[ATK ]
テキストコンテナー上の "writing-mode" テキスト属性として公開される。
AX
マップされない
コメント
HTML 仕様
for
要素
output
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
関係:
属性によって指し示される要素との IA2_RELATION_CONTROLLED_BY。
対になる要素は IA2_RELATION_CONTROLLER_FOR 関係を公開する。
UIA
マップされない
[ATK ]
関係:
属性によって指し示される要素との ATK_RELATION_CONTROLLED_BY。
対になる要素は ATK_RELATION_CONTROLLER_FOR 関係を公開する。
AX
マップされない
コメント
HTML 仕様
href
要素
a; area
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
リンクのアクセシブルオブジェクトを作成する。詳細については、
a および
area
要素マッピングを参照。
UIA
リンクのアクセシブルオブジェクトを作成する。詳細については、
a および area 要素
マッピングを参照。href 属性の値は
Value.Value UIA プロパティに格納される。
[ATK ]
リンクのアクセシブルオブジェクトを作成する。詳細については、
a および
area
要素マッピングを参照。
AX
AXURL: <value>
コメント
HTML 仕様
indeterminate [IDL]
要素
HTML 要素;
input
[WAI-ARIA-1.2 ]
aria-checked
(state)="mixed"
MSAA + IAccessible2
WAI-ARIA マッピングを使用
UIA
WAI-ARIA マッピングを使用
[ATK ]
WAI-ARIA マッピングを使用
AX
WAI-ARIA マッピングを使用
コメント
要素に indeterminate [IDL] が設定され、かつ
aria-checked 属性が設定されている場合、ユーザーエージェントは
indeterminate [IDL] 状態のみを公開しなければならない。
HTML 仕様
lang
要素
HTML 要素
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
テキストコンテナー上の "language" テキスト属性として公開される
UIA
lang 属性の値は、
HTML 要素を表す
UIA 要素の
Culture プロパティ、および親アクセシブルオブジェクト上に実装される
TextRange コントロールパターンの
Culture 属性によって、ロケール識別子として公開される。
[ATK ]
テキストコンテナー上の "language" テキスト属性として公開される
AX
AXLanguage: <value>
コメント
HTML 仕様
list
要素
input
[WAI-ARIA-1.2 ]
aria-controls
MSAA + IAccessible2
IA2_RELATION_CONTROLLER_FOR は、
list 属性の IDREF 値によって参照される
datalist 要素を指す。
UIA
ControllerFor は、list
属性の IDREF 値によって参照される datalist 要素を指す。
[ATK ]
ATK_RELATION_CONTROLLER_FOR は、
list 属性の IDREF 値によって参照される
datalist 要素を指す。
AX
プロパティ: AXLinkedUIElements: list
属性の IDREF 値によって参照される
datalist 要素を指す。
コメント
datalist および input 要素マッピングを参照。
HTML 仕様
minlength
要素
input ;
textarea
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
状態:
値が指定された最小長の値を満たさない場合、
IA2_STATE_INVALID_ENTRY。
UIA
状態:
値が指定された最小長の値を満たさない場合、
IsDataValidForForm。
[ATK ]
状態:
値が指定された最小長の値を満たさない場合、
ATK_STATE_INVALID_ENTRY。
AX
プロパティ:
値が指定された最小長の値を満たさない場合、
AXInvalid: true。
コメント
HTML 仕様
placeholder
要素
input ;
textarea
[WAI-ARIA-1.2 ]
aria-placeholder
MSAA + IAccessible2
UIA
[ATK ]
AX
コメント
placeholder 属性と aria-placeholder 属性が
両方存在し、かつ placeholder 属性の値が空でない場合、ユーザー
エージェントは MUST 、
placeholder 属性の値を公開し、aria-placeholder を
無視しなければならない。placeholder 属性の値が空である場合、
ユーザーエージェントは MUST 、aria-placeholder
属性の値を公開しなければならない。
HTML 仕様
popover
要素
HTML 要素
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
関係: IA2_RELATION_DETAILS_FOR は呼び出し元要素を指す。
コメントを参照 。
オブジェクト属性:
ispopup: <value>。ここで
<value> は
popover
型を反映する。
UIA
詳細関係を必要とする条件を満たす呼び出し元要素が存在する場合、その呼び出し元要素との間に
詳細関係が作成される。
コメントを参照 。
[ATK ]
関係: RELATION_DETAILS_FOR は
呼び出し元要素を指す。コメントを参照 。
オブジェクト属性:
ispopup: <value>。ここで
<value> は
popover
型を反映する。
AX
未定
ユーザーエージェントは、以下の条件下では、
popover とその呼び出し元要素との間の詳細関係を公開してはならない
(MUST NOT ):
popover が呼び出し元要素の次の直接のアクセシビリティ上の兄弟である場合、
要素が popovertargetaction=hide 属性値を持つ場合、
または、要素が popover の子孫であり、その
popovertarget が "auto" 状態である場合。
暗黙のロールが generic である要素に指定されている場合、その要素のロールは、
すべての
popover
状態 において、代わりに group
にマップされる。
注記
異なる popover 状態に対する固有のマッピングは存在しない。popover
要素のアクセシビリティマッピングの変更は、作者の責任となる。たとえば、
異なる基礎となる HTML 要素、
属性、または ARIA 属性を使用して、そのような変更を行う。
HTML 仕様
reversed
要素
ol
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
子リスト項目マーカーの数値またはアルファベットの順序を逆にする。
UIA
子リスト項目マーカーの数値またはアルファベットの順序を逆にする。
[ATK ]
子リスト項目マーカーの数値またはアルファベットの順序を逆にする。
AX
子リスト項目マーカーの数値またはアルファベットの順序を逆にする。
コメント
HTML 仕様
size
要素
input ;
select
[WAI-ARIA-1.2 ]
input 要素についてはマップされない。
1 より大きい場合、listbox アクセシブルオブジェクトを作成する。詳細については
select 要素を参照。
MSAA + IAccessible2
input 要素についてはマップされない。
select 要素については
WAI-ARIA マッピングを使用する。
UIA
input 要素についてはマップされない。
select 要素については
WAI-ARIA マッピングを使用する。
[ATK ]
input 要素についてはマップされない。
select 要素については
WAI-ARIA マッピングを使用する。
AX
input 要素についてはマップされない。
select 要素については
WAI-ARIA マッピングを使用する。
コメント
size 属性を許容する input 要素では、この属性は既定の幅を変更する。
CSS によって指定された幅は、これらの
input 要素に対する size 属性の効果を無効にする。
HTML 仕様
span
要素
col ;
colgroup
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
列にあるすべてのセル上で
IAccessibleTableCell::columnExtent として公開される
UIA
列にあるすべてのセル上で GridItem.ColumnSpan
として公開される
[ATK ]
atk_table_get_column_extent_at を介して公開される
AX
AXColumnIndexRange.length: <value>
コメント
HTML 仕様
start
要素
ol
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
子リスト項目アクセシブルオブジェクトの最初の番号を、
start 属性の値と一致するように変更する。
UIA
子リスト項目アクセシブルオブジェクトの最初の番号を、
start 属性の値と一致するように変更する。
[ATK ]
子リスト項目アクセシブルオブジェクトの最初の番号を、
start 属性の値と一致するように変更する。
AX
子リスト項目アクセシブルオブジェクトの最初の番号を、
start 属性の値と一致するように変更する。
コメント
HTML 仕様
step
要素
input
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
マップされない
UIA
input が Range
状態にある場合、RangeValue.SmallChange と
RangeValue.LargeChange の両方を step の値に設定する。
[ATK ]
要素が AtkValue インターフェイスを実装する場合、
atk_value_get_minimum_increment として公開される。
AX
マップされない
コメント
HTML 仕様
type
要素
ol
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
リスト項目マーカーを定義する。これは
アクセシブル
オブジェクト を持たないが、関連付けられた
リスト項目のアクセシブルテキスト内のコンテンツとして公開される。
インターフェイス: IAccessibleText2
UIA
リスト項目マーカーを定義する。これは
アクセシブル
オブジェクト を持たないが、関連付けられた
リスト項目のアクセシブルテキスト内のコンテンツとして公開される。
コントロールパターン: Text
[ATK ]
リスト項目マーカーを定義する。これは
アクセシブル
オブジェクト を持たないが、関連付けられた
リスト項目のアクセシブルテキスト内のコンテンツとして公開される。
インターフェイス: ATKText
AX
リスト項目マーカーを定義する。これは
AXValue 内のコンテンツとして公開され、
アクセシブル
オブジェクト としてレンダリングされる:
AXRole: AXListMarker
AXSubrole: (nil)
AXRoleDescription:
"list marker"
コメント
一部のプラットフォーム(IAccessible2、ATK、UIA)は、リスト項目マーカーに対して
アクセシブル
オブジェクト を公開しない。これは、そのオブジェクトが作成された後で
アクセシビリティ
ツリー から刈り込まれた場合でも、そもそも作成されなかった場合でも同じである。代わりに、それらはリスト
項目マーカーを関連付けられたリスト項目のアクセシブルテキストの一部として公開する。これらの
場合、実装者は、リスト項目レンダラーからのオフセットをそのまま使用するのではなく、
リスト項目マーカーもコンテンツとして含むようになった更新後のリスト項目テキストについて、
オフセット(例: キャレット移動イベント、テキスト選択イベントなど)を調整する必要がある。
HTML 仕様
value
要素
li
[WAI-ARIA-1.2 ]
マップされない
MSAA + IAccessible2
li のアクセシブルオブジェクトの最初のテキストノードとして公開される。
UIA
value 属性の値を、リスト項目内の最初のテキストノードとして公開する。
value 属性の値が整数である場合、UIA
PositionInSet プロパティをその
整数値に設定する。
[ATK ]
li のアクセシブルオブジェクトの最初のテキストノードとして公開される。
AX
アクセシブルオブジェクトとともに AXValue: <value> として公開される:
AXRole: AXListMarker
AXSubrole: (nil)
AXRoleDescription:
list marker
コメント
アクセシブル名 および アクセシブル説明 という用語は、
すべての アクセシビリティ API で提供されるプロパティである。プロパティ名は
API ごとに異なる場合があるが、同じ機能、すなわち短い(名前)またはより長い(説明)
テキスト文字列のコンテナーとして機能する。
テキスト代替
計算 は、アクセシブル名 および
アクセシブル説明 の両方を生成するために使用される。
複数の異なる種類の
要素 、ノード 、および
マークアップの組み合わせに対して、異なる規則が提供されている。
注記
ユーザーエージェントは、関連するアクセシビリティ情報が変更されたとき、アクセシブルオブジェクトを破棄して再作成することにより、
または指定された
名前変更イベントマッピング および 説明変更イベント
マッピング に従ってオブジェクトへの変更を通知することにより、支援技術に通知する。
abbr ,
b ,
bdi ,
bdo ,
br ,
cite ,
code ,
dfn ,
em ,
i ,
kbd ,
mark ,
q ,
rp ,
rt ,
ruby ,
s ,
samp ,
small ,
strong ,
sub
および sup , time ,
u ,
var ,
wbr
要素に aria-label または aria-labelledby
属性がある場合、
アクセシブル名 は
Accessible Name and Description:
Computation and API
Mappings で定義されたアルゴリズムを使用して
計算される。
それ以外の場合、title 属性を使用する。
上記のいずれも使用可能なテキスト文字列を生成しない場合、アクセシブル名 はない。
Web Platform
Design Principles に従い、この仕様は、情報が支援技術によって使用されているかどうかを判定するためのプログラム上の
インターフェイスを提供しない。しかしながら、この仕様は、作者が支援技術の利用者に対して、
支援技術を使用しない利用者が利用可能な情報とは異なる情報を提示することを許容する。これは、
Web 技術スタックの他の多くの部分を用いて可能であるのと同様に、ARIA および CORE-AAM 仕様の多くの機能を用いることで
可能である。このコンテンツの不一致は、支援技術の利用者に対する
能動的フィンガープリンティング を実行するために
悪用される可能性がある。
この仕様は新たなセキュリティ上の考慮事項を導入しない。
GitHub 上のこの文書の コミット履歴 を参照。
2-April-2025: command および commandfor 属性マッピングを追加。GitHub ARIA PR 2354 を参照。
11-July-2024: ユーザーエージェントは body および
html 要素上の aria-hidden=true を無視する。GitHub PR
516 を参照。
06-June-2024: Minimum Role の概念を追加。GitHub PR
454 を参照。
06-June-2024: popover、popovertarget および
popovertargetaction マッピングを追加。GitHub PR 481 を参照。
09-Oct-2023: select 要素内での hr 要素の使用を認める。GitHub PR 504 を参照。
03-Oct-2023: 画像マッピングを更新し、主要な同義ロール(image
および none)を参照するようにした。GitHub PR
498 を参照。
03-Oct-2023: 必須フィールドを無効として公開する時点を明確化。GitHub
PR 429 を参照。
06-Jun-2023: すべての HTML
要素に対する計算ロールを追加。GitHub PR 465 を参照。
28-Mar-2023: inert 属性マッピングを追加。GitHub PR 410 を参照。
24-Mar-2023: search 要素およびそのマッピングを追加。GitHub PR 355 を参照。
08-Mar-2023: hgroup 要素を role=group にマップするよう更新。GitHub PR 398 を参照。
08-Mar-2023: output 要素の命名アルゴリズムを明確化。GitHub PR 402 を参照。
12-Dec-2022: s 要素のマッピングを role=deletion に改訂。GitHub PR 442 を参照。
28-Nov-2022: アクセシブル説明計算セクションを簡素化。GitHub PR
444 を参照。
19-Jul-2022: address 要素を role=group にマップするよう更新。GitHub PR 420 を参照。
03-Apr-2022: 入れ子の文脈に基づいて aside マッピングを更新。GitHub PR 350 を参照。
06-Mar-2022: 次の要素を generic ロールにマップするよう更新:
a no href、body にスコープされていない footer、body
にスコープされていない header、
samp、span。GitHub PR
364 を参照。
06-Feb-2022: mark を、そのロールの Core AAM マッピングを指すよう更新。GitHub Issue 316 を参照。
02-Nov-2021: blockquote、caption、code、
del、em、ins、meter、paragraph、
strong、sub、sup および time を Core AAM の ARIA
1.2
マッピングに更新。body マッピングを
generic に、html マッピングを document に修正。
hgroup マッピングを generic に修正。details を
group にマップし、ATK、UIA 固有の追加情報を含めるよう更新。
GitHub issue #348 を参照。
12-May-2021: 属性表に FACES 参照を追加 - readonly、
name、form、disabled。Issue 257 を参照。
12-Dec-2019: hgroup、slot、自律カスタム要素およびフォーム関連カスタム要素を追加。
GitHub issue
#189 を参照。
26-Nov-2019: disabled、scope、
spellcheck、tabindex のマッピングを WAI-ARIA を指すよう更新。AX の
pattern、
reversed、rows、size、span、
src、start、step、
type 属性マッピングを追加。min-length、ping、
playsinline、referrerpolicy、sizes、srcset、
data[value] 属性マッピングを追加。GitHub
pull request #245 を参照。
↑