Esempio Online Anteprima
Sorgente PHP: examples/select/dsselect.php
Sorgente XML: examples/select/select.xml
Sorgente XML: examples/select/list.xml
Sorgente XML: examples/select/nav.xml
Sorgente XML: examples/select/field.xml
Sorgente XML: examples/select/multipleselect.xml
Sorgente XML: examples/select/dsselectgrid.xml

L'oggetto dsselect è l'equivalente del tag html select. Sfruttando alcuni dei suoi attributi è possibile ottenere diverse modalità di funzionamento. Il dsselect può essere popolato direttamente inserendo i dati nella pagina sorgente XML in maniera simile ad una normale select di una pagina HTML o attraverso un ds:


POPOLARE LA SELECT

Inserimento manuale dei dati:

<idtag typeobj="dsselect" label="nSelect:">
<options>
<opt optiontext="valore1" optionvalue="chiave1"/>
<opt optiontext="valore2" optionvalue="chiave2"/>
<opt optiontext="valore3" optionvalue="chiave3" optionselected="true"/>
.............................................
<opt optiontext="valoren" optionvalue="chiaven"/>
</options>
</idtag>

oppure in un unica riga, questa è la forma da utilizzare quando si deve inserire in una gridds

<idtag typeobj="dsselect" label="nSelect:" value="chiave3" optiontext="valore1,valore2,valore3,..,valoren" optionvalue="chiave1,chiave2,chiave3,...,chiaven"/>

Quando i valori specificati nell'optiontext sono uguali a quelli optionvalue è sufficiente specificare solo optionvalue.

In alternativa la select può essere popolata da un ds gli attributi in gioco sono:

  • dsobjlist: attributo contenente il nome del ds da cui prelevare i dati
  • dsitemlist: attributo contenente il nome del campo dal quale prendere i valori da visualizzare nella select
  • dsitemkeylist: attributo contenente il nome del campo dal quale prendere i valori chiave da inserire nella select
<idtag typeobj="dsselect" dsobjlist="dsname" dsitemlist="campotext" dsitemkeylist="campochiave" />

MEMORIZZARE I DATI

Nel caso si voglia salvare il dato selezionato bisogna specificare il ds di destinazione tramite gli attributi dsobj e dsitem:

<idtag typeobj="dsselect" dsobj="dsname" dsitem="nomecampo" .......... />

Attenzione nel caso in cui i dati provengano da un ds è necessario che all'interno del sorgente xml il ds sorgente sia dichiarato prima del ds di destinazione:

<dssource typeobj="ds" ........ />
<dsdestination typeobj="ds" . />
<dselect typeobj="dsselect" dsobjlist="dssource" dsitemlist="name" dsitemkeylist="id" dsobj="dsdestination" dsitem="name" />

SELECT DI NAVIGAZIONE

Impostando l'attributo nav a true la select si comporta come l'oggetto dsnav cioè permetterà di spostarsi tra i record:

<idtag typeobj="dsselect" nav="true" ............ />

SELEZIONE MULTIPLA

Analogamenta al tag HTML select l'attributo multiple = multiple attiverà la selezione multipla

<idtag typeobj="dsselect" multiple="multiple" ............ />