torna all'elenco degli elementi della sezione Widgets

# Elemento di catalogo: TextField ()

## Descrizione

E' il classico widget di immissione di dati testuali a riga singola. Un textfield può contenere un campo di tipo stringa, numero, data. Il widget completo prevede una label ed il campo di immissione associato. La label può essere, in casi particolari, vuota.

## Caratteristiche (features)

cod. | nome | descrizione
apparenza grafica
WTFL010 | marcatore errore di validazione | Visualizzazione di un marcatore di errore in prossimità della label, in caso di fallita validazione (rif. Label )
WTFL011 | evidenza obbligatorietà | Evidenza di obbligatorietà (es. Asterisco a lato della label) (rif. Label )
WTFL012 | testo completo se disabilitato | Modalità di visualizzazione di dati che eccedono la dimensione visibile del textfield, in condizioni di non-editabilitè (es. doppio click sul campo per visualizzare l'intero campo in modo espanso o scroll del contenuto mantenendo fissa la dimensione grafica)
WTFL016 | tooltip a comparsa | Comparsa del tooltip al passaggio del cursore sulla label (rif. Tooltip )
WTFL020 | evidenza stato abilitazione | Evidenza dello stato di abilitazione (es. differente colore della label in stato editabile rispetto a non editabile) (rif. Label )
WTFL021 | label | Il widget è tipicamente corredato da una etichetta testuale che permette di identificarlo all'interno della schermata. In genere il testo (o una eventuale immagine) sono scelti in modo da descrivere il contenuto informativo del widget. In alcuni casi particolari l'etichetta potrebbe essere assente. (rif. Label )
dinamica di interazione
WTFL004 | dimensione area editabile | Dimensione massima dell'area editabile
WTFL005 | abilitazione comandabile | Disabilitazione/Abilitazione a comando
WTFL006 | visibilità a comando | Modalità invisibile/visibile a comando
WTFL007 | profilazione dell'abilitazione | Disabilitazione/Abilitazione a fronte di regole associate al profilo dell'utente collegato
WTFL008 | profilazione della visibilità | Modalità invisibile/visibile a fronte di regole associate al profilo dell'utente collegato
WTFL013 | copy & paste | Copia-incolla del contenuto
WTFL014 | maschera input | Verifica contestuale alla digitazione dell'aderenza dei caratteri immessi al tipo di dato previsto (es. solo caratteri numerici per tipi numerici)
WTFL015 | blocco digitazione a max caratteri | Blocco della digitazione dei caratteri al raggiungimento del limite massimo dei caratteri definiti per il dato
WTFL017 | suggestion | utilizzo suggestion (rif. Suggestion )
struttura
WTFL018 | includibilità in pannelli | Il widget può essere contenuto nei seguenti pannelli: WidgetsPanel
dati
WTFL001 | tipi dati ammessi | Tipo dato: stringa, numero o data
WTFL002 | formato dati | Formato (ad es. per la data "gg/mm/aaaa", per i numeri quante cifre intere e quante decimali)
WTFL003 | max caratteri | Numero massimo di caratteri accettabili
WTFL009 | validazione al submit | Validazione dell'input immesso al submit della form (rif. Submit (di una form) )
WTFL019 | validazione al cambio fuoco | validazione del contenuto del campo al cambio fuoco

## Immagini

textfield obbligatorio e non obbligatorio

textfield con marcatore di errore

textfield con tooltip

## Grado di implementazione delle varie caratteristiche

Nella tabella seguente è riportato il grado di implementazione delle varie caratteristiche/funzioni dell'elemento TextField nelle differenti implementazioni.

cod | feature | guigen
--- | --- | ---
1.5.0 | 1.6.0
neutral-base | neutral-arricchita | neutral-base | neutral-arricchita
apparenza grafica
WTFL010 | marcatore errore di validazione |  |  |  |
WTFL011 | evidenza obbligatorietà |  |  |  |
WTFL012 | testo completo se disabilitato |  |  |  |
WTFL016 | tooltip a comparsa |  |  |  |
WTFL020 | evidenza stato abilitazione |  |  |  |
WTFL021 | label |  |  |  |
dinamica di interazione
WTFL004 | dimensione area editabile |  |  |  |
WTFL005 | abilitazione comandabile |  |  |  |
WTFL006 | visibilità a comando |  |  |  |
WTFL007 | profilazione dell'abilitazione |  |  |  |
WTFL008 | profilazione della visibilità |  |  |  |
WTFL013 | copy & paste |  |  |  |
WTFL014 | maschera input |  |  |  |
WTFL015 | blocco digitazione a max caratteri |  |  |  |
WTFL017 | suggestion |  |  |  |
struttura
WTFL018 | includibilità in pannelli |  |  |  |
dati
WTFL001 | tipi dati ammessi |  |  |  |
WTFL002 | formato dati |  |  |  |
WTFL003 | max caratteri |  |  |  |
WTFL009 | validazione al submit |  |  |  |
WTFL019 | validazione al cambio fuoco |  |  |  |