ARIA: aria-checked 属性
aria-checked 属性は、チェックボックスやラジオボタン、その他のウィジェットの現在の「チェックされている」状態を示します。
メモ:
可能な場合は、HTML の type="checkbox" または type="radio" の <input> 要素を使用してください。これらには意味的な情報が組み込まれているため、ARIA 属性は必要ありません。
解説
aria-checked 属性は、要素がチェックされている (true)、チェックされていない (false)、またはチェック状態が未決定 (mixed)(チェックされている状態でもチェックされていない状態でもない)のいずれであるかを示します。mixed の値は、3 状態入力ロールである checkbox と menuitemcheckbox で対応しています。
mixed の値は、radio、menuitemradio、switch などのロールや、これらを継承する要素では対応していません。対応していない場合に mixed が設定されると、値は false になります。
<span
role="checkbox"
id="checkBoxInput"
aria-checked="false"
tabindex="0"
aria-labelledby="chk15-label"></span>
<label id="chk15-label">Subscribe to the newsletter</label>
フォーカスを有効にするには、tabindex 属性が必要です。aria-checked 状態を切り替えるには、JavaScript が必要です。また、このチェックボックスが送信可能なフォームの一部である場合は、名前と値を設定するために、さらに JavaScript が必要です。
上記は次のように記述することもできます:
<input type="checkbox" id="chk15-label" name="Subscribe" />
<label for="chk15-label">Subscribe to the newsletter</label>
ARIA の代わりに type="checkbox" の <input> 要素を使用すると、JavaScript は必要ありません。
値
- false
-
要素はチェックをサポートしていますが、現在はチェックされていません。
- true
-
要素はチェックされています。
- mixed
-
checkboxおよびmenuitemcheckboxの場合のみ、indeterminateと同等であり、チェックもチェック解除もされていない混合モードの値を示します。 - undefined (デフォルト)
-
要素はチェックに対応していません。
関連インターフェイス
Element.ariaChecked-
Elementインターフェイスの一部であるariaCheckedプロパティは、aria-checked属性の値を反映します。 ElementInternals.ariaChecked-
ElementInternalsインターフェイスの一部であるariaCheckedプロパティは、aria-checked属性の値を反映します。
myHTMLElement.ariaChecked = true;
関連ロール
以下のロールで使用されます:
仕様書
| 仕様書 |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-checked> |
| Unknown specification> |