Menu déroulant
Description
Le Menu déroulant (fieldSelect) permet de choisir une ou plusieurs valeurs dans une liste. Il supporte deux modes : select classique HTML et Tom Select (composant enrichi avec recherche).
Les options peuvent être définies statiquement (vc_Values) ou chargées dynamiquement via une fonction 4D. Le mode combobox permet la saisie libre en plus de la sélection.
| Propriété | Champ technique | Type | Description |
|---|---|---|---|
| Recherche | searchEffect | radio | strict, contain |
| Type | vl_InputType | select | 0=select classique, 1=tom-select |
| Nom du champ | vt_FieldName | text | Nom technique |
| Code 4D | vb_Use4dCode | checkbox | Interprète le code 4D |
| Libellé | vt_FieldLabel | text | Label affiché |
| Position label | vl_LabelPosition | radio | 0=dessus, 1=flottant, 2=inline, 3=caché |
| Valeur 4D | vt_Value4D | text | Valeur via code 4D |
| Valeur | vt_Value | text | Valeur par défaut |
| Obligatoire | vb_Required | checkbox | Champ obligatoire |
| Label 1ère option | vt_LabelFirstOption | text | Texte de la première option (vide) |
| Lié à l'entité | vb_isLinkedToModuleEntity | checkbox | Lie au module ORDA |
| Choix multiple | vb_Multiple | checkbox | Sélection multiple |
| Tom Select | vb_TomSelect | checkbox | Active le rendu Tom Select |
| Choix + saisie libre | vb_Combobox | checkbox | Mode combobox (Tom Select) |
| Fonction pour liste | vb_UseFunction | checkbox | Charge les options via fonction 4D |
| Valeurs | vc_Values | textarea | Liste des valeurs (format JSON ou texte) |
Événements supportés :
on-change — Déclenché au changement de sélection
on-dblclick — Déclenché au double-clic
on-Search — Déclenché lors d'une recherche (Tom Select)

Paramètres
Type du champ
Permet de configurer le type de la valeur en entrée.
Nom du champ
Permet de configurer le nom et l’id du bloc input du champ de saisie.
Libellé du champ
Désigne le label du titre du champ de saisie. Peut être une clé de traduction.
Position du label
Permet de modifier la position du texte saisi en paramètre dans ‘libellé du champ’.
Valeur 4D
Exécute du code 4D pour récupérer une valeur.
Valeur par défaut
Rempli le champ avec la valeur par défault.
Champ obligatoire
Indique si le champ doit obligatoirement être rempli ( une petite étoile rouge apparaît pour l’indiquer a l’utilisateur ).
Est lié a l'entité du module ?
Si coché, indique que le champ est une propriété de l’entité du module.
Si besoin préciser le chemin de relation (ex: Entity.MaRelation)
Nécessite 'est lié a l'entité du module ?'
Permet de lier le champ a une autre entité que celle du module en passant par une relation.
Lié à un paramètre de l'url
Si coché, essaye d'aller chercher une valeur dans le paramètre de l'url ( aprés le '?' ).
Nom du paramètre URL
Nécessite 'Lié a un paramètre de l'url'
Nom du paramètre.
choix multiple
Autorise l'utilisateur a choisir plusieurs options dans le select.
Utiliser le rendu Tom Select
Nécessite 'nom du champ' de renseigné
Si coché, transforme le select en un objet Tom Select.
Choix + saisie libre (utilise Tom Select)
Nécessite 'utiliser le rendu tom select'
Autorise l'utilisateur à ajouter des valeurs possibles dans le tom select
Utiliser une fonction pour récupérer les éléments de la liste
Si coché, fait apparaitre des nouveaux paramètres, permettant de récupérer les éléments de la liste.
Classe
Nécessite 'utiliser une fonction pour récuperer les éléments de la liste'
Incompatible avec 'liste de valeurs possible'
Permet de choisir la classe dans laquelle se trouve la fonction.
Fonction
Nécessite 'utiliser une fonction pour récuperer les éléments de la liste'
Incompatible avec 'liste de valeurs possible'
Permet de choisir le nom de la fonction parmi les éléments du select.
Liste des valeurs possibles
Incompatible avec 'Class' et 'Fonction'
Permet de saisir la liste des éléments en dur dans la propriété, chaque valeur doit avoir un retour à la ligne entre-elle.

