База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

aria-checked — състояние на отметката

`aria-checked` описва отметката на контрола с подходяща роля; сам не реализира поведението на поле за отметка.

Версия: WAI-ARIA 1.2

Синтаксис

<button role="checkbox" aria-checked="mixed">All topics</button>

За контрола checkbox използвай низовете true, false или mixed. Липсващото състояние е неопределено, не неотбелязано; ролята checkbox изисква изрично състояние. Смесеното състояние е подходящо за частично избрана група; ролите radio и switch не го поддържат. Това не е булев HTML атрибут, включван чрез присъствие.

Първо предпочети стандартно поле за отметка. Собствена контрола изисква работа с клавиатура, фокус, етикет и вид, съответстващ на състоянието. Промяната на ARIA сама не отбелязва свързаните полета.

Примерът използва стандартен бутон с роля checkbox за управление на група. Първоначално е избрана една тема; активирането избира двете и задава истина. Тестът проверява реалните полета и дървото за достъпност, а не определено изречение на четеца.

Примери

<!doctype html><meta charset="utf-8">
<button id="all" role="checkbox" aria-checked="mixed">All topics</button>
<label><input class="topic" type="checkbox" checked> HTML</label>
<label><input class="topic" type="checkbox"> CSS</label>
<output id="result"></output>
<script>
const all = document.querySelector('#all');
const topics = [...document.querySelectorAll('.topic')];
function sync() {
  const n = topics.filter(input => input.checked).length;
  all.setAttribute('aria-checked', n === 0 ? 'false' : n === topics.length ? 'true' : 'mixed');
}
topics.forEach(input => input.addEventListener('change', sync));
all.addEventListener('click', () => {
  const checked = all.getAttribute('aria-checked') !== 'true';
  topics.forEach(input => { input.checked = checked; }); sync();
});
all.click();
document.querySelector('#result').textContent = 'selected=' + topics.filter(x => x.checked).length + '; checked=' + all.getAttribute('aria-checked');
</script>

Резултат

selected=2; checked=true

Резултатът показва две отбелязани теми и състояние true. Поведението идва от обработката на кликване, не от ARIA сама по себе си.

Източници