.. _widgetpedia/elements/inputfields/checkbox:
checkbox e checkBoxText
=======================
*checkbox*, *checkBoxText* sono due widget che permettono di visualizzare per l'appunto delle *checkbox* nelle view e nelle form di Genropy.
checkbox
--------
Nel primo caso la *checkbox* permette la semplice scelta tra valori sì/no (*booleani*). È quindi possibile inserire un'etichetta ``label`` (es: 'Confermato'), un'altra etichetta di introduzione al campo ``lbl`` (es: 'Status: ') e il ``value`` (es: '^status')::
fb.checkbox(value='^status', label='Status: ', lbl='Confermato')
.. raw:: html
.. raw:: html
checkBoxText
------------
Nel secondo caso la *checkBoxText* permette invece di indicare la scelta tra una serie di valori, definibili direttamente come ``values`` della checkbox o a partire da una table::
fb.checkboxtext(value='^color', values='Red,Green,Yellow', lbl='Favourite Color: ')
fb.checkboxtext(value='^state', table='invc.state', lbl='Visited states: ')
.. raw:: html
.. raw:: html
**Parametri:**
+------------------------+------+--------------------------------------------------+
| Nome parametro | Tipo | Descrizione |
+========================+======+==================================================+
|_class |T |Permette di assegnare una specifica classe CSS al |
| | |widget |
+------------------------+------+--------------------------------------------------+
|height |T |Permette di assegnare un'altezza al widget |
+------------------------+------+--------------------------------------------------+
|width |T |Permette di assegnare una larghezza al widget |
+------------------------+------+--------------------------------------------------+
|border |T |Permette di assegnare un bordo al widget |
+------------------------+------+--------------------------------------------------+
|rounded |L |Permette di assegnare un arrotondamento al widget |
+------------------------+------+--------------------------------------------------+
|style |T |Permette di assegnare uno stile (da esprimersi |
| | |come serie di attributi CSS) al widget |
+------------------------+------+--------------------------------------------------+
|background |T |Permette di assegnare uno sfondo al widget |
+------------------------+------+--------------------------------------------------+
| *Validations Parametri* |
+------------------------+------+--------------------------------------------------+
|validate_empty |T |Restituisce un errore se il valore è nullo o è una|
| | |stringa vuota |
+------------------------+------+--------------------------------------------------+
|validate_notnull |B |Restituisce un errore se il campo è vuoto |
+------------------------+------+--------------------------------------------------+
|validate_call |T |Restituisce un errore js |
+------------------------+------+--------------------------------------------------+
|validate_regex |T |Restituisce un errore se il campo corrisponde |
| | |esattamente a quanto indicato |
+------------------------+------+--------------------------------------------------+
|validate_remote |T |Metodo RPC che effettua la validazione del valore |
| | |inserito |
+------------------------+------+--------------------------------------------------+
| *Common Parametri* |
+------------------------+------+--------------------------------------------------+
|value |T |Permette di inserire un valore, in termini |
| | |assoluti (es. value='Pippo') o posizionali (es. |
| | |value='^.name'). Nel primo caso verrà assegnato il|
| | |valore 'Pippo', nel secondo verrà assegnato a |
| | |'name' il valore che inseriremo nell'inputfield. |
+------------------------+------+--------------------------------------------------+
|lbl |T |Permette di inserire un'etichetta per il campo. |
| | |Per div, caselle e aree di testo la "lbl" verrà |
| | |visualizzata prima del campo, per le checkbox |
| | |invece verrà mostrata dopo. |
+------------------------+------+--------------------------------------------------+
|lbl\_ |T |Permette di assegnare attributi alla lbl (es: |
| | |"lbl_class") |
+------------------------+------+--------------------------------------------------+
|default |T |Valore di default se non modificato |
+------------------------+------+--------------------------------------------------+
|placeholder |T |Testo di anteprima (non rappresenta un valore |
| | |inserito ma solo un suggerimento) |
+------------------------+------+--------------------------------------------------+
|disabled |B |Permette di disabilitare il campo. Es: |
| | |disabled=True |
+------------------------+------+--------------------------------------------------+
|tabindex |L |In un formbuilder con una serie di campi, permette|
| | |di dare un ordinamento personalizzato nella |
| | |compilazione nel passaggio da un campo a un altro |
| | |con il tabulatore (es: tabindex=4) |
+------------------------+------+--------------------------------------------------+
|_autoselect |B |Se impostato a True, alla selezione del campo il |
| | |contenuto del campo sarà automaticamente |
| | |selezionato |
+------------------------+------+--------------------------------------------------+
| *checkbox / checkboxtext Parametri* |
+------------------------+------+--------------------------------------------------+
|label |T |Per le sole checkbox, oltre all'etichetta "lbl" è |
| | |presente anche un'altra etichetta "label", che può|
| | |essere utilizzata per mostrare un testo |
| | |introduttivo a sinistra della checkbox |
+------------------------+------+--------------------------------------------------+
|table |T |Indica la tabella da cui reperire i dati, nella |
| | |forma "package.table" |
+------------------------+------+--------------------------------------------------+
|popup |T |Se impostato a True, permette di visualizzare i |
| | |valori della checkbox in un menu a discesa |
+------------------------+------+--------------------------------------------------+
|hasDownArrow |T |Se impostato a True, il menu a discesa sarà nella |
| | |forma "a tendina" |
+------------------------+------+--------------------------------------------------+
|alt_pkey_field |T |Permette di indicare un campo alternativo alla |
| | |selezione della pkey (es: alt_pkey_field='code') |
+------------------------+------+--------------------------------------------------+