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`
Couleur du texte `vb_RichTextColors`	toggle (boolean)	Ajoute à la barre d'outils le choix de la couleur du texte. Décoché, l'éditeur ne connaît pas la couleur : un texte coloré collé dans le champ perd sa couleur	défaut : `non`
Surlignage `vb_RichTextHighlight`	toggle (boolean)	Ajoute à la barre d'outils le surlignage (couleur de fond du texte). Décoché, un surlignage collé dans le champ est retiré	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
Choix de la couleur du texte `vt_RichTextColorMode`	select (text)	—	défaut : `palette`
Palette de couleurs du texte `vt_RichTextColorPalette`	colorList (text)	Couleurs proposées dans la barre d'outils, dans l'ordre affiché (glisser-déposer pour le changer). Sans couleur choisie : palette par défaut. En mode « Palette de couleurs », seules ces couleurs sont acceptées, y compris dans un texte collé
Choix de la couleur de surlignage `vt_RichTextHighlightMode`	select (text)	—	défaut : `palette`
Palette de surlignage `vt_RichTextHighlightPalette`	colorList (text)	Couleurs proposées dans la barre d'outils, dans l'ordre affiché (glisser-déposer pour le changer). Sans couleur choisie : palette par défaut. En mode « Palette de couleurs », seules ces couleurs sont acceptées, y compris dans un texte collé
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`
Longueur maximale `vl_MaxLength`	number (integer)	Nombre maximal de caractères saisis (attribut maxlength), contrôlé aussi à l'enregistrement. À caler sur la taille du champ Alpha qui reçoit la valeur : 4D coupe sans message ce qui dépasse. Vide ou 0 = pas de limite. Sans effet sur l'éditeur enrichi	contrôle de sécurité
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

Pièges

4D coupe sans prévenir une valeur trop longue pour un champ Alpha. Si le champ de la table qui reçoit la saisie est un Alpha de 62 caractères, une adresse de 70 caractères est enregistrée amputée de ses 8 derniers, sans aucun message ni à l'écran, ni dans les journaux. Renseignez la longueur maximale du champ de saisie avec la taille du champ Alpha (visible dans l'éditeur de structure) : le navigateur bloque la frappe au-delà, et l'enregistrement refuse une valeur plus longue envoyée autrement. Un champ Texte n'a pas de limite. La longueur maximale est sans effet sur l'éditeur de texte riche.

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.