ARIA: aria-selected 属性
aria-selected 属性は、さまざまなウィジェットの現在の「選択されている」状態を示します。
解説
aria-selected 属性は、gridcell、option、row、tab ロールの現在の「選択されている」状態を示します。
この属性は、単一選択および複数選択の複合ウィジェット内のどの要素が選択されているかを示すために使用されます。一度に複数の要素が選択可能な場合は、aria-multiselectable="true" をグリッド、リストボックス、タブリスト、またはその他の所有ロールに含め、aria-selected は選択可能なセル、オプション、およびタブにのみ含めます。
その他のロールでは、現在選択されている状態はロールに応じて aria-current、aria-checked、aria-pressed で設定されます。
aria-selected と aria-current の両方に対応するウィジェットでは、それぞれの状態が異なる意味を持ちます。例えば、aria-current="page" はナビゲーションツリーで現在表示されているページを示すために使用できますが、aria-selected="true" はユーザーが treeitem をアクティブにした場合に表示されるページを示します。
グリッド
フォーカス可能なグリッドセルに aria-selected="false" を設定すると、セルが選択可能であることを示します。グリッドで一度に複数のグリッドセルを選択できる場合は、grid ロールを持つ要素に aria-multiselectable="true" を設定します。列または行見出しのグリッドセルに aria-selected を設定しても、列または行内の他のセルに状態は伝播されません。
オプション
aria-selected と aria-checked はどちらも option に有効です。一部のユーザーインターフェイスでは、単一選択リストボックスでは選択状態を aria-selected で示し、複数選択リストボックスでは aria-checked で示します。
ユーザーインターフェイスにおける aria-selected の意味や目的が aria-checked と異なり、それぞれの状態の意味や目的が明確で、UI が各状態を個別に制御する方法を提供している場合を除き、同じ listbox 内の option 要素に aria-selected と aria-checked の両方を指定しないでください。
行
aria-selected 属性は row ロールでは対応していますが、column ロールでは対応していません。グリッドが選択に対応している場合、セルまたは行を選択すると、選択された要素に aria-selected="true" が設定されます。
グリッドが列選択に対応しており、列が選択されている場合、その列内のすべてのセルに aria-selected="true" が設定されます。
タブ
タブリストでは、aria-selected はタブ上で現在表示されている tabpanel を示すために使用されます。
tablist で選択されている tab には aria-selected="true" 属性が設定されている必要があります。タブリスト内の全ての非アクティブなタブには aria-selected="false" が設定されている必要があります。状態の設定はアクセシビリティツリーにのみ影響します。アクティブなタブのスタイルは、選択されている状態であることが視覚的に表示されるように設定してください。tab ロールにおける aria-selected のデフォルト値は false です。
一度に複数のタブを選択できる場合は、tablist に aria-multiselectable を含めます。
値
true-
選択可能な要素が選択されています。
false-
選択可能な要素は選択されていません。
tabの暗黙のデフォルト値です。 undefined(デフォルト)-
要素は選択できません。
関連インターフェイス
Element.ariaSelected-
Elementインターフェイスの一部であるariaSelectedプロパティは、aria-selected属性の値を反映します。 ElementInternals.ariaSelected-
ElementInternalsインターフェイスの一部であるariaSelectedプロパティは、aria-selected属性の値を反映します。
関連付けられたロール
使用するロール:
継承先のロール:
例
この tablist の例では、最初の tab が選択されています:
<div class="tab-interface">
<div role="tablist" aria-label="サンプルのタブ">
<span
role="tab"
aria-selected="true"
aria-controls="panel-1"
id="tab-1"
tabindex="0">
最初のタブ
</span>
<span
role="tab"
aria-selected="false"
aria-controls="panel-2"
id="tab-2"
tabindex="-1">
2 番目のタブ
</span>
<span
role="tab"
aria-selected="false"
aria-controls="panel-3"
id="tab-3"
tabindex="-1">
3 番目のタブ
</span>
</div>
<div id="panel-1" role="tabpanel" tabindex="0" aria-labelledby="tab-1">
<p>最初のパネルの内容</p>
</div>
<div id="panel-2" role="tabpanel" tabindex="0" aria-labelledby="tab-2" hidden>
<p>2 番目のパネルの内容</p>
</div>
<div id="panel-3" role="tabpanel" tabindex="0" aria-labelledby="tab-3" hidden>
<p>3 番目のパネルの内容</p>
</div>
</div>
メモ: ARIA は、要素のアクセシビリティツリーと、支援技術がコンテンツをユーザーに提示する方法のみを変更します。ARIA は、要素の機能や動作については何も変更しません。
仕様書
| 仕様書 |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-selected> |