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 techniqueTypeDescription
RecherchesearchEffectradiostrict, contain
Typevl_InputTypeselect0=select classique, 1=tom-select
Nom du champvt_FieldNametextNom technique
Code 4Dvb_Use4dCodecheckboxInterprète le code 4D
Libellévt_FieldLabeltextLabel affiché
Position labelvl_LabelPositionradio0=dessus, 1=flottant, 2=inline, 3=caché
Valeur 4Dvt_Value4DtextValeur via code 4D
Valeurvt_ValuetextValeur par défaut
Obligatoirevb_RequiredcheckboxChamp obligatoire
Label 1ère optionvt_LabelFirstOptiontextTexte de la première option (vide)
Lié à l'entitévb_isLinkedToModuleEntitycheckboxLie au module ORDA
Choix multiplevb_MultiplecheckboxSélection multiple
Tom Selectvb_TomSelectcheckboxActive le rendu Tom Select
Choix + saisie librevb_ComboboxcheckboxMode combobox (Tom Select)
Fonction pour listevb_UseFunctioncheckboxCharge les options via fonction 4D
Valeursvc_ValuestextareaListe 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.