Per gli errori dei form, di norma basta aria-live="polite"; role="alert" va riservato agli avvisi che richiedono attenzione immediata. Un invio bloccato, da solo, non giustifica un’interruzione dello screen reader.
Il confronto dipende da urgenza, frequenza degli aggiornamenti e rischio di interrompere la lettura:
| Criterio | aria-live |
role="alert" |
|---|---|---|
| Annuncio |
polite attende una pausa; assertive richiede un’interruzione |
Implicitamente assertivo e atomico: prevede la lettura dell’intero messaggio |
| Uso | Errori nei campi, controlli in background, salvataggi non urgenti | Errori che richiedono un intervento immediato |
| Contenitore | Nodo stabile, presente prima dell’aggiornamento | Stessa precauzione; evitare di aggiungere aria-live="assertive" per il rischio di annunci doppi |
L’annuncio è solo una parte della gestione dell’errore. In entrambi i casi occorre:
- Mostrare un testo che indichi il problema e come correggerlo, come richiesto dalla WCAG 3.3.1.
- Collegarlo al campo con
aria-describedbye impostarearia-invalid="true". - Dopo l’invio fallito, portare il focus al primo campo errato o a un riepilogo con link, senza spostarlo durante la digitazione.
- Conservare i dati consentiti e verificare invio, correzione e nuovo invio con tastiera e screen reader, su desktop e mobile.
La scelta funziona quando l’utente può capire l’errore, raggiungere il campo e correggerlo, senza annunci ripetuti o perdita del contesto.
ARIA live o alert: come scegliere per gli errori dei form
Come funzionano aria-live e role="alert"
Conta come viene annunciato l’errore, non solo di quale errore si tratta.
aria-live: impostare la priorità dell’annuncio
Usa aria-live per decidere quando un messaggio di errore entra nella coda di lettura dello screen reader. Con off, gli aggiornamenti non vengono annunciati finché il focus si trova altrove.
Mantieni stabile il nodo della live region: non ricrearlo a ogni validazione. Imposta aria-atomic="true" per far leggere l’intero messaggio, anziché soltanto la parte modificata. Valida solo quando l’utente esce dal campo (blur), invia il modulo (submit) o si verifica un effettivo cambio di stato.
Oltre alla priorità dell’annuncio, conta la semantica del contenitore.
role="alert": annunciare gli errori urgenti
role="alert" equivale a un annuncio assertivo e completo. Applicalo al contenitore del messaggio, non all’input, all’intero modulo o a un gruppo di pulsanti.
L’annuncio non collega il messaggio al campo e non sposta il focus. Riserva questo ruolo agli errori che richiedono attenzione immediata: un errore che blocca l’invio non è necessariamente urgente.
Collegare gli errori ai campi e gestire il focus
Annunciare l’errore non basta: il campo deve anche restare raggiungibile.
Collega il testo visibile dell’errore al campo con aria-describedby. Se sono già presenti gli ID delle istruzioni, conservali e separa gli ID con spazi. Imposta aria-invalid="true" sul campo errato; dopo la correzione, rimuovi l’attributo oppure impostalo a false.
Per un modulo lungo, assegna tabindex="-1" al riepilogo degli errori. Potrai così spostarvi il focus tramite codice senza aggiungere una tappa alla sequenza del tasto Tab. I link ai campi devono restare raggiungibili da tastiera. Evita annunci duplicati tra focus, descrizione e live region.
In alternativa, aria-errormessage identifica nello specifico il testo dell’errore. Usalo insieme a aria-invalid="true", dopo aver verificato il supporto nei browser e negli screen reader previsti, sia per i moduli brevi sia per i flussi complessi.
sbb-itb-bc3fb49
aria-live vs role="alert": come scegliere
La scelta dipende da urgenza, frequenza degli aggiornamenti e rischio di interrompere la lettura.
| Criterio | aria-live |
role="alert" |
|---|---|---|
| Scopo e semantica | Segnala aggiornamenti, ma non identifica di per sé un errore. | Identifica un avviso importante, generalmente urgente. |
| Comportamento dell’annuncio | Con polite attende una pausa; con assertive richiede un’interruzione. |
È implicitamente assertivo e prevede la lettura dell’intero messaggio. |
| Quando interrompere | Un invio fallito non richiede sempre un’interruzione: preferisci polite. |
Usalo solo se l’errore non può attendere. |
| Preparazione del DOM | Usa un contenitore già presente nel DOM, anziché crearlo quando compare l’errore. | Segui la stessa precauzione; se inserisci un alert già popolato, verifica che venga annunciato. |
| Eventi adatti | Con polite: validazione su blur, controllo asincrono in background, esito non urgente di un invio o salvataggio. |
Errore bloccante che richiede attenzione immediata. |
Adeguare la priorità all’urgenza
Scegli polite quando l’errore non richiede un’interruzione immediata. Riserva assertive ai casi in cui interrompere è necessario.
Non combinare role="alert" con aria-live="assertive": con VoiceOver su iOS può causare annunci doppi.
Nei form di contatto, nei checkout e nel salvataggio automatico, scegliere la priorità giusta cambia l’esperienza d’uso.
Pianificare gli aggiornamenti del DOM e la lettura atomica
Prepara un contenitore vuoto nel DOM, poi inserisci il messaggio. Aggiungere un alert già popolato non produce sempre lo stesso annuncio.
Con una regione atomica, evita di modificare piccoli frammenti di un lungo riepilogo: ogni modifica può far rileggere l’intero contenuto.
Verificare le differenze tra browser e screen reader
Prova le combinazioni usate dal tuo pubblico: Chrome con NVDA o JAWS su Windows, Safari con VoiceOver su macOS e iOS.
Verifica cosa succede al primo invio non valido, quando l’invio viene ripetuto e dopo la correzione. Controlla il messaggio annunciato, l’ordine di lettura, le interruzioni e le ripetizioni: il comportamento può cambiare anche in base alle impostazioni dell’utente, soprattutto nei moduli con validazioni frequenti o aggiornamenti in tempo reale.
Errori tipici per siti vetrina, e-commerce e SaaS
La scelta tra polite e alert dipende da quanto l’errore blocca l’utente e da quanto è urgente intervenire. Nei flussi più comuni, i casi da distinguere sono tre: un campo da correggere, un pagamento bloccato e un salvataggio fallito.
| Contesto aziendale | Evento di validazione | Annuncio e feedback | Focus e correzione da tastiera | Rischio principale |
|---|---|---|---|---|
| Modulo preventivi | Invio con email non valida e messaggio vuoto | Riepilogo visibile con aria-live="polite" ed errori accanto ai campi |
Link “Vai a: Email” e “Vai a: Messaggio” che spostano il focus sui controlli | Annunci ripetuti degli stessi errori |
| Checkout | CAP incompleto | Errore visibile “CAP: inserisci 5 cifre”, associato al campo, e riepilogo non urgente | Link al campo CAP, modificabile da tastiera | Perdita dei dati già inseriti |
| Pagamento rifiutato | Rifiuto del pagamento che richiede attenzione immediata |
role="alert" con messaggio visibile e istruzioni per proseguire |
Focus nel contesto del pagamento e pulsanti accessibili per riprovare o cambiare metodo | Esito non annunciato o istruzioni poco chiare |
| Gestionale SaaS | Salvataggio automatico non riuscito | Feedback visibile con aria-live="polite"; alert solo se occorre intervenire subito per evitare di perdere il lavoro |
Pulsante “Riprova” e percorso da tastiera verso il campo interessato | Credere che le modifiche siano state salvate |
Siti vetrina: errori nei moduli di contatto e preventivo
Se basta correggere un campo, usa aria-live="polite". Dopo l’invio fallito, sposta il focus solo sul riepilogo o sul primo campo errato. Conserva i valori già inseriti, imposta aria-invalid="true" e associa ogni messaggio di errore al campo con aria-describedby.
E-commerce: errori nel checkout e nel pagamento
Nel checkout, riserva role="alert" ai pagamenti rifiutati che richiedono attenzione immediata: non usarlo per ogni errore di compilazione. Mantieni il focus nel punto del problema e conserva il carrello e i dati validi. Per i dati di pagamento, fallo solo dove le regole di sicurezza lo consentono.
SaaS: validazione in background ed errori di salvataggio
Se il salvataggio automatico fallisce, mostra un messaggio persistente e il pulsante “Riprova”. Mantieni stabile il nodo del feedback e usa aria-live="polite". Passa all’alert solo quando serve un intervento urgente per evitare la perdita del lavoro.
Problemi comuni di implementazione
Quando un annuncio manca o non viene letto correttamente, il problema è quasi sempre nel nodo della live region o nel collegamento con il campo. L’utente deve poter ascoltare il messaggio e capire dove intervenire.
Annunci mancanti o ripetuti
Se l’annuncio non parte, inserisci la live region vuota nel markup iniziale. Aggiungi il messaggio solo dopo la validazione.
Un messaggio che non cambia potrebbe non essere riletto. Reinserirlo a ogni controllo, però, può causare ripetizioni. Confronta il nuovo testo con quello già presente e aggiorna la regione solo quando serve.
Evita più regioni assertive attive nello stesso momento: possono duplicare gli annunci o interrompere la lettura. Nei framework, cambia il contenuto senza ricreare il nodo della live region. Il contenitore deve restare stabile.
Errori che l’utente non riesce a trovare o correggere
Se l’annuncio viene letto ma l’utente non trova il campo, controlla il collegamento tra il messaggio e il controllo.
Ascoltare l’errore non basta: bisogna poter raggiungere il campo da correggere. Verifica che gli identificativi siano univoci e che i riferimenti di aria-describedby puntino ai messaggi di errore corretti.
Un riepilogo senza link ai campi non permette di raggiungere direttamente il punto da correggere. I link devono portare ai controlli, non soltanto al testo degli errori.
Non spostare il focus durante la digitazione ed evita di annunciare ogni errore in tempo reale: troppe letture possono coprire le istruzioni utili. Mantieni il messaggio visibile finché il campo non è corretto.
Checklist di test e racandazioni
Testare invio, correzione e nuovo invio
Dopo aver scelto tra aria-live e role="alert", verifica come si comporta il modulo nell’uso effettivo. Prova l’intero percorso, controllando annuncio, focus e recupero dell’errore: invia il modulo vuoto, correggi un campo alla volta e invialo di nuovo. Ripeti l’invio anche senza cambiare nulla.
Testa gli errori lato client e lato server, inclusi ritardi, timeout e richieste fallite. Gli errori risolti non devono più essere annunciati; un invio riuscito deve invece produrre una conferma.
Testa tutto il flusso di validazione, non solo il singolo errore. Usa la tastiera e prova le combinazioni usate dal tuo pubblico, confrontando gli annunci con polite e assertive:
Ad esempio, Chrome con NVDA, Safari con VoiceOver e Chrome su Android con TalkBack.
Controlla tempi, interruzioni, annunci duplicati, descrizioni, link del riepilogo e ordine del focus.
Per ogni prova, registra data, dispositivo, sistema operativo, browser e screen reader con le rispettive versioni, oltre all’annuncio atteso e a quello rilevato. Il risultato vale solo per la combinazione testata: ripeti le prove dopo ogni modifica alla validazione o alla struttura del DOM.
Preferire annunci polite, salvo necessità di interrompere
Controlla che i feedback non urgenti restino polite e che gli alert interrompano solo quando previsto. Un errore che blocca l’invio non è per forza urgente. Registra la priorità scelta e verifica che l’aggiornamento venga annunciato tramite un contenitore stabile, già presente nel DOM.
La priorità comunica l’urgenza, non risolve il problema. Il test è superato se l’utente riesce a capire l’errore, raggiungerlo, correggerlo e reinviare senza perdere il contesto. Entrambe le tecniche richiedono messaggi visibili, associazioni ai campi e gestione del focus. Conferma la priorità scelta con le prove, non soltanto nel markup.
FAQs
Come gestisco più errori senza sovrapporre gli annunci?
Per gestire più errori senza sovrapporre gli annunci, collega ogni messaggio al relativo campo con aria-describedby, invece di usare un unico contenitore generico.
Posiziona il messaggio accanto al campo e accompagnalo sempre con icone visive. Imposta anche aria-invalid="true" sul campo, così lo screen reader può segnalarne lo stato non valido.
La validazione nativa sostituisce le live region?
No. Anche se il browser mostra l’errore nel modulo, la validazione nativa non garantisce che le tecnologie assistive lo annuncino subito e in modo chiaro.
Per i messaggi dinamici di stato o errore, è quindi consigliato collegare il messaggio al campo tramite aria-describedby. In caso di errore, imposta anche aria-invalid="true" sul campo e usa role="alert" sul messaggio per richiederne l’annuncio immediato allo screen reader.
Come segnalo un errore identico dopo un nuovo invio?
Collega il messaggio di errore al campo tramite aria-describedby, imposta aria-invalid="true" sul campo e applica role="alert" al contenitore del messaggio.
Perché lo screen reader annunci di nuovo l’errore a ogni invio del modulo, aggiorna il DOM in modo che la tecnologia assistiva rilevi una modifica, anche quando il testo del messaggio non cambia.