Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

aria-disabled — stav zakázaného ovládacieho prvku

aria-disabled informuje asistenčné technológie, že prvok je vnímateľný, ale nie je dostupný na použitie. Samotný atribút nebráni akciám ani neodstraňuje prvok z poradia fokusu; toto správanie musí zabezpečiť autor.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

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

aria-disabled="true" označuje prvok ako zakázaný, no stále vnímateľný. aria-disabled="false" je predvolená hodnota tohto stavu; neprepisuje však natívny disabled. Nejde o booleovský atribút HTML: výslovne uveďte "true" alebo "false" a nespoliehajte sa iba na prítomnosť atribútu.

Na rozdiel od natívneho disabled samotné aria-disabled nebráni aktivácii, nemení poradie fokusu ani nezabezpečuje vzhľad zakázaného prvku. Ak natívny disabled spĺňa požiadavky, uprednostnite ho. Ak má nedostupné tlačidlo zostať dosiahnuteľné klávesom Tab, použitie aria-disabled vyžaduje aj potlačenie jeho akcie v skripte a vizuálne označenie stavu.

Tento stav sa vzťahuje na prvok aj na všetkých jeho potomkov, ktorí môžu získať fokus, preto ho bez rozmyslu nenastavujte celým kontajnerom. Používajte ho iba tam, kde to povoľujú pravidlá HTML a rola prvku. ARIA 1.2 označuje za zastarané jeho použitie ako globálneho stavu, nie samotný atribút.

V príklade si natívne tlačidlo zachováva podporu klávesnice, no spoločný obslužný program click sa skončí pred vykonaním akcie. CSS iba signalizuje nedostupnosť; nevynucuje ju.

Príklady

<!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>

Výsledok

Actions: 0

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje