CKTIS / HTML
aria-disabled — stan niedostępności kontrolki
aria-disabled informuje technologie asystujące, że element jest postrzegalny, ale niedostępny do obsługi. Sam atrybut nie blokuje działania ani nie usuwa elementu z kolejności fokusu; zachowanie musi zapewnić autor.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
aria-disabled="true" | aria-disabled="false"aria-disabled="true" oznacza element wyłączony z obsługi, lecz nadal postrzegalny. aria-disabled="false" jest wartością domyślną tego stanu; nie znosi jednak natywnego disabled. To nie jest atrybut logiczny HTML: podawaj jawnie "true" albo "false", zamiast polegać na samej obecności atrybutu.
W przeciwieństwie do natywnego disabled, aria-disabled samo nie blokuje aktywacji, nie zmienia kolejności fokusu ani nie zapewnia wyglądu kontrolki. Preferuj natywne disabled, gdy odpowiada wymaganiom. Jeśli niedostępny przycisk ma pozostać osiągalny klawiszem Tab, zastosowanie aria-disabled wymaga także zablokowania działania w skrypcie i wizualnego oznaczenia stanu.
Stan dotyczy elementu i wszystkich jego potomków mogących otrzymać fokus, więc nie oznaczaj nim bezrefleksyjnie całych kontenerów. Stosuj go tylko tam, gdzie pozwalają na to reguły HTML i rola elementu. W ARIA 1.2 wycofywane jest jego użycie jako stanu globalnego, a nie sam atrybut.
W przykładzie natywny przycisk zachowuje obsługę klawiatury, ale wspólna procedura click kończy się przed wykonaniem działania. CSS jedynie sygnalizuje niedostępność; nie odpowiada za blokowanie.
Przykłady
<!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>Wynik
Actions: 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.