Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

aria-disabled — état désactivé d’un contrôle

aria-disabled indique aux technologies d’assistance qu’un élément est perceptible, mais qu’il n’est pas disponible pour être utilisé. L’attribut seul ne bloque pas les actions et ne retire pas l’élément de l’ordre de tabulation ; l’auteur doit mettre ce comportement en œuvre.

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

Syntaxe

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

aria-disabled="true" indique qu’un élément est désactivé, tout en restant perceptible. aria-disabled="false" est la valeur par défaut de cet état ; il ne remplace toutefois pas disabled natif. Ce n’est pas un attribut booléen HTML : indiquez explicitement "true" ou "false", au lieu de vous fier à la seule présence de l’attribut.

Contrairement à disabled natif, aria-disabled seul n’empêche pas l’activation, ne modifie pas l’ordre de tabulation et ne fournit pas de style désactivé. Préférez disabled natif lorsqu’il répond aux exigences. Si un bouton indisponible doit rester accessible avec Tab, l’utilisation de aria-disabled exige aussi de neutraliser son action dans un script et de signaler visuellement son état.

L’état s’applique à l’élément et à tous ses descendants pouvant recevoir le focus ; ne l’appliquez donc pas sans discernement à des conteneurs. Utilisez-le uniquement lorsque les règles HTML et le rôle de l’élément le permettent. ARIA 1.2 déprécie son utilisation comme état global, pas l’attribut lui-même.

Dans l’exemple, le bouton natif conserve la prise en charge du clavier, mais le gestionnaire click partagé s’interrompt avant d’effectuer l’action. CSS signale seulement l’indisponibilité ; il ne la fait pas respecter.

Exemples

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

Résultat

Actions: 0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources