dateTextBox e timeTextBox

Il dateTextBox è un textBox che ammette come valori delle date. Il valore inserito sarà pertanto automaticamente convertito a un oggetto di tipo data.

Di default presenta un popup che mostra un calendario per la selezione del giorno. Il popup può essere disabilitato impostando il parametro popup=False.


Il datetextbox supporta il linguaggio naturale: oltre quindi all’inserimento canonico in forma numerica (anche nella forma senza barre, ad es: «010121»), sono supportate le espressioni verbali naturali come «mese scorso», «quest’anno», «settimana prossima», nonché le operazioni con le stesse (es: «oggi-10»).

Inoltre, utilizzando period_to indicando il path di un’altra dateTextBox, è possibile auto-compilare le date di inizio e di fine e di un periodo: inserendo quindi in quella che sarà la data di inizio «settimana scorsa», il sistema compilerà automaticamente il primo campo data con il lunedì della scorsa settimana e l’altro campo data con la domenica.

timeTextBox

La timeTextBox, analogamente al caso precedente, permette di presentare un’interfaccia per l’inserimento di un orario.


dateTimeTextBox

È stata recentemente introdotta una versione ibrida, la dateTimeTextBox, che permette di gestire in un unico campo data e ora contemporaneamente.

format

Si noti che è possibile specificare il format del widget:

fb.datetextbox(lbl='Insert date',value='^.date', format='MM/dd/yy')

In questo caso caso con format='dd/MM/yy' si specifica di mostrare prima due cifre per il mese, poi due cifre per il giorno e infine due cifre per l’anno.


Parametri:

Nome parametro

Tipo

Descrizione

popup

B

Di default True, se impostato a False nasconde il popup che mostra il calendario con la data

period_to

T

Utilizzando period_to indicando il path di un’altra dateTextBox è possibile auto-compilare le date di inizio e di fine e di un periodo (es: period_to=”.date_to”)

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

Autore della sezione: Davide Paci