Element: ariaChecked プロパティ

Baseline 2023

Newly available

Since ⁨October 2023⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

ariaChecked は Element インターフェイスプロパティで、チェックボックスやラジオボタン、その他のチェック状態のあるウィジェットの現在の "checked" 状態を示す aria-checked 属性の値を反映します。

メモ: 可能な限り、HTML の <input> 要素で type="checkbox" を使用してください。この要素には意味づけがあり、ARIA 属性は必要ありません。

値

以下のいずれかの値を持つ文字列です。

"true": 要素がチェックされています。
"mixed": 3 状態チェックボックスまたは menuitemcheckbox の混在モードの値を示します。
"false": 要素はチェックに対応していますが、現在はチェックされていません。
"undefined": 要素はチェックに対応していません。

例

この例では、ID が checkBoxInput の要素の aria-checked 属性は "false" に設定されており、この入力は現在チェックされていないことを示しています。ariaChecked を使用して、値を "true" に更新します。

html

<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk1-label">
</span>
<label id="chk1-label">Remember my preferences</label>

let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked); // "false"
el.ariaChecked = "true";
console.log(el.ariaChecked); // "true"