Input

Campi per l'inserimento di dati testuali e numerici, in forma libera o in formati specifici, all'interno di un form

Componenti

Metadati e link per approfondire

Utile per

Anteprima

Anteprima:
Inizio anteprima:Fine anteprima.

Quando usarlo

Usa il componente Input nel contesto di un modulo (Form), quando vuoi permettere agli utenti di inserire dati testuali, in forma libera o in formati specifici, per inserimenti lunghi o brevi.

Alternative a questo componente

  • Datepicker, Timepicker e Number input: sono varianti del componente Input per formati specifici consolidate in componenti ad hoc, per ottimizzare accessibilità e comportamento.
  • Autocomplete: se devi prevedere la possibilità di guidare l'utente a inserire solo testo da un lungo elenco controllato.
  • Select e Radio button: sempre nel caso di un elenco controllato, con un numero di elementi non troppo alto, puoi usare Select o un gruppo di Radio button.

Come usarlo

  • Usa la variante base per testi brevi o dati specifici brevi: ad esempio campi per l'inserimento di nome utente, email, telefono.
  • Usa la variante area di testo per testi lunghi: in questo caso è buona pratica definire un numero di caratteri massimo consentito.
  • Usa la variante password per campi di inserimento e registrazione password.
  • Usa le varianti ricerca per implemtare campi di ricerca nei contenuti, con o senza suggerimenti e/o autocompletamento.
  • Puoi usare gli stili con dimensioni più grandi per casi specifici in cui è presente un modulo composto da un solo input, ad esempio per campi di ricerca.

Attenzione a

  • Scegliere sempre etichette (label) testuali univoche per ogni campo: queste sono un elemento fondamentale oltre che per la comprensibilità del modulo, anche per l'accessibilità.
  • Indicare chiaramente se la compilazione è opzionale oppure obbligatoria per l'invio del modulo.
  • Testare il comportamento del componente con dispositivi, modalità di navigazione e inserimento contenuti diversi, mobile e desktop, navigazione da tastiera e touch.

Buone pratiche sui contenuti

  • Le etichette dei campi input devono essere chiare e concise, indicando senza ambiguità lo scopo del campo all'utente.
  • Usa un testo d'aiuto (helper text) ed eventuali contenuti segnaposto nel campo (placeholder), per fornire istruzioni ulteriori che guidino l'utente nella compilazione prevenendo errori, ad esempio riguardanti il formato richiesto.
  • Sostituisci il testo d'aiuto con un microtesto di errore durante la validazione dei contenuti se il campo rileva errori di compilazione. Ricorda che è buona pratica mostrare un suggerimento chiaro su cosa è necessario modificare, enfatizzando la soluzione e non l'errore.

Accessibilità

Lo stato delle verifiche di accessibilità effettuate sul componente Bootstrap Italia

CaratteristicaStatoDescrizione

Visivamente accessibile

Da verificare

Uso e contrasto dei colori, leggibilità

Amichevole con lettori di schermo

Da verificare

Struttura titolazioni, etichette e testi alternativi

Navigabile

Da verificare

Focus, struttura, navigazione da tastiera o altri device

Comprensibile

Da verificare

Comprensibile, prevedibile, gestione semplice dell’errore

Stato del componente

Lo stato del presente componente nelle diverse librerie di design e sviluppo del design system

Anatomia

Gli elementi che formano un Input

Il componente Input, nelle diverse varianti principali, può essere composto da:

  1. forma di sfondo;
  2. etichetta (label), il testo che informa l'utente sul contenuto che deve inserire nel campo. È obbligatorio, anche per l'accessibilità;
  3. icona sinistra, può essere usata per indicare il tipo di input richiesto, ad esempio con l'icona di una lente di ingrandimento per indicare un campo di ricerca;
  4. unità di misura, prefisso del campo che può essere mostrato per campi che prevedono l'inserimento di valute o percentuali;
  5. campo di testo, il campo per l'inserimento del contenuto da parte dell'utente, riga singola;
  6. testo di aiuto (helper text), testo opzionale che può fornire ulteriore aiuto o contesto all'utente sui dati richiesti dal campo, come ad esempio il corretto formato di inserimento;
  7. icona destra, di solito è usata per controllare il campo e alcune sue funzionalità, ad esempio può contenere l'accesso al calendario nelle varianti di scelta data del componente dedicato datepicker; è anche lo spazio che indica lo stato di validazione del campo dopo l'invio del modulo;
  8. frecce per input numerici, presenti nelle varianti con step numerici (a seconda del browser e del framework), come nel caso del componente dedicato Number input;
  9. bordo, riga inferiore che identifica il campo.

