Champ de saisie

Le champ de saisie à tout faire. Son type d'entrée décide de ce qu'il devient : texte simple, nombre, date, heure, zone de texte multiligne ou éditeur de texte riche. C'est donc le bloc le plus souvent posé d'un formulaire, et celui dont il faut lire les paramètres en entier au moins une fois.

Ce que c'est

Type	`fieldText`
Catégorie	form
Enfants autorisés	0
Cibles de style	bspk, input, label
Événements	onChange, onInput

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`
Type du champ `vl_InputType`	select (integer)	—	défaut : `0`
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`
Texte explicatif `vt_ExplanatoryText`	text (text)	Affiche une icône « ? » à côté du libellé du champ ; ce texte apparaît en infobulle au survol (comme celle-ci)	traduisible
Libellé du champ `vt_FieldLabel`	text (text)	—	traduisible
Texte indicatif `vt_FieldPlaceholder`	text (text)	Texte grisé affiché DANS le champ, qui disparaît dès que l'on commence à saisir (placeholder HTML)	traduisible

Saisie & comportement

Paramètre	Comment ça se règle	À quoi ça sert	Particularités
Accepter une valeur vide `vb_AcceptEmptyValue`	toggle (boolean)	—	défaut : `non`
Multilingue `vb_MultiLang`	toggle (boolean)	—	défaut : `non`
Enlever l'autocomplétion `vb_RemoveAutocomplete`	toggle (boolean)	—	défaut : `non`
Redimensionnable `vb_Resize`	toggle (boolean)	—	défaut : `non`
Éditeur de texte enrichi `vb_RichText`	toggle (boolean)	Remplace la zone de saisie par l'éditeur de texte enrichi du dev-panel (gras, titres, listes, liens…). Le contenu est envoyé en HTML encodé en base64 dans le champ — à décoder côté 4D. Pour un autre éditeur, laisser décoché et l'installer via custom.js	défaut : `non`
Bouton afficher le mot de passe `vb_ToggleShowPassword`	toggle (boolean)	—	défaut : `non`
Utiliser 4D pour la valeur par défaut `vb_Use4DForDefaultValue`	toggle (boolean)	—	défaut : `non`
Est lié a l'entité du module ? `vb_isLinkedToModuleEntity`	toggle (boolean)	Lie le champ à l'entité du module de la page (fiche) : la valeur est pré-remplie depuis l'entité et renvoyée avec le formulaire pour la mettre à jour. Ne fonctionne que sur une page de module avec une entité chargée	défaut : `non`
Pas: Nombre max `vl_InputNumericMax`	number (integer)	—
Pas: Nombre min `vl_InputNumericMin`	number (integer)	—
Pas d'incrémentation `vl_InputNumericStep`	number (integer)	—
Nombre de lignes `vl_Rows`	number (integer)	—
Chemin de relation `vt_HowGetPk`	text (text)	Expression 4D optionnelle qui renvoie l'entité à lier (ex. ds.CLIENT.get(...)). Laisser vide = entité courante de la page module
Valeur par défaut `vt_Value`	text (text)	—
Chemin dans l'objet `vt_pathInObject`	text (text)	Pour un champ lié à une entité : chemin de l'attribut OBJET dans lequel lire/écrire la valeur. La valeur devient Entité.chemin.nomDuChamp (ex. nom du champ = phone, chemin = contact → Entité.contact.phone). Laisser vide si le champ correspond directement à un attribut de l'entité

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`
Validation (regex) `vt_PregMatch`	select (text)	—	liste ouverte
Requête d'obligation `vt_QueryRequired`	text (text)	Expression 4D évaluée au rendu : si elle renvoie Vrai, le champ devient obligatoire (obligation conditionnelle). Ex. : WebUser.role = « admin ». Laisser vide = toujours obligatoire

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.