Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Regioni live ARIA: status, alert, aria-live e aria-atomic

Le regioni live ARIA comunicano gli aggiornamenti alle tecnologie assistive senza spostare il focus. Scegli la priorità dell’annuncio e quanto contesto includere.

Versione: Current web platform; runtime support varies

Sintassi

// 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;

Una regione live ARIA consente alle tecnologie assistive, come un lettore di schermo, di annunciare modifiche al contenuto senza spostare il focus. Ruoli e attributi appartengono alla piattaforma web, non a ECMAScript. JavaScript aggiorna il DOM, ad esempio con textContent per un messaggio di solo testo.

Usa role="status" per informazioni non urgenti, come il numero di risultati. Implica aria-live="polite" e aria-atomic="true". Il ruolo role="alert" implica aria-live="assertive" e aria-atomic="true". Usalo con moderazione, solo per messaggi urgenti che non richiedono una risposta. Non aggiungere aria-live="assertive" a un avviso: in alcune configurazioni, la ridondanza può farlo annunciare due volte.

aria-live stabilisce la priorità: polite attende una pausa adatta, assertive può interrompere l’annuncio in corso e off non richiede annunci quando il focus è fuori dalla regione. Con il focus al suo interno, le modifiche possono comunque essere annunciate. aria-atomic stabilisce l’estensione, non la priorità: true richiede l’intero contenuto della regione e false solo i nodi modificati. Il valore predefinito generale è false, ma entrambi i ruoli descritti implicano true.

Inserisci una regione vuota nel DOM prima di aggiornarne il contenuto, preferibilmente già nell’HTML iniziale. Non spostarvi il focus solo per annunciare una modifica. Alcune configurazioni annunciano anche un avviso inserito con il testo già presente, ma non farci affidamento. Verifica le combinazioni di browser e tecnologie assistive che supporti.

Esempi

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

Risultato

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.

Salva l’esempio come file HTML e aprilo in un browser. Attiva «Add result» due volte, poi «Simulate connection loss». Alla seconda attivazione cambia solo il numero, ma `status` richiede l’annuncio dell’intero messaggio. Il risultato è testo visibile, non una lettura garantita.

Lezioni correlate

  • JavaScript · Lezione 23 · Intermedio · Versione: 3

Fonti