.. _widgetpedia/elements/inputfields/numbertextbox:
numberTextBox
=============
Il numberTextBox è come un textbox che ammette solo l'inserimento di valori numerici.
.. raw:: html
.. raw:: html
format
------
Si noti che è possibile specificare il *format* del widget::
fb.numberTextBox(value='^my_height', lbl='My Height', format='###.00')
fb.numberTextBox(value='^my_age', lbl='My Age', format='##')
Nel primo caso con ``format='###.00`` si specifica di mostrare le cifre e due decimali, nel secondo caso con ``format='##'`` si richiede invece di mostrare solo le cifre senza decimali. Si noti che è indifferente il numero di simboli # utilizzati, mentre è rilevante il numero di 0 per esprimere la quantità di decimali. È sempre possibile inoltre identificare un separatore per le migliaia (es: ``format='#,###.00``)
.. 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 |
+------------------------+------+--------------------------------------------------+
|validate_min |N |Restituisce un errore se il valore inserito è |
| | |inferiore al "validate_min" |
+------------------------+------+--------------------------------------------------+
|validate_max |N |Restituisce un errore se il valore inserito è |
| | |superiore al «validate_max» |
+------------------------+------+--------------------------------------------------+
|validate_len |N |Restituisce un errore se il valore è diverso dalla|
| | |lunghezza «validate_len» o non compreso nel range |
| | |X:Y indicato in «validate_len» |
+------------------------+------+--------------------------------------------------+
| *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 |
+------------------------+------+--------------------------------------------------+