Spec-Zone.ru › Web APIs

Элемент: свойство ariaChecked

Базовая версия 2023
Новое свойство

С октября 2023 года данная функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.

  • Подробнее
  • Полная информация о совместимости
  • Отправить отзыв

Свойство ariaChecked интерфейса Element отражает значение атрибута aria-checked, который указывает текущее состояние «выбора» для чекбоксов, радиокнопок и других виджетов, имеющих состояние выбора.

Примечание: В тех случаях, где это возможно, используйте элемент HTML <input> с type="checkbox", так как этот элемент имеет встроенную семантику и не требует атрибутов ARIA.

Значение

Строка с одним из следующих значений:

"true"

Элемент выбран.

"mixed"

Указывает смешанное состояние для три-состояниевого чекбокса или элемента меню-чекбокса.

"false"

Элемент поддерживает состояние выбора, но в настоящее время не выбран.

"undefined"

Элемент не поддерживает состояние выбора.

Примеры

В этом примере атрибут aria-checked элемента с ID checkBoxInput имеет значение "false", что указывает на то, что данный элемент ввода сейчас не выбран. Используя ariaChecked, мы обновляем значение на "true".

<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"

Спецификации

Спецификация
Приложения с богатым интерактивным интерфейсом (WAI-ARIA)
# dom-ariamixin-ariachecked

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
ariaChecked 81 81 119 68 12.1 81 119 58 12.2 13.0 81

См. также

  • ARIA: роль чекбокса

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaChecked

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API