.. _widgetpedia/elements/inputfields/filteringselect:
filteringSelect
===============
filteringSelect è un widget che permette di modo di creare campi che restringono la scelta del valore da un set di opzioni caricate in memoria dinamicamente o hardcoded nella pagina della form.
.. raw:: html
.. raw:: html
.. raw:: html
.. hint::
Per l'indicazione di valori del widget in più lingue, andrà utilizzata la sintassi seguente::
fb.filteringSelect('^.fieldname', lbl='!![en]Choose value', values='1:[{value1}],2:[{value2}]'.format(value1="!![en]Value 1", value2="!![en]Value 2")
N.B. L'uso di *format* non è obbligatorio, ma è qui utilizzato a fini didattici.
.. raw:: html
**Parametri:**
+------------------------+------+--------------------------------------------------+
| Nome parametro | Tipo | Descrizione |
+========================+======+==================================================+
|values |T |Un elenco separato da virgole di valori |
| | |selezionabili (es: "Maschio,Femmina"). Può anche |
| | |essere espresso con questa sintassi: "M: maschio, |
| | |F: femmina", in questo caso verranno visualizzate |
| | |le etichette ma nel database saranno sempre |
| | |salvati i codici corrispondenti. |
+------------------------+------+--------------------------------------------------+
|storepath |T |È un altro modo per fornire valori selezionabili |
| | |nel menu. È il percorso della bag contenente i |
| | |valori. |
+------------------------+------+--------------------------------------------------+
| *Html Parametri* |
+------------------------+------+--------------------------------------------------+
|_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 |
+------------------------+------+--------------------------------------------------+