WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Barrierefreie Interaktionen in JavaScript

Eine barrierefreie Interaktion verbindet Tastaturbedienung, vorhersehbaren Fokus und einen für assistive Technologien verständlichen Zustand. JavaScript sollte Sichtbarkeit und ARIA synchronisieren und Änderungen mitteilen, ohne den Fokus unnötig zu verschieben.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;

Eine barrierefreie Interaktion ermöglicht es, eine Oberfläche ohne Maus zu bedienen und ihre Änderungen mithilfe assistiver Technologien zu verstehen. Beginne mit nativen Schaltflächen: Sie bieten Semantik und Tastaturaktivierung. ARIA beschreibt die Oberfläche, fügt aber selbst kein Verhalten hinzu. Die ECMAScript-Spezifikation beschreibt die Sprache und grenzt sie von ihrer Host-Umgebung ab; die bereitgestellte Quelle definiert weder DOM noch HTML oder ARIA.

Verwaltung des ARIA-Zustands und des Tastaturfokus bedeutet, Zustand, Sichtbarkeit und Fokus miteinander zu synchronisieren. Im Beispiel entspricht aria-expanded dem umgekehrten Wert von panel.hidden, während aria-controls auf panel verweist. Beim Test des Öffnens liegt der Fokus bereits auf der Schaltfläche Details und bleibt dort; das Panel ist kein modaler Dialog. Der Event-Handler von Close details setzt den Fokus auf Details, bevor er das Panel ausblendet. Wird das Panel über Details geschlossen und liegt der Fokus noch innerhalb des Panels, setzt setExpanded den Fokus vor dem Ausblenden auf Details. Der Konsolentest deckt beide Wege zum Schließen ab, auch die Aktivierung von Details, ohne den Fokus vorher auf diese Schaltfläche zu setzen. Entferne nicht die sichtbare Fokusmarkierung und verwende keine positiven tabindex-Werte, um die Navigationsreihenfolge zu korrigieren.

Ansagen aus ARIA-Live-Regionen teilen Änderungen mit, ohne den Fokus zu verschieben. Das Beispiel aktualisiert textContent in einer bestehenden Region mit role="status". Diese Rolle bewirkt implizit das Verhalten von aria-live="polite"; im Markup ist kein aria-live-Attribut gesetzt. Das Attribut aria-atomic="true" gibt an, dass der gesamte Inhalt der Region als Nachricht behandelt werden soll. Die Region ist vor der Aktualisierung vorhanden. Verwende sie nicht anstelle von Beschriftungen für Bedienelemente und kündige nicht jede kleine Änderung an. Der genaue Wortlaut und Zeitpunkt der Ansage hängen vom Browser und der assistiven Technologie ab.

Speichere das Beispiel als HTML-Datei und prüfe die Tastaturbedienung, Attributwerte und Ansagen des Screenreaders. Die erwartete Ausgabe beschreibt den DOM-Zustand und die Position des Fokus, nicht eine garantierte Sprachausgabe. Das Beispiel wurde in einer isolierten Chromium-Umgebung ausgeführt, und die Konsolenausgabe stimmte genau mit der erwarteten Ausgabe überein. Es verwendet ECMAScript-2015-Syntax und Browser-Schnittstellen; die Unterstützung in der Zielumgebung muss separat geprüft werden. Node 24 im Repository belegt nicht, dass diese Schnittstellen unterstützt werden.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Accessible disclosure</title>
</head>
<body>
  <button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
  <section id="panel" aria-label="Details" hidden>
    <p>Additional information.</p>
    <button id="close" type="button">Close details</button>
  </section>
  <p id="status" role="status" aria-atomic="true"></p>
  <script>
    const toggle = document.getElementById('toggle');
    const panel = document.getElementById('panel');
    const closeButton = document.getElementById('close');
    const statusMessage = document.getElementById('status');

    function setExpanded(expanded) {
      if (!expanded && panel.contains(document.activeElement)) {
        toggle.focus();
      }
      panel.hidden = !expanded;
      toggle.setAttribute('aria-expanded', String(expanded));
      statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
    }

    toggle.addEventListener('click', () => setExpanded(panel.hidden));
    closeButton.addEventListener('click', () => {
      toggle.focus();
      setExpanded(false);
    });

    function report(step) {
      console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
    }

    report('Initial');
    toggle.focus();
    toggle.click();
    report('Open');
    console.log('Open kept focus on Details: ' + (document.activeElement === toggle));

    // Test closing when activation does not first focus the close button.
    toggle.blur();
    console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
    closeButton.click();
    report('Close');
    console.log('Focus returned to Details: ' + (document.activeElement === toggle));

    // Test closing with Details while focus remains inside the panel.
    toggle.click();
    closeButton.focus();
    console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
    toggle.click();
    report('Close with Details');
    console.log('Focus returned to Details: ' + (document.activeElement === toggle));
  </script>
</body>
</html>

Ergebnis

Initial: hidden=true; aria-expanded=false; status=""
Open: hidden=false; aria-expanded=true; status="Details opened."
Open kept focus on Details: true
Focus inside panel before close: false
Close: hidden=true; aria-expanded=false; status="Details closed."
Focus returned to Details: true
Focus inside panel before closing with Details: true
Close with Details: hidden=true; aria-expanded=false; status="Details closed."
Focus returned to Details: true

Der Test aktiviert `Details` programmgesteuert, während der Fokus auf `Close details` liegt. Der Fokus sollte zu `Details` zurückkehren, bevor das Panel ausgeblendet wird.

Quellen