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

CKTIS / HTML

aria-disabled — състояние на деактивирана контрола

aria-disabled уведомява помощните технологии, че даден елемент е възприемаем, но не е достъпен за използване. Самият атрибут не предотвратява действия и не премахва елемента от реда на фокусиране; авторът трябва да реализира това поведение.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

aria-disabled="true" | aria-disabled="false"

aria-disabled="true" обозначава елемент като деактивиран, но все още възприемаем. aria-disabled="false" е стойността по подразбиране за това състояние, но не отменя нативния disabled. Това не е булев HTML атрибут: задавайте изрично "true" или "false", вместо да разчитате само на наличието на атрибута.

За разлика от нативния disabled, самият aria-disabled не предотвратява активирането, не променя реда на фокусиране и не осигурява визуално оформление за деактивирано състояние. Предпочитайте нативния disabled, когато отговаря на изискванията. Ако недостъпен бутон трябва да остане достижим с Tab, използването на aria-disabled изисква също действието да бъде блокирано чрез скрипт и състоянието да бъде обозначено визуално.

Състоянието важи за елемента и всички негови потомци, които могат да получат фокус, затова не го прилагайте безразборно към контейнери. Използвайте го само там, където правилата на HTML и ролята на елемента го позволяват. ARIA 1.2 обявява за остаряло използването му като глобално състояние, а не самия атрибут.

В примера нативният бутон запазва поддръжката на клавиатурата, но общият обработчик click прекратява изпълнението, преди да извърши действието. CSS само показва, че бутонът е недостъпен; не налага това поведение.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-disabled demo</title>
<style>
  button[aria-disabled="true"] { opacity: 0.6; }
</style>
<button type="button" id="save" aria-disabled="true">Save (unavailable)</button>
<p id="result">Actions: 0</p>
<script>
  const save = document.getElementById('save');
  const result = document.getElementById('result');
  let actions = 0;

  save.addEventListener('click', () => {
    if (save.getAttribute('aria-disabled') === 'true') return;
    actions += 1;
    result.textContent = `Actions: ${actions}`;
  });

  save.click();
  console.log(result.textContent);
</script>
</html>

Резултат

Actions: 0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници