Dans un formulaire, un composant Champ de texte limité permet de créer les champs d'entrée du formulaire, tels que le nom, le prénom, l'e-mail, le mot de passe, etc. Ce composant permet d'accéder à toutes les propriétés du champ de texte limité, y compris au libellé qui l'accompagne et aux règles de validation qui s'appliquent aux valeurs saisies.
Remarque: Le composant Champ de texte limité est multilingue. Tous les textes traduisibles peuvent être créés en plusieurs langues, notamment le libellé du champ, le texte de l'Espace réservé et les règles de validation.
Quand vous faites glisser un composant Champ de texte limité sur le formulaire, vous devez saisir l'ID de ce champ de texte et cliquer sur OK. Le résultat se présente comme suit:
Une balise input de type Texte est ajoutée. L'ID du composant est utilisé dans la section Composants disponibles à droite. Il permet d'identifier facilement le composant dans la liste est d'accéder aux propriétés.
Remarque: Si un composant Champ de texte limité est ajouté et qu'aucune balise de formulaire n'est encore disponible, le système en crée une automatiquement.
Propriétés du champ de texte limité
Cliquez sur la balise input dans la page ou sur l'élément dans la liste des composants disponibles à droite pour accéder aux propriétés. Pour chaque propriété définie, les informations sont ajoutées automatiquement au code source:
Lecture seule — Activez cette option si le champ est en lecture seule.
Nom — Nom du composant Champ de texte limité. Il permet de récupérer la valeur publiée de ce champ de formulaire. Une liste déroulante contient tous les champs de la liste d'audience et des listes liées. Sélectionnez celui qui correspond à votre champ de texte limité (Prénom, par exemple). Après la sélection du champ, la fonction suivante est ajoutée dans le code source (lorsque 'firstname' est sélectionné) : "[%loadValue(requestValue('FIRSTNAME'),'FIRSTNAME','')%]". La propriété Valeur est également complétée avec cette même fonction.
Type — Type du champ Champ de texte limité. Cette information est complétée automatiquement dès qu'un champ est sélectionné dans la liste d'audience ou la liste étendue. Vous pouvez choisir entre TEXTE, E-MAIL, NOMBRE, MASQUÉ ou MOT DE PASSE. Le type définit le comportement du champ, par exemple les champs de mot de passe affichent**** et les champs d'e-mail exigent un format ou un contenu spécifique.
Longueur maximum — Longueur maximum autorisée pour le texte publié. Ces informations sont complétées automatiquement dès qu'un champ est sélectionné.
Valeur par défaut — Valeur par défaut affichée dans le champ Champ de texte limité. Cette propriété, complétée automatiquement dès qu'un champ est sélectionné pour la propriété Nom, contient le code suivant (lorsque 'firstname' est sélectionné) : [%loadValue(requestValue('FIRSTNAME'),'FIRSTNAME','')%]. Autrement dit, lorsque vous revenez au formulaire après sa publication avec erreurs, la valeur publiée s'affiche dans le formulaire comme valeur par défaut du champ Prénom. Si elle n'est pas disponible, c'est la valeur de la base de données pour ce champ qui devient la valeur par défaut. Si aucune n'est disponible, le champ Champ de texte limité reste vierge.
Propriétés multilingues
Tous les champs traduisibles sont répertoriés dans cette section. Pour définir la valeur dans une langue différente, sélectionnez la langue dans la liste déroulante de la barre d'outils et saisissez la valeur traduite.
Libellé — Ce qui s'affiche devant le champ de texte limité.
Texte de l'Espace réservé — Texte affiché dans le champ, en principe une instruction du type Saisissez votre e-mail.
Règles de validation
Règles de validation — Permettent de valider la valeur publiée et d'afficher un message d'erreur en cas d'échec de validation. Si des règles multiples sont définies et que plusieurs d'entre elles échouent, tous les messages correspondants sont répertoriés. Les options de validation diffèrent selon le type de champ.
Texte, Mot de passe — Vérifie que le champ n'est pas vide, s'il est égal ou s'il n'est pas égal à une valeur donnée
E-mail — Vérifie que le champ n'est pas vide, si l'e-mail est valide et s'il est égal ou s'il n'est pas égal à une valeur donnée
Nombre — Vérifie que le champ n'est pas vide, qu'un nombre a été saisi et s'il est supérieur, inférieur ou égal à une valeur donnée
Pour créer une règle, cliquez sur le Crayon à côté de l'entrée Règles de validation. Une boîte de dialogue s'affiche. Dans l'exemple ci-dessous, le champ ne peut être vide. Le message s'affiche si le champ est réellement vide.
Si la page est créée dans plusieurs langues, les messages pour les autres langues peuvent être saisis directement dans cette boîte de dialogue, une fois la langue sélectionnée dans le menu supérieur de la boîte de dialogue.
Une fois les règles de validation paramétrées, cliquez sur Appliquer. Les règles sont maintenant répertoriées dans la section Règles de validation de la fenêtre des propriétés du champ. Cliquez sur une règle pour accéder directement à la boîte de dialogue Règles de validation dans laquelle vous pouvez effectuer les modifications nécessaires.
Remarque : Lorsque vous créez ou mettez à jour des règles de validation de formulaire sur une page qui est déjà utilisée dans un ou plusieurs journey, ces journeys doivent être publiés pour que les modifications prennent effet.
Copier le contenu du Composant Texte Limité vers d'autres langues
Par défaut, lorsque vous ajoutez de nouveaux Composants Contenu à un message, seule la structure du composant est copiée automatiquement dans d'autres langues. Cependant, en utilisant la fonction Copier le contenu vers d'autres langues, vous pouvez maintenant copier le composant avec son contenu vers une ou plusieurs langues.
Cette option est disponible une fois que le composant est placé sur le message et que plusieurs langues ont été définies pour le message.
Cliquez sur le bouton Copier le contenu dans d'autres langues dans les propriétés du composant.
La boîte de dialogue qui s'affiche permet de sélectionner des langues cibles.
