Le widget Champ de texte est un élément d'entrée communément utilisé dans les formulaires. Vous pouvez le mettre en oeuvre afin de permettre aux utilisateurs de saisir du texte dans une application composite. Il est possible de définir ou de récupérer le texte dans le champ à l'aide de la propriété Text. Contrairement au widget Espace de texte, Champ de texte est limité à une seule ligne. Outre les propriétés communes du widget, vous pouvez le configurer à l'aide des propriétés de l'une des manières suivantes :

Vous pouvez utiliser les événements de widget suivants pour exécuter des services de données ou des fonctions lorsque la valeur du widget est mise à jour à l'exécution :

Le widget Champ de texte déclenche deux événements pouvant être liés :

Vous pouvez utiliser les événements du widget pour déclencher des fonctions, des services de données ou des services dans les widgets. Par exemple, vous pouvez lier les événements à une fonction Validateur afin de valider les entrées telles qu'elles ont été saisies ou lorsque vous appuyez sur la touche Entrée.

Vous pouvez activer la propriété ReadOnly afin d'empêcher toute modification du texte au moment de l'exécution. Par exemple, vous pouvez utiliser cette propriété pour empêcher les modifications jusqu'à ce qu'un bouton bascule soit activé ou qu'une case soit cochée dans l'application composite. Lorsque le mode lecture seule est activé, vous pouvez sélectionner et copier du texte, mais vous ne pouvez pas modifier, couper ni supprimer la valeur actuelle. Pour modifier la valeur textuelle d'un champ de texte en lecture seule, saisissez une valeur pour la propriété Text durant la phase de conception. Vous pouvez également lier une source de données à la propriété afin de modifier la valeur textuelle au moment de l'exécution.

Vous pouvez limiter l'entrée du champ de texte à un nombre spécifique de caractères en procédant de l'une des manières suivantes :

Pour ajouter un compteur qui affiche le nombre de caractères dans le champ de texte, définissez la propriété Counter sur vrai. La propriété MaxNumberOfCharacters est utilisée pour définir la limite de caractères, qui comprend les espaces. L'image ci-après illustre le widget Champ de texte avec un compteur visible et un nombre maximal de caractères de 10 :

Lorsque la limite de caractères est atteinte, la couleur du compteur change :

Vous pouvez activer la propriété ShowClearText afin d'ajouter un bouton de texte au champ d'entrée du widget. Le bouton s'affiche automatiquement sur le côté droit du widget lorsque le champ d'entrée contient une valeur. Cela permet aux utilisateurs de supprimer rapidement tout texte existant dans le widget.

Vous pouvez utiliser la propriété Icon pour afficher une icône dans le champ de texte. L'icône s'affiche automatiquement sur le côté gauche du widget. Vous pouvez sélectionner une icône parmi les icônes SVG fournies disponibles sur la plateforme. Pour plus d'informations sur ces icônes, consultez la rubrique Utilisation des icônes SVG.

Vous pouvez utiliser la propriété Mask afin de spécifier un modèle d'entrée pour les caractères numériques, alphabétiques et alphanumériques. Lorsque vous définissez un modèle, des guides de marque de réservation sont ajoutés à la zone d'entrée. Les guides sont des lignes permettant d'indiquer le modèle de texte qu'un utilisateur peut entrer dans le champ de texte. En plus du modèle requis, la propriété définit le nombre de caractères dans le champ de texte. Vous pouvez créer des modèles à l'aide des caractères spéciaux suivants :

Pour créer un modèle, combinez les caractères spéciaux dans une chaîne qui représente l'entrée requise. Par exemple, les modèles suivants représentent différents types d'entrées :

L'image ci-après illustre les guides d'un modèle numérique 999–999–999–999 contenant quatre nombres à trois chiffres au moment de l'exécution :

Le modèle permet de définir le format du nombre en plus du nombre de chiffres requis. Dans cet exemple, vous pouvez saisir n'importe quel nombre à 12 chiffres, tel que 256120233234. Au fur et à mesure de votre saisie, les guides de trait de soulignement (_) sont remplacés par des chiffres.

Les guides d'indicateur s'affichent en fonction du nombre total de caractères que vous avez définis dans le modèle durant la phase de conception. Lorsque vous entrez un nombre comportant moins de chiffres que le modèle, l'entrée reste incomplète. Vous devez utiliser le masque pour définir des modèles avec un nombre de caractères spécifique, tel qu'un numéro de téléphone ou des codes postaux. Evitez d'utiliser un masque lorsque l'entrée n'est pas un nombre spécifique de caractères, tel qu'un montant monétaire.

Les propriétés du widget Champ de texte sont répertoriées ci-dessous.

Outre les propriétés communes, vous pouvez utiliser les propriétés de validation MaxLength et MinLength pour valider le nombre de caractères dans le widget Champ de texte.

Vous pouvez personnaliser les messages d'échec par défaut à l'aide des propriétés MaxLengthFailureMessage et MinLengthFailureMessage. Les valeurs maximale et minimale sont affichées dans les messages à l'aide du paramètre ${value}.

Pour plus d'informations sur l'utilisation des propriétés de validation courantes, consultez la rubrique Application de la validation aux widgets.

La table suivante répertorie les propriétés de validation disponibles dans le panneau Validation de ThingWorx 9.3.4 ou version ultérieure.