comboBox e dbComboBox

La comboBox, analogamente alla filteringSelect , permette di selezionare un valore partendo da una stringa di ricerca, ma a differenza della filteringSelect permette di individuare valori anche non presenti tra quelli resi disponibili, che di conseguenza saranno da considerare come un «suggerimento» all’utente, ma non vincolante.

Così come per la filteringSelect esiste un analogo strumento che permette di lavorare sul database, la dbSelect , anche per la comboBox esiste la dbCombobox, un widget che serve a cercare un dato da una table di database partendo da una stringa di ricerca.

A differenza della dbSelect in cui si cerca sul valore di un campo, ma viene restituita ed inserita nella form la primary key del record, nella dbCombobox viene inserito nella form il valore stesso. Anche in questo caso, quindi, è possibile inserire valori che non sono presenti nella table di origine.


Esempi

Un combobox all’interno di un formbuilder con accanto un campo che riporti il valore selezionato. Questo combobox ha inoltre i parametri auxColumns, per visualizzare i nomi degli stati nella tendina e il paramentro hasDownArrow per mostrare la freccia che apre il menu.


Parametri:

Nome parametro

Tipo

Descrizione

dbtable

T

(deprecato, sostituito con «table»)

table

T

Indica la tabella da cui reperire i dati, nella forma «package.table»

hasdownarrow

B

True or False, permette di indicare se il campo mostrerà o meno una tendina

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