CKTIS / HTML
aria-disabled — stanje onemogućene kontrole
aria-disabled obavještava pomoćne tehnologije da je element zamjetljiv, ali nije dostupan za korištenje. Sam atribut ne sprječava radnje niti uklanja element iz redoslijeda fokusa; autor mora implementirati takvo ponašanje.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
aria-disabled="true" | aria-disabled="false"aria-disabled="true" označava element kao onemogućen, ali i dalje zamjetljiv. aria-disabled="false" zadana je vrijednost tog stanja, no ne nadjačava izvorni disabled. To nije Booleov HTML atribut: izričito navedite "true" ili "false" umjesto da se oslanjate samo na prisutnost atributa.
Za razliku od izvornog disabled, sam aria-disabled ne sprječava aktivaciju, ne mijenja redoslijed fokusa niti osigurava izgled onemogućene kontrole. Prednost dajte izvornom disabled kada ispunjava zahtjeve. Ako nedostupan gumb mora ostati dostupan tipkom Tab, upotreba aria-disabled zahtijeva i blokiranje njegove radnje u skripti te vizualno označavanje stanja.
Stanje se odnosi na element i sve njegove potomke koji mogu primiti fokus, stoga ga nemojte bez razmišljanja primjenjivati na spremnike. Upotrebljavajte ga samo ondje gdje to dopuštaju HTML pravila i uloga elementa. ARIA 1.2 zastarjelim smatra njegovu upotrebu kao globalnog stanja, a ne sam atribut.
U primjeru izvorni gumb zadržava podršku za tipkovnicu, ali zajednički rukovatelj click završava prije izvršavanja radnje. CSS samo označava nedostupnost; ne provodi je.
Primjeri
<!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>Rezultat
Actions: 0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.