Istruzioni dei moduli

Silktide individua i campi dei moduli che potrebbero richiedere una spiegazione, come i campi di testo libero, e ti chiede di decidere se ciascuno necessita di istruzioni che descrivano cosa inserire. I campi che necessitano di istruzioni devono averle associate nel codice, non semplicemente posizionate nelle vicinanze.

Perché è importante

Spesso un'etichetta da sola non è sufficiente. "Data" non dice nulla sul formato previsto, che varia in base al Paese; "Riferimento" non specifica quale dei tuoi tre numeri di riferimento sia richiesto. I visitatori che fanno supposizioni errate ricevono un errore oppure, peggio ancora, il loro invio viene accettato con dati errati.

Associare l'istruzione nel codice è importante quanto scriverla: un suggerimento che si trova solo visivamente vicino al campo è invisibile a un utente di che ha il focus sull'input.

Come risolvere

Per ogni campo segnalato, decidi se un visitatore potrebbe non sapere cosa inserire. In tal caso:

Aggiungi una descrizione e collegala al campo con l'attributo aria-describedby di :

<!-- Il suggerimento viene annunciato quando il campo riceve il focus -->
<label for="date">Data</label>
<input type="text" id="date" aria-describedby="date-hint">
<p id="date-hint">Formato: giorno/mese/anno, ad es. 28/07/2026</p>

In alternativa, usa un tipo di campo progettato appositamente. <input type="date"> offre ai visitatori un selettore di data nella loro lingua, senza necessità di spiegazioni: preferiscilo quando è disponibile un tipo adatto.

Se il campo è autoesplicativo, ad esempio una casella "Cerca" o un campo "Messaggio" in un modulo di contatto, non sono necessarie istruzioni; il risultato.

Come esegue il test Silktide

Individua i controlli dei moduli per cui le istruzioni potrebbero essere utili: gli elementi <textarea> e i campi <input> di tipo text, email, file, number, password o range. I pulsanti, le caselle di controllo, i pulsanti di opzione e i menu a discesa vengono ignorati, perché per questi normalmente è sufficiente un'etichetta.
Ignora i campi non visibili agli utenti vedenti e quelli inseriti da widget di terze parti noti, come i moduli nascosti che gli script di monitoraggio e traduzione aggiungono per il proprio utilizzo.
Ignora i campi che hanno già una descrizione associata: un aria-describedby che punta a testo reale e non vuoto, oppure un attributo aria-description non vuoto.
Segnala ogni campo rimanente per la tua revisione: una persona decide se necessita effettivamente di istruzioni.

Risoluzione dei problemi

Il mio campo ha un suggerimento subito sotto

La vicinanza visiva non equivale a un'associazione. A meno che il suggerimento non sia collegato al campo con aria-describedby (o aria-description), la non lo annuncia e Silktide segnala il campo. L'aggiunta dell'attributo risolve entrambi i problemi.