Guide pratiche

Scrivi errori di modulo che aiutino le persone a recuperare

Un errore aiuta solo quando qualcuno sa cosa fallisce e può riprendere senza inserire di nuovo tutto.

vedere il metodo

Illustrazione — Scrivi errori di modulo che aiutino le persone a recuperare
Illustrazione generata dall’IA

Descrivi la correzione attesa

Collega ogni messaggio al suo campo e spiega le informazioni richieste. "L'indirizzo email è incompleto" aiuta più di un codice tecnico. Non incolpare l'utente per un'interruzione del server o un servizio non disponibile.

Spiegare le regole prima dell'ingresso, ove possibile: formato, lunghezza, file accettati e informazioni facoltative. Le Guida al modulo di contatto Aiuta a ridurre i campi e chiarire le aspettative.

Il momento del controllo fa parte del messaggio. Un campo obbligatorio vuoto all’apertura non va annunciato come errato prima di un tentativo d’invio. Durante la scrittura di un indirizzo, un valore provvisorio come alex@ non richiede necessariamente un avviso a ogni tasto. Secondo il bisogno, controlli all’uscita dal campo o dopo l’invio; un riscontro immediato può essere utile per verificare disponibilità a distanza.

aria-invalid indica che un valore non ha superato la validazione; non definisce le regole né blocca da solo l’invio. Colleghi lo stato a un messaggio di correzione e lo rivaluti dopo la modifica. Un formato email accettato non prova la raggiungibilità. Verifica in attesa e servizio indisponibile richiedono messaggi propri.

  • campo e problema identificabile.
  • Correction action explicit.
  • vincoli spiegati all'inizio.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Esercizio fittizio: scegliere quando annunciare un errore
Momento osservatoRiscontro adatto al casoControllo da eseguire
Prima apertura, campo obbligatorio vuotoEtichetta, obbligatorietà e aiutoNessun aria-invalid="true" prematuro
Indirizzo ancora in scritturaLasciare terminare secondo la strategia sceltaEvitare avvisi ripetuti per uno stato provvisorio
Invio tentato con valore rifiutatoErrore esplicito associato al campoaria-invalid, messaggio accessibile e correzione possibile

rendere percepibile il feedback

Dopo l'invio, mostra un riepilogo vicino all'inizio e un messaggio accanto a ciascun campo interessato. Sposta la messa a fuoco in modo prevedibile e collega ogni campo al suo errore per la tecnologia assistiva. Il colore da solo è insufficiente.

Le Tutorial di notifica del W3C Fornisce esempi di feedback locale e generale. Prova la tastiera, la lettura dello schermo, lo zoom e gli schermi stretti.

Esempio fittizio: un modulo contiene nome, indirizzo e-mail e messaggio. Il nome manca e l’indirizzo è incompleto; il messaggio è già valido. Il primo controllo deve quindi segnalare 2 errori, non 3. Correggere solo il nome lascia 1 errore; correggere anche l’indirizzo non ne lascia nessuno. Confrontate a ogni passaggio riepilogo, errori locali e valori conservati, senza imporre di riscrivere il messaggio.

In questo contratto di prova, ogni collegamento del riepilogo porta al campo interessato; aria-describedby associa la spiegazione al controllo e aria-invalid indica lo stato non valido. Dopo la correzione, rimuovete l’associazione all’errore superato mantenendo le istruzioni utili. Un guasto del servizio dopo la validazione non è un altro errore di inserimento e non prova alcun salvataggio. La tabella distingue quindi 0 errori di campo da un invio realmente confermato.

  • Riepilogo e messaggi sul campo.
  • associazioni di errori accessibili.
  • messa a fuoco e contrasto testati.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Correggere progressivamente due errori: prova fittizia
Passaggio della provaErrori di campo rimastiRisultato atteso
Primo controllo2: nome e indirizzo e-mailMessaggio conservato; entrambi gli errori accessibili
Solo nome corretto1: indirizzo e-mailErrore del nome rimosso; l’altro rimane
Anche indirizzo corretto0Campi validi; salvataggio ancora da verificare
Servizio indisponibile dopo la validazione0; guasto del servizio distintoNessuna falsa conferma; recupero spiegato
  • W3C WAI : User Notification

    W3C WAI, consultato il 22 ottobre 2026: notifiche dei moduli. Campi e passaggi costituiscono un esempio didattico fittizio.

