CKTIS / HTML
aria-disabled — stav zakázaného ovládacího prvku
aria-disabled informuje asistivní technologie, že je prvek vnímatelný, ale není dostupný k použití. Samotný atribut nebrání akcím ani neodebírá prvek z pořadí fokusu; toto chování musí zajistit autor.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
aria-disabled="true" | aria-disabled="false"aria-disabled="true" označuje prvek jako zakázaný, ale stále vnímatelný. aria-disabled="false" je výchozí hodnota tohoto stavu; nepřepisuje však nativní disabled. Nejde o booleovský atribut HTML: výslovně uveďte "true" nebo "false" a nespoléhejte se pouze na přítomnost atributu.
Na rozdíl od nativního disabled samotné aria-disabled nebrání aktivaci, nemění pořadí fokusu ani nezajišťuje vzhled zakázaného prvku. Pokud nativní disabled splňuje požadavky, dejte mu přednost. Má-li nedostupné tlačítko zůstat dosažitelné klávesou Tab, použití aria-disabled vyžaduje také potlačit jeho akci ve skriptu a stav vizuálně označit.
Tento stav se vztahuje na prvek i na všechny jeho potomky, kteří mohou získat fokus, proto jej bez rozmyslu nenastavujte celým kontejnerům. Používejte jej pouze tam, kde to dovolují pravidla HTML a role prvku. ARIA 1.2 označuje za zastaralé jeho použití jako globálního stavu, nikoli samotný atribut.
V příkladu si nativní tlačítko zachovává podporu klávesnice, ale společný obslužný program click se ukončí před provedením akce. CSS pouze signalizuje nedostupnost; nevynucuje ji.
Pří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ýsledek
Actions: 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.