Documentation en ligne

Champ texte

Le champ « Texte (ligne) » est dédié à la saisie d'un texte libre, tenant sur une ligne.

Un texte libre peut comprendre des lettres, des chiffres et des caractères spéciaux.

Contrôle de ce qui est saisi dans le champ

L'option « Validation » permet de faire porter un contrôle sur le champ pour vérifier que les données saisies correspondent bien au format attendu pour. Il est donc possible de contrôler que ce qui a été saisi est bien :

  • des chiffres
  • un numéro de téléphone international
  • un numéro de téléphone français
  • un numéro de mobile (numéro de mobile correspondant au pays configuré par l'administrateur dans « Système » dans les options SMS - par défaut la France)
  • un code postal
  • un SIRET
  • un SIREN
  • un numéro de sécurité sociale français
  • un numéro de registre national belge
  • un IBAN
  • Heure (cette validation permet au navigateur de comprendre qu'il s'agit d'un champ horaire et d'adapter son comportement - avec un téléphone mobile on aura par exemple l'affichage d'une horloge pour sélectionner l'heure).

Il est également possible de contrôler la saisie par le biais d'une validation (en Django) ou en utilisant une expression rationnelle (en respectant la syntaxe des expressions régulières Python).

Exemples de validation Django :

  • value|decimal > 60 : la valeur est supérieure à 60
  • value|length < 50 : la valeur fait moins de 50 caractères
  • value == "oui" : la valeur est exactement « oui »

« value » est le terme exact à utiliser, il représente la valeur du champ courant.

Pour en savoir plus sur la syntaxe des conditions, reportez-vous à cette page.

Exemples d'expressions régulières :

  • \d+(?:[.,]\d+)?$ : nombre à virgule (le séparateur peut être une virgule ou un point)

  • ((0[1-9])|([13-8][0-9])|(2[1-9AB])|(9[0-5]))([0-9]{3}) : code postal France métropolitaine

  • (([9][7][0-8])|([9][8][0-5]))([0-9]{2}) : code postal Dom-Tom

  • ^([0-1][0-9]|2[0-3]):[0-5][0-9]$ : heures et minutes

  • ^([0-1][0-9]|2[0-3])[H;h][0-5][0-9]$ : heures minutes avec le format de type 11h30 ou 11H30

  • [A-Z '-]+ : texte seulement en majuscules et espace, apostrophe, tiret et au moins un caractère

  • [A-Z ÀÂÄÇÉÈÊËÎÏÔÖÙÛÜŸÆŒ '-]+ : idem mais avec majuscules accentuées, champ vide possible (de 0 à n caractères)

Il existe des sites d'explication des expressions régulières (regex) en python ainsi que des sites pour valider vos expressions régulières.

Il est possible d'ajouter à ces contrôles un message d'erreur. Lorsque ce qui est saisi ne correspond pas à ce qui est demandé, le message d'erreur ainsi paramétré sera affiché.

On peut également paramétrer un nombre maximum de caractères. Cela va par exemple permettre d'empêcher de saisir plus de 10 caractères.

Paramètres génériques des champs

Dernière mise à jour le 21 décembre 2023 13:15 — Éditer