Combo
Propriétés
Nom | Type | Description |
---|---|---|
Type | Liste |
Liste simple Liste filtrable Dropdown Dropdown custom |
Propriétés dropdown et dropdown custom
Les propriétés suivantes sont disponible lorsque vous selectionnez le type Dropdown ou Dropdown custom
Nom | Type | Description |
---|---|---|
Filtrable | Oui/non |
Autorise la recherche dans la liste source |
Labels
Nom | Type | Description |
---|---|---|
Couleur | Couleur |
Couleur de police du texte affiché dans la dropdown |
Taille | Entier |
Taille de police du texte affiché dans la dropdown |
Gras | Liste |
Niveau de gras du texte affiché dans la dropdown |
Toggle
Nom | Type | Description |
Couleur | Couleur |
Couleur du toggle à droite |
Taille | Entier |
Taille en pixel du toggle à droite |
Lignes
Nom | Type | Description |
Hauteur | Entier |
Hauteur en pixel des lignes de la dropdown |
Curseur | Liste |
Curseur à afficher au survol de chaque ligne |
Survol des lignes
Nom | Type | Description |
Couleur fond | Couleur |
Couleur de fond de la ligne au survol de la souris |
Couleur police | Couleur |
Couleur de la police de la ligne au survol de la souris |
Types de combo
Les types de combo définissent le style d’affichage de la combo et son niveau de personnalisation
Liste simple
Une combo standard et native, la recherche dans la liste n’est pas disponible avec ce type
Liste filtrable
Une combo standard et native permettant d’effectuer une recherche dans la liste source
Dropdown
Une combo améliorée avec un meilleur design et plus de possibilitées de personnalisation
Dropdown custom
Une combo dropdown permettant de personnaliser le contenu/affichage de la liste de choix
Source de donnée
Les sources de donnée disponibles pour le composant combo sont les suivantes :
1. Table de BDD / Requête SQL
Filter/trier les données
Lorsque la source est une table BDD, vous pouvez ajouter des filtres et des tris via les options Filtrer les données
et Trier les données
Lorsque la source est une requête SQL, vous pouvez alimenter les variables de la requête via l’option Mapping des variables d'entrée
Champ affiché/champ lié
-
Le champ affiché est le champ de la table BDD/requête visible dans la liste de choix
-
Le champ lié est un champ supplémentaire non visible dans la liste mais accessible dans les workflows
Afficher une ligne d'entête
2. Liste fixe
Dans le cas d’une source fixe, les valeurs à afficher sont renseignés les unes en dessous des autres
Champ affiché/champ lié
-
Le champ affiché correspond aux valeurs saisies ci-dessus
-
Le champ lié correspond à l’index de la ligne, 0 étant l’index de la 1ère ligne
3. JSON
Vous pouvez définir un JSON comme source de votre combo. Ce JSON doit alors contenir au minimum 2 clefs permettant d’alimenter le champ affiché et le champ lié.
Valeur d’initialisation
La valeur d’initialisation permet de définir une valeur par défaut de la combo, 3 possibilités :
-
Index de la ligne : la valeur par défaut s’appliquera sur l’index de la ligne, 0 étant l’index de la 1ère ligne. Par exemple si la valeur 2 est renseignée comme valeur d’initialisation, alors c’est la 3ème ligne de la combo qui sera affichée par défaut
-
Valeur affichée : la valeur par défaut s’appliquera sur la valeur affichée de la ligne, la valeur affichée étant définie dans l’option
Champ affiché
des propriétés de la source de donnée de la combo -
Valeur liée : la valeur par défaut s’appliquera sur la valeur liée de la ligne, la valeur liée étant définie dans l’option
Champ lié
des propriétés de la source de donnée de la combo
Laison native
La liaison native permet d’afficher/modifier le champ d’un enregistrement directement dans la combo. Ce paramètre se trouve dans le volet Données
des propriétés de la combo. La liaison native est basée sur le champ lié lorsque la source de donnée est une table BDD, une requête ou un JSON, elle est basée sur le champ affiché lorsque la source de donnée est une liste fixe. 4 types de laisons possibles :
-
Aucune liaison
-
Lecture
-
Ecriture
-
Lecture/écriture
Validation
La validation se trouve dans le volet Plus
des propriétés de la combo et permet de controler la valeur selectionnée dans la combo. Ce controle est effectué soit sur le champ lié, soit sur le champ affiché de la combo.
Le déclenchement du controle est réalisé à l’aide de l’action FormulaireValide
sur une zone parent.
Si une validation n’est pas respectée, les bordures de la combo apparaitront en rouge et le message d’erreur sera affiché en haut de la zone parent.
Exemple : controle sur le champ affiché, la combo n’autorise pas de valeur vide
Propriétés publiques
Les propriétés publiques sont les propriétés du composant pouvant être utilisées dans le variable picker
Nom | Type | Description |
---|---|---|
Valeur retourné | Texte |
Le champ lié associé à la ligne selectionnée |
Valeur affiché | Texte |
Le champ affiché associé à la ligne selectionnée |
Enr. | Enregistrement |
L’enregistrement lié à la ligne selectionnée, si la source est une table BDD ou une requête SQL |
Evènements de workflow
Nom | Description |
---|---|
Selection ligne | Déclenché lors de la selection d’une ligne dans la combo |
Après actualisation | Déclenché après récupération des données sur le serveur (en fonction du nombre de ligne à récupérer, cet évènement peu être déclenché après l’évènement “Initialisation”) |
Initialisation | Déclenché lorsque le composant est initialisé et affiché à l’écran |