La documentazione degli elementi IonSelect e IonAutoComplete non è chiarissima e quindi l’ho aggiornata ma l’aggiornamento uscirà con la versione 24.5 a ottobre 2024 (insieme alla 24.5 di Foundation).
Fino a quel momento vi condivido qui gli help aggiornati.
IonSelect
Elemento che permette di selezionare uno o più valori da una lista di opzioni. Vedi anche Ionic Select.
La lista di opzioni viene composta da un codice ed una descrizione, il codice rappresenta la chiave primaria della tabella collegata e la descrizione il valore visualizzato nelle scelte.
Nota: se si inseriscono due elementi IonSelect nello stesso container, assicurarsi che essi siano racchiusi in un elemento IonItem, oppure che il container abbia come classe css item-multiple-inputs.
La sorgente dati di questo elemento può essere rappresentata da una DataMap aggiunta ad esso oppure da una lista valori impostando la proprietà IonSelect.list.
Nel caso di utilizzo di una DataMap i campi utilizzati corrispondono alle sue proprietà dove il valore è preso dalla chiave primaria e la descrizione dal primo campo di tipo alfanumerico. Per forzare la scelta della descrizione è sufficiente eliminare le proprietà non utilizzate lasciando solamente la chiave primaria e il campo che si desidera diventi la descrizione visualizzata.
Alla DataMap possono essere anche aggiunte delle proprietà calcolate per forzare il codice e la descrizione dei valori mostrati come segue:
- v = valore del campo
- n = descrizione mostrata
- src = immagine associata
La proprietà src viene utilizzata solamente se la proprietà IonSelect.chipList è valorizzata.
Nella proprietà src può essere valorizzata anche da una risorsa di tipo immagine del progetto.
IonSelect.list
Lista delle opzioni che saranno presentate nell’elemento.
Selezionare una lista valori presente nel progetto, oppure impostare a runtime un oggetto javascript nella forma:
[{n : "<name1>", v : "<value1>", src : "<ion:icona1>" },
{n : "<name2>", v : "<value2>", src : "<ion:icona2>"},
... ]
La proprietà src viene utilizzata solamente se la proprietà IonSelect.chipList è valorizzata.
Nella proprietà src può essere valorizzata anche da una risorsa di tipo immagine del progetto.
Se viene utilizzata una lista valori la proprietà valore verrà utilizzata come valore del campo, la proprietà descrizione come decodifica. Nel caso la descrizione non sia impostata allora viene utilizzato il nome della costante.
Se nella costante della lista viene valorizzata la proprietà Immagine questa verrà utilizzata prima del nome del valore (come per la proprietà src dell’oggetto javascript).
IonAutoComplete
Elemento visuale che realizza un campo di tipo combo-box con autocomplete.
La sorgente dati di questo elemento può essere rappresentata da una DataMap aggiunta ad esso oppure da una lista valori impostando la proprietà IonAutoComplete.list.
Nel caso di utilizzo di una DataMap i campi utilizzati corrispondono alle sue proprietà, dove il valore è preso dalla chiave primaria e la descrizione dal primo campo di tipo alfanumerico presente tra di esse. Per forzare la scelta della descrizione è sufficiente eliminare le proprietà non utilizzate lasciando solamente la chieve primaria e il campo che si desidera diventi la descrizione visulizzata.
Alla DataMap possono essere anche aggiunte delle proprietà unbound per forzare il codice e la descrizione dei valori mostrati come segue:
- v = valore del campo
- n = descrizione mostrata
- src = immagine associata