È consigliato utilizzare al massimo una sola icona, scegliendo la posizione corretta in base all'azione.

Input password

Gli elementi che formano un Input di tipo password

Il componente input di tipo password prevede inoltre:

  1. campo di testo, il campo per l'inserimento del contenuto da parte dell'utente prevede nel caso di un campo password una modalità di default offuscata, disattivabile temporaneamente dall'utente per facilitare l'inserimento;
  2. icona destra, usata per controllare la modalità offuscata del campo di testo, agisce da toggle per passare tra lo stato in chiaro (icona occhio) e lo stato offuscato (icona occhio barrato);
  3. testo di aiuto (helper text), nel caso di un campo per l'impostazione di una password dovrebbe fornire una chiara indicazione del formato richiesto;
  4. indicatore sicurezza password, nel caso di un campo per l'impostazione di una password dovrebbe rendere esplicito durante l'inserimento il livello di sicurezza della combinazione di caratteri digitata.

Input area di testo

Gli elementi che formano un Input di tipo area di testo

Il componente input di tipo area di testo prevede:

  1. forma di sfondo, definisce l'area di inserimento;
  2. campo di testo, il campo per l'inserimento del contenuto da parte dell'utente, multiriga;
  3. etichetta (label), il testo che informa l'utente sul contenuto che deve inserire nel campo. È obbligatorio, anche per l'accessibilità;
  4. maniglia per allargare, elemento interattivo utile ad allargare il campo per facilitare l'inserimento di contenuti lunghi;
  5. indicatore caratteri, indica il conteggio caratteri inseriti nel campo rispetto al numero massimo di caratteri a disposizione.

Input per ricerca, con suggerimenti e/o primi risultati

Gli elementi che formano un Input di tipo ricerca con autocompletamento

Il componente input di tipo ricerca con autocompletamento prevede:

  1. campo di input, formato dagli stessi elementi del campo input, con icona lente di ingrandimento dedicata a indicarne la funzione;
  2. forma di sfondo per i suggerimenti, area di default nascosta, si comporta come un dropdown aperto sopra i contenuti che seguono, mostrandosi durante l'inserimento o all'invio dei contenuti del campo, a seconda del contesto d'uso; può prevedere un'ombra o un bordo per distinguersi dai contenuti circostanti.
  3. lista di suggerimenti, lista che mostra suggerimenti e/o primi risultati della ricerca a seconda del contesto d'uso.

Comportamento

Gli stati interattivi dei campi di input possono essere:

  • default, il campo si presenta nello stato normale quando è attivo ma l'utente non ci interagisce;
  • hover, si manifesta al passaggio del puntatore sul campo, è disponibile solo su dispositivi no-touch;
  • focus, si manifesta nel caso di navigazione tramite tastiera o altri strumenti, passando da un elemento interattivo a quello successivo;
  • active, è lo stato relativo al momento del click o pressione sul campo, restituisce un riscontro visivo dell'azione appena compiuta e abilita l'inserimento del contenuto;
  • disabled, indica che il campo è disattivato e non è possibile interagire con esso;
  • readonly, indica che il campo è disponibile in sola lettura, non è possibile cambiarne il contenuto.

Gli stati di validazione dei campi input in linea generale possono essere:

  • success, il contenuto inserito dall'utente nel campo risponde al formato richiesto;
  • error, il contenuto inserito dall'utente nel campo non risponde al formato richiesto, oppure non è stato inserito alcun contenuto dall'utente in un campo obbligatorio.

Specifiche di design

Tutte le misure indicate sono espresse in px.

Input

Specifiche di design di un input con tutti gli elementi possibili

Input password

Specifiche di design di un input di tipo inserimento password

Varianti di dimensione normale e grande

Specifiche di design di un input di tipo ricerca in dimensioni normale e grande

Come iniziare

Scopri come utilizzare tutti gli strumenti pensati per progettare interfacce ed esperienze dei servizi pubblici

Anteprima

Anteprima:
Inizio anteprima:Fine anteprima.

Come iniziare

Scopri come utilizzare tutti gli strumenti pensati per progettare interfacce ed esperienze dei servizi pubblici