Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

aria-disabled — stanje onemogočenega kontrolnika

aria-disabled podpornim tehnologijam sporoča, da je element zaznaven, vendar ni na voljo za uporabo. Atribut sam ne prepreči dejanj in elementa ne odstrani iz vrstnega reda fokusa; to vedenje mora zagotoviti avtor.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

aria-disabled="true" označuje element kot onemogočen, vendar še vedno zaznaven. aria-disabled="false" je privzeta vrednost tega stanja, vendar ne preglasi izvornega disabled. To ni logični atribut HTML: izrecno navedite "true" ali "false" in se ne zanašajte zgolj na prisotnost atributa.

V nasprotju z izvornim disabled atribut aria-disabled sam ne prepreči aktivacije, ne spremeni vrstnega reda fokusa in ne zagotovi videza onemogočenega elementa. Če izvorni disabled ustreza zahtevam, mu dajte prednost. Če mora biti nedostopen gumb še vedno dosegljiv s tipko Tab, uporaba aria-disabled zahteva tudi, da s skriptom preprečite njegovo dejanje in stanje vizualno označite.

Stanje velja za element in vse njegove potomce, ki lahko prejmejo fokus, zato ga ne uporabljajte nepremišljeno za vsebnike. Uporabljajte ga samo tam, kjer to dovoljujejo pravila HTML in vloga elementa. ARIA 1.2 kot zastarelo označuje njegovo uporabo kot globalnega stanja, ne pa samega atributa.

V primeru gumb ohrani izvorno podporo za tipkovnico, vendar se skupni upravljalnik click konča, preden izvede dejanje. CSS zgolj nakaže nedostopnost; ne uveljavi je.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri