Menu déroulant

La liste déroulante. Ses valeurs viennent d'une liste fixe, d'une fonction 4D ou d'une table de la base, et elle sait accepter plusieurs choix à la fois. La recherche au clavier est intégrée : sur une liste longue, c'est ce bloc qu'il faut plutôt qu'une série de cases à cocher.

Ce que c'est

Type	`fieldSelect`
Catégorie	form
Enfants autorisés	0
Cibles de style	bspk, select, label
Événements	onChange, onSearch

Les paramètres

Seuls les paramètres propres à ce bloc sont listés ici. Le nom du bloc, l'identifiant HTML, l'ancre, l'affichage conditionnel et la répétition sont communs à tous les blocs et décrits une seule fois, dans Les paramètres communs.

Paramètres

Paramètre	Comment ça se règle	À quoi ça sert	Particularités
Code 4D pour le nom du champ `vb_Use4dCode`	toggle (boolean)	Le nom du champ est une expression 4D évaluée au rendu : son résultat devient le nom du champ envoyé avec le formulaire	défaut : `non`
Nom du champ `vt_FieldName`	text (text)	—	obligatoire

Libellé & textes

Paramètre	Comment ça se règle	À quoi ça sert	Particularités
Code 4D pour le libellé `vb_Use4dCodeForLabel`	toggle (boolean)	—	défaut : `non`
Position du label `vl_LabelPosition`	checkbox (integer)	—	défaut : `0`
Libellé du champ `vt_FieldLabel`	text (text)	—	traduisible
Valeur première option `vt_LabelFirstOption`	text (text)	Texte affiché tant qu'aucune valeur n'est sélectionnée : c'est le placeholder de l'option vide.	traduisible

Remplissage

Paramètre	Comment ça se règle	À quoi ça sert	Particularités
Remplir par fonction `vb_UseFunction`	toggle (boolean)	Remplit la liste par une fonction 4D au lieu d'une liste figée. Exige le couple classe + fonction, et la fonction doit être référencée dans le registre : après l'avoir écrite, lancez un rafraîchissement du Storage, sinon elle n'apparaît pas.	défaut : `non`
Liste des valeurs possibles `vc_Values`	textarea (text)	Une valeur par ligne. Chaque ligne peut être une clé de traduction ou un texte libre.
Paramètres de la fonction `vo_ValuesParams`	functionParams (object)	—
Classe `vt_ValuesClass`	select (text)	—	obligatoire
Fonction `vt_ValuesFunction`	select (text)	—	obligatoire

Saisie & comportement

Paramètre	Comment ça se règle	À quoi ça sert	Particularités
Saisie libre `vb_Combobox`	toggle (boolean)	Le champ accepte une valeur hors liste : l'utilisateur peut saisir la sienne. À la relecture, une valeur absente de la liste y est réinjectée pour rester affichable.	défaut : `non`
choix multiple `vb_Multiple`	toggle (boolean)	—	défaut : `non`
Utiliser le rendu Tom Select `vb_TomSelect`	toggle (boolean)	—	défaut : `non`
Est lié a l'entité du module ? `vb_isLinkedToModuleEntity`	toggle (boolean)	—	défaut : `non`
Lié à un paramètre de l'url `vb_isLinkedToUrlParameter`	toggle (boolean)	—	défaut : `non`
Type du champ `vl_InputType`	select (integer)	—	défaut : `0`
Chemin de relation `vt_HowGetPk`	text (text)	Chemin depuis l'entité de la page vers celle qui porte réellement la valeur — ex. Entity.MonClient. Laissé vide, la valeur est lue sur l'entité de la page.
Nom du paramètre URL `vt_UrlParameterName`	text (text)	—
Valeur par défaut `vt_Value`	text (text)	—	traduisible
Valeur 4D `vt_Value4D`	text (text)	—	accepte du 4D

Validation

Paramètre	Comment ça se règle	À quoi ça sert	Particularités
Champ obligatoire `vb_Required`	toggle (boolean)	—	contrôle de sécurité, défaut : `non`
Condition d'obligation `vt_QueryRequired`	text (text)	N'est lue que si le champ est déjà marqué obligatoire : l'expression décide alors, à chaque validation, s'il l'est vraiment. Doit renvoyer un booléen. Ignorée lors d'un simple rechargement de bloc.

Les tableaux de cette page sont produits automatiquement depuis le schéma du bloc. Si la page et le panneau divergent, c'est le schéma qui fait foi.