simpleTextArea

La simpleTextArea è una area di input destinata a ricevere testi estesi. Con l’attributo editor il widget si arricchisce con un editor di testo HTML avanzato.

Una simpleTextArea con editor

Per la sua natura più estesa degli altri, il widget non prevede meccanismi di validazione, di conseguenza è necessario implementarli ad hoc. In questo caso vediamo un esempio di estensione che fa uso dell’attributo connect_onkeyup: all’inserimento di un carattere, verrà aggiornato un conto alla rovescia, che arrivato a 0 troncherà i caratteri inseriti.

simpleTextArea con contatore personalizzato

---

Parametri:

Nome parametro	Tipo	Descrizione
height	T	Altezza dell’area, come attributo html
editor	B	Aggiunge all’area un rich text editor
connect_onkeyup	T	Permette di specificare una serie di eventi javascript da scatenare all’inserimento di un carattere all’interno del widget.
Html Parametri
_class	T	Permette di assegnare una specifica classe CSS 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