aria-checked

ARIA-атрибут, который нужен для чекбоксов, переключателей, радиокнопок и пунктов выпадающего списка.

Время чтения: меньше 5 мин

Это незавершённая статья. Вы можете помочь её закончить! Почитайте о том, как контрибьютить в Доку.

Кратко

Секция статьи "Кратко"

Состояние виджета из WAI-ARIA. Означает состояние, в котором сейчас находятся чекбокс или по-другому флажок, радиокнопка или пункт выпадающего списка.

Так же ведёт себя HTML-атрибут checked.

Пример

Секция статьи "Пример"
        
          
          <span role="checkbox" aria-labelledby="label" tabindex="0" aria-checked="false"></span><label id="label">Получать рассылку</label>
          <span role="checkbox" aria-labelledby="label" tabindex="0" aria-checked="false"></span>
<label id="label">Получать рассылку</label>

        
        
          
        
      

Как пишется

Секция статьи "Как пишется"

Добавьте к тегу атрибут aria-checked с одним из значений:

  • true — элемент отмечен или выбран.
  • false — элемент не отмечен или не выбран.
  • mixed — у элементов смешанное состояние.
  • undefined (по умолчанию) — элемент нельзя отметить или выбрать.

Значение mixed поддерживают элементы с ролями checkbox и menuitemcheckbox.

aria-checked можно использовать только для некоторых ролей:

  • option.
  • radio.
  • checkbox.
  • menuitemcheckbox.
  • switch.

Если используете <input type="radio">, <input type="checkbox"> и <option>, им не нужен атрибут aria-checked.

Как понять

Секция статьи "Как понять"

Чекбоксы, переключатели, радиокнопки и пункты выпадающего списка обычно бывают в двух состояниях — выбранном или нет. У групп чекбоксов иногда бывает смешанное состояние, когда выбраны не все чекбоксы.