aria-activedescendant
aria-activedescendant
属性は、composite
ウィジェット、combobox
、textbox
、group
、application
にフォーカスが当たっている時、現在アクティブな要素を特定します。
解説
aria-activedescendant
プロパティは、メニュー、グリッド、ツールバーなど、フォーカス可能な複数の子孫要素を格納する場合に、対話要素上で支援技術のためにフォーカスを管理するメソッドを提供します。スクリーンリーダーが所有する要素間でフォーカスを移動させる代わりに、 aria-activedescendant
は、現在アクティブな要素を参照するためにコンテナー要素上で使用することができ、フォーカスされたときに現在アクティブな要素を支援技術ユーザーに知らせます。
aria-activedescendant
を使用すると、ブラウザーは、コンテナー要素またはコンテナー要素を制御する入力要素にDOMフォーカスを維持します。しかし、ユーザーエージェントは、 aria-activedescendant
によって参照される要素にフォーカスがあるかのように、デスクトップのフォーカスイベントと状態を支援技術に伝えます。
この属性は、composite
ウィジェット、combobox
、textbox
、group
、application
の役割を持ち、 id
が属性値として参照される要素にのみ関連します。
属性は、どの要素がフォーカスを持つかという情報を支援技術に提供することを管理しますが、実際にフォーカスを作成することはありません。フォーカスの変更と属性値の管理は JavaScript で行います。その属性値を管理することに加えて、フォーカスが当たったときに、現在アクティブな子孫が表示され、視界に入る(または視界にスクロールする)ことを確認してください。
DOM のフォーカスのある要素に aria-activedescendant
の値を設定するには、確実に自分自身で参照する要素、 DOM にフォーカスのある要素の子孫か、 aria-owns
属性で示す論理的な子孫を参照します。
DOM フォーカスのある要素がコンボボックス、テキストボックス、検索ボックスの場合、 aria-activedescendant
に対応している要素を参照するために aria-controls
を含めてください。
aria-activedescendant
の値は、制御される要素の自分自身で所有している要素を参照します。例えば、コンボボックスでは、コンボボックスにフォーカスが当たったまま、コンボボックス要素の aria-activedescendant
の値は、コンボボックスによって制御されるポップアップリストボックスの子孫を参照します。
メモ: この属性はいくつかのロールにのみ対応しています。例えば、 dialog
は aria-activedescendant
に対応していません。コンボボックスがダイアログを開いた場合、DOMフォーカスはコンボボックスからダイアログに移ります。
メモ: listbox
、grid
、tree
のポップアップの子孫にフォーカスが当たった場合、DOM フォーカスは combobox に残り、combobox には aria-activedescendant
が設定され、ポップアップ内でフォーカスされた要素を参照する値が設定されます。
値
- ID reference
-
現在フォーカスがある要素の
id
の値を取ります。
関連するロール
以下の役割を持つ要素の属性としてのみ関連します。
仕様書
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |