Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła