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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.