WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

aria-disabled — Deaktivierungsstatus eines Bedienelements

aria-disabled informiert assistive Technologien darüber, dass ein Element wahrnehmbar, aber nicht bedienbar ist. Das Attribut allein verhindert keine Aktionen und entfernt das Element nicht aus der Fokusreihenfolge; dieses Verhalten muss die Autorin oder der Autor selbst umsetzen.

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

Syntax

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

aria-disabled="true" kennzeichnet ein Element als deaktiviert, aber weiterhin wahrnehmbar. aria-disabled="false" ist der Standardwert für diesen Zustand; es setzt das native disabled jedoch nicht außer Kraft. Dies ist kein boolesches HTML-Attribut: Gib ausdrücklich "true" oder "false" an, statt dich auf das bloße Vorhandensein des Attributs zu verlassen.

Anders als natives disabled verhindert aria-disabled allein weder die Aktivierung noch ändert es die Fokusreihenfolge oder sorgt für eine deaktivierte Darstellung. Bevorzuge natives disabled, wenn es die Anforderungen erfüllt. Soll eine nicht verfügbare Schaltfläche mit der Tabulatortaste erreichbar bleiben, muss bei der Verwendung von aria-disabled außerdem die Aktion per Skript unterdrückt und der Zustand visuell angezeigt werden.

Der Zustand gilt für das Element und alle fokussierbaren Nachfahren. Wende ihn daher nicht unbedacht auf ganze Container an. Verwende ihn nur dort, wo die HTML-Regeln und die Rolle des Elements es zulassen. ARIA 1.2 erklärt die Verwendung als globalen Zustand für veraltet, nicht aber das Attribut selbst.

Im Beispiel behält die native Schaltfläche ihre Tastaturbedienbarkeit, aber der gemeinsame click-Handler kehrt zurück, bevor die Aktion ausgeführt wird. CSS zeigt lediglich die Nichtverfügbarkeit an; es setzt sie nicht durch.

Beispiele

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

Ergebnis

Actions: 0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen