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.
Suggerimento
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.
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 |