このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 になります。

html
<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 が必要です。

上記は次のように記述することもできます:

html
<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 属性の値を反映します。

js
myHTMLElement.ariaChecked = true;

関連ロール

以下のロールで使用されます:

仕様書

仕様書
Accessible Rich Internet Applications (WAI-ARIA)
# aria-checked
Unknown specification

関連情報