WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ARIA-Live-Regionen: status, alert, aria-live und aria-atomic

ARIA-Live-Regionen machen Inhaltsänderungen für assistive Technologien zugänglich, ohne den Fokus zu verschieben. Lege Priorität und Umfang der Ansage fest.

Version: Current web platform; runtime support varies

Syntax

// Live-region roles and attributes are defined by WAI-ARIA 1.2.
role="status"  (implicit aria-live="polite", aria-atomic="true")
role="alert"   (implicit aria-live="assertive", aria-atomic="true")
aria-live="off" | "polite" | "assertive"
aria-atomic="false" | "true"

// DOM update: change the text of a node in an existing live region.
messageNode.textContent = message;

Eine ARIA-Live-Region ermöglicht es assistiven Technologien wie Screenreadern, Inhaltsänderungen anzusagen, ohne den Fokus zu verschieben. Die Rollen und Attribute gehören zur Webplattform, nicht zu ECMAScript. JavaScript aktualisiert das DOM, bei reinem Text etwa mit textContent.

Verwende role="status" für nicht dringende Informationen wie die Anzahl der Ergebnisse. Die Rolle beinhaltet implizit aria-live="polite" und aria-atomic="true". Für role="alert" gelten implizit aria-live="assertive" und aria-atomic="true". Setze diese Rolle sparsam ein, nur für dringende Meldungen, die keine Antwort erfordern. Ergänze kein überflüssiges aria-live="assertive": Manche Kombinationen können die Meldung doppelt ansagen.

aria-live bestimmt die Priorität: polite wartet auf eine geeignete Pause, assertive kann die laufende Ansage unterbrechen, und off fordert keine Ansage an, solange der Fokus außerhalb der Region liegt. Innerhalb der Region können Änderungen weiterhin angesagt werden. aria-atomic bestimmt den Umfang, nicht die Priorität: true fordert den gesamten Inhalt an, false nur die geänderten Knoten. Allgemein gilt false als Standard, bei beiden genannten Rollen jedoch implizit true.

Füge die leere Region vor der Inhaltsänderung ins DOM ein, am besten schon im anfänglichen HTML. Verschiebe den Fokus nicht allein für eine Ansage dorthin. Manche Kombinationen sagen auch einen bereits mit Text eingefügten Alert an; verlasse dich nicht darauf. Teste mit den unterstützten Kombinationen aus Browser und assistiver Technologie.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ARIA live regions</title>
</head>
<body>
  <button type="button" id="add-result">Add result</button>
  <button type="button" id="simulate-failure">Simulate connection loss</button>
  <p id="result-status" role="status"></p>
  <p id="connection-alert" role="alert"></p>

  <script>
    const statusRegion = document.getElementById('result-status');
    const alertRegion = document.getElementById('connection-alert');
    const count = document.createElement('span');
    let total = 0;

    document.getElementById('add-result').addEventListener('click', () => {
      if (total === 0) statusRegion.append('Results: ', count);
      total += 1;
      count.textContent = String(total);
    });

    document.getElementById('simulate-failure').addEventListener('click', () => {
      alertRegion.textContent = 'Connection lost. Changes cannot be saved.';
    });
  </script>
</body>
</html>

Ergebnis

Initially both regions are empty.
After the first activation of Add result: Results: 1
After the second activation of Add result: Results: 2
After activating Simulate connection loss: Connection lost. Changes cannot be saved.
These are visible text updates, not a screen reader transcript.

Speichere das Beispiel als HTML-Datei und öffne sie im Browser. Aktiviere „Add result“ zweimal und danach „Simulate connection loss“. Beim zweiten Mal ändert sich nur die Zahl, aber `status` fordert die vollständige Meldung an. Die Ausgabe ist sichtbarer Seitentext und keine garantierte Ansage.

Zugehörige Lektionen

  • JavaScript · Lektion 23 · Mittlere Stufe · Version: 3

Quellen