Preserve input and intention

Mantieni valori validi dopo un errore, eccetto dati sensibili che non dovrebbero essere visualizzati di nuovo. Un modulo lungo dovrebbe consentire a qualcuno di riprendere a posto. Un file rifiutato richiede una spiegazione del formato o delle dimensioni.

distinguere gli errori di convalida, i ritardi di rete e l'invio duplicato. I clic ripetuti non devono creare più richieste o ordini. La conferma deve dire se l'azione è stata effettivamente registrata.

  • Campi validi mantenuti.
  • Errori di rete gestiti in modo chiaro.
  • Invii duplicati controllati.

testare casi reali

Prova campi vuoti, caratteri accentati, e-mail errate, file sovradimensionati, sessione scaduta e server non disponibile. Chiedi a qualcuno che non ha familiarità con il modulo di riprendersi senza aiuto e osserva esitazione.

Dopo la correzione, controlla l'e-mail o il passaggio successivo, non solo il messaggio sullo schermo. Anche il contenuto di conferma ed errore necessita di una revisione in ogni lingua pubblicata.

  • Errori rappresentativi coperti.
  • Viaggio completo controllato.
  • Messaggi tradotti e recensiti.

Correggere un campo senza perdere gli altri

Penna, modulo vuoto e griglia di calendario su un tavolo
Illustrazione generata dall’IA · Correggi un campo senza cancellare i dati già inseriti.

Caso proposto: una data invalida cancella gli altri campi. La persona deve ricostruire la richiesta.

Prova errori e nuovi tentativi con dati fittizi. Controlla valori conservati, messaggi associati ai campi e correzione comprensibile senza tentativi alla cieca.

  • Generare un errore noto
  • Controllare i valori conservati
  • Riprovare la richiesta

Documenti di riferimento

Contenuto aggiornato

Riferimenti documentati per questo argomento

Riferimenti documentati per questo argomento
RiferimentoValore o sintassiAmbito
WCAG 2.2 · 1.4.10
320 CSS pxContenuto verticale senza scorrimento in due dimensioni; eccezioni per contenuti necessariamente bidimensionali.
WCAG 2.2 · 2.5.8
24 × 24 CSS pxUn bersaglio più piccolo può rispettare il criterio con la spaziatura; esistono altre eccezioni.
WCAG 2.2 · 3.3.7
A · same processNello stesso processo, le informazioni già fornite devono essere precompilate o selezionabili, salvo le eccezioni del criterio. Il solo completamento del browser non basta: il sito deve offrire i dati ricevuti o evitare di richiederli.

Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.

Matrice di convalida funzionale per adattarsi al progetto

Questi controlli proposti utilizzano casi fittizi. Decidi quale comportamento è previsto con il team, annota il risultato e assegna discrepanze irrisolte prima della pubblicazione.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Casi di test, risultati attesi e prove utili
Casorisultato attesoProva da mantenere
Due campi non sono validi dopo l'invio.Ogni errore è associato al suo campo e il riepilogo aiuta a localizzarli.Registra URL, passaggi, risultati e prove datate.

Domande frequenti

Dove dovrebbero apparire utili errori di forma?

associare un messaggio preciso al suo campo e fornire un riepilogo per più errori. Spiega la correzione senza dettagli interni. Conserva l'input utile e controlla la tastiera e la lettura assistita. Il colore da solo non può identificare il problema.

Quale messaggio mostrare se l’invio fallisce con campi validi?

Distinguere input non valido, servizio indisponibile e risultato ancora ignoto dopo un’interruzione. Non chiedere di correggere un campo accettato. Conservare i valori utili e spiegare il recupero previsto. Se il server potrebbe avere salvato la richiesta prima del distacco, verificarne l’esito secondo il contratto del servizio prima di proporre un nuovo invio come privo di ulteriori effetti.