torna all'elenco degli elementi della sezione Widgets

# Elemento di catalogo: ComboBox ()

## Descrizione

E' il widget di selezione di uno o più elementi a partire da una lista di dati dinamicamente precaricata. La collezione dei dati che compongono l'insieme selezionabile solitamente viene desunta da una struttura dati, i cui elementi devono essere specificatamente indicati.

Quando il controllo non è attivo mostra solo un valore (corrispondente al contenuto memorizzato nel campo all'ultima scelta effettuata); una volta attivato mostra tutta la lista dei possibili valori.

Il widget completo prevede una label ed il campo di selezione associato.

La label può essere, in casi particolari, vuota.

Alla selezione di un elemento dalla lista viene eseguita la logica applicativa associata.

## Caratteristiche (features)

cod. | nome | descrizione
apparenza grafica
WCMB010 | marcatore errore di validazione | Visualizzazione di un marcatore di errore in prossimità della label, in caso di fallita validazione (rif. Label )
WCMB011 | evidenza obbligatorietà | Evidenza di obbligatorietà (es. Asterisco a lato della label) (rif. Label )
WCMB013 | scrolling delle voci | Modalità di visualizzazione di dati che eccedono la dimensione visibile (es. scroll del contenuto mantenendo fissa la dimensione grafica o troncamento del testo)
WCMB015 | tooltip a comparsa | Comparsa del tooltip al passaggio del cursore sulla label (rif. Tooltip )
WCMB018 | evidenza stato abilitazione | Evidenza dello stato di abilitazione (es. differente colore della label in stato editabile rispetto a non editabile) (rif. Label )
WCMB020 | num. linee visibili in multiselezione | Nel caso di ComboBox a selezione multipla è possibile definire a tempo di progettazione il numero di linee che devono essere visualzzate senza che si debba utilizzare la scrollbar.
WCMB021 | 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
WCMB006 | abilitazione comandabile | Disabilitazione/Abilitazione a comando
WCMB007 | visibilità a comando | Modalità invisibile/visibile a comando
WCMB008 | profilazione dell'abilitazione | Disabilitazione/Abilitazione a fronte di regole associate al profilo dell'utente collegato
WCMB009 | profilazione della visibilità | Modalità invisibile/visibile a fronte di regole associate al profilo dell'utente collegato
WCMB012 | copy | Possibilità di copiare nella clipboard il testo descrittivo dell'opzione correntemente selezionata
WCMB014 | autocomplete | Funzione di autocomplete (restrizione dell'elenco di opzioni a fronte dell'immissione progressiva dei caratteri iniziali della selezione stessa)
WCMB016 | attivazione logica alla selezione | Attivazione logica applicativa associata a fronte della selezione di un elemento
WCMB019 | suggestion | utilizzo suggestion (rif. Suggestion )
struttura
WCMB017 | includibilità in pannelli | Il ComboBox può essere contenuto nei seguenti pannelli: WidgetsPanel
dati
WCMB001 | ordinamento predefinito dati | Ordinamento di visualizzazione desiderato (es.: alfabetico, su codice identificativo,...)
WCMB002 | selezione singola | Utilizzo della combo in selezione singola
WCMB003 | selezione multipla | Utilizzo della combo in selezione multipla
WCMB004 | selezione valore iniziale | Preselezione di una voce della lista (default) (es. alla visualizzazione della schermata)
WCMB005 | validazione al submit | Validazione della selezione al submit della form (rif. Submit (di una form) )

## Immagini

combobox obbligatorie

combobox con marcatore errore

combobox con autocomplete

combobox condizionata

## Grado di implementazione delle varie caratteristiche

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

cod | feature | guigen
--- | --- | ---
1.5.0 | 1.6.0
neutral-base | neutral-arricchita | neutral-base | neutral-arricchita
apparenza grafica
WCMB010 | marcatore errore di validazione |  |  |  |
WCMB011 | evidenza obbligatorietà |  |  |  |
WCMB013 | scrolling delle voci |  |  |  |
WCMB015 | tooltip a comparsa |  |  |  |
WCMB018 | evidenza stato abilitazione |  |  |  |
WCMB020 | num. linee visibili in multiselezione |  |  |  |
WCMB021 | label |  |  |  |
dinamica di interazione
WCMB006 | abilitazione comandabile |  |  |  |
WCMB007 | visibilità a comando |  |  |  |
WCMB008 | profilazione dell'abilitazione |  |  |  |
WCMB009 | profilazione della visibilità |  |  |  |
WCMB012 | copy |  |  |  |
WCMB014 | autocomplete |  |  |  |
WCMB016 | attivazione logica alla selezione |  |  |  |
WCMB019 | suggestion |  |  |  |
struttura
WCMB017 | includibilità in pannelli |  |  |  |
dati
WCMB001 | ordinamento predefinito dati |  |  |  |
WCMB002 | selezione singola |  |  |  |
WCMB003 | selezione multipla |  |  |  |
WCMB004 | selezione valore iniziale |  |  |  |
WCMB005 | validazione al submit |  |  |  |