Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori