Contrôle d’entrée de texte dans Power Apps

Une zone dans laquelle l’utilisateur peut saisir du texte, des nombres et d’autres données.

Descriptif

L’utilisateur peut spécifier des données en tapant dans un contrôle d’entrée de texte. Selon la configuration de l’application, ces données peuvent être ajoutées à une source de données, utilisées pour calculer une valeur temporaire ou incorporées d’une autre façon.

Propriétés principales

Valeur par défaut : valeur initiale d’un contrôle avant sa modification par l’utilisateur.

Texte : texte qui apparaît sur un contrôle ou que l’utilisateur tape dans un contrôle.

Propriétés supplémentaires

AccessibleLabel : étiquette pour les lecteurs d’écran.

Aligner : emplacement du texte par rapport au centre horizontal de son contrôle.

BorderColor : couleur de la bordure d’un contrôle.

BorderStyle : indique si la bordure d’un contrôle est Solid, Dashed, Dotted ou None.

BorderThickness : épaisseur de la bordure d’un contrôle.

Effacer : indique si un contrôle d’entrée de texte affiche un « X » que l’utilisateur peut appuyer ou cliquer pour effacer le contenu de ce contrôle. Fonctionne uniquement en mode SingleLine .

Couleur : couleur du texte dans un contrôle.

DelayOutput : lorsqu’elle est définie sur true, l’entrée utilisateur est inscrite après la moitié d’un deuxième délai. Utile pour retarder les opérations coûteuses jusqu’à ce que l’utilisateur termine l’insertion de texte (c’est-à-dire pour le filtrage lorsque l’entrée est utilisée dans d’autres formules).

DisplayMode : indique si le contrôle autorise l’entrée utilisateur (Modifier), affiche uniquement les données (Affichage) ou est désactivé (Désactivé).

DisabledBorderColor : couleur de la bordure d’un contrôle si la propriété DisplayMode du contrôle a la valeur Disabled.

DisabledColor : couleur du texte dans un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledFill : couleur d’arrière-plan d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

EnableSpellCheck : indique si un contrôle d’entrée de texte doit utiliser la fonction de vérification orthographique du navigateur. Power Apps pour Windows ne prend pas en charge cette propriété.

Remplissage : couleur d’arrière-plan d’un contrôle.

FocusBorderColor : couleur de la bordure d’un contrôle lorsque le contrôle est concentré.

FocusBorderThickness : épaisseur de la bordure d’un contrôle lorsque le contrôle est concentré.

Police : nom de la famille de polices dans laquelle le texte apparaît.

FontWeight : poids du texte dans un contrôle : Gras, Semibold, Normal ou Plus léger.

Format : indique si l’entrée utilisateur est limitée aux nombres uniquement ou peut être n’importe quel texte. Lorsqu’il est défini sur Nombre, seuls les chiffres et certains symboles numériques peuvent être entrés. Les symboles et formats pris en charge dépendent de la langue du navigateur et ne peuvent pas être définis sur des contrôles individuels.

Hauteur : distance entre les bords supérieurs et inférieurs d’un contrôle.

HintText : texte gris clair qui apparaît dans un contrôle de texte d’entrée s’il est vide.

HoverBorderColor : couleur de la bordure d’un contrôle lorsque l’utilisateur conserve le pointeur de la souris sur ce contrôle.

HoverColor : couleur du texte dans un contrôle lorsque l’utilisateur conserve le pointeur de la souris dessus.

HoverFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur conserve le pointeur de la souris dessus.

Italique : indique si le texte d’un contrôle est italique.

LineHeight : distance entre, par exemple, les lignes de texte ou d’éléments d’une liste.

MaxLength : nombre de caractères que l’utilisateur peut taper dans un contrôle d’entrée de texte.

Mode : le contrôle est en mode SingleLine, Multiligne ou Mot de passe .

OnChange : actions à effectuer lorsque l’utilisateur modifie la valeur d’un contrôle (par exemple, en ajustant un curseur).

OnSelect : actions à effectuer lorsque l’utilisateur appuie ou clique sur un contrôle.

PaddingBottom : distance entre le texte d’un contrôle et le bord inférieur de ce contrôle.

PaddingLeft : distance entre le texte d’un contrôle et le bord gauche de ce contrôle.

PaddingRight : distance entre le texte d’un contrôle et le bord droit de ce contrôle.

PaddingTop : distance entre le texte d’un contrôle et le bord supérieur de ce contrôle.

PressedBorderColor : couleur de la bordure d’un contrôle lorsque l’utilisateur appuie ou clique sur ce contrôle.

PressedColor : couleur du texte dans un contrôle lorsque l’utilisateur appuie ou clique sur ce contrôle.

PressedFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur appuie ou clique sur ce contrôle.

RadiusBottomLeft : degré auquel le coin inférieur gauche d’un contrôle est arrondi.

RadiusBottomRight : degré auquel le coin inférieur droit d’un contrôle est arrondi.

RadiusTopLeft : degré auquel le coin supérieur gauche d’un contrôle est arrondi.

RadiusTopRight : degré auquel le coin supérieur droit d’un contrôle est arrondi.

Réinitialiser : indique si un contrôle revient à sa valeur par défaut.

Taille : taille de police du texte qui apparaît sur un contrôle.

Barre d’accès : indique si une ligne s’affiche via le texte qui apparaît sur un contrôle.

TabIndex : ordre de navigation clavier par rapport à d’autres contrôles.

Info-bulle : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.

Soulignement : indique si une ligne apparaît sous le texte qui apparaît sur un contrôle.

VirtualKeyboardMode : type de clavier virtuel, de texte ou numérique qui s’affiche sur l’écran tactile d’un utilisateur d’application. La propriété Format détermine la valeur par défaut. La prise en charge des appareils varie. Les appareils exécutant iOS doivent avoir au moins la version 12.2. La version recommandée d’Android est 9.0 et les fonctionnalités des claviers numériques varient pour les appareils Android. Windows 10 ne prend pas en charge cette propriété.

Visible : indique si un contrôle apparaît ou est masqué.

Largeur : distance entre les bords gauche et droit d’un contrôle.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou de l’écran à défaut de conteneur parent).

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou de l’écran à défaut de conteneur parent).

Fonctions associées

DateTimeValue( String )

Examples

Collecter les données

1. Ajoutez deux contrôles d’entrée de texte et nommez-les inputFirst et inputLast.

   Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?

2. Ajoutez un bouton, définissez sa propriété Text sur Ajouter et définissez sa propriété OnSelect sur cette formule :
   Collect(Names, {FirstName :inputFirst.Text, LastName :inputLast.Text})

   Vous souhaitez plus d’informations sur la fonction Collect ou d’autres fonctions ?

3. Ajoutez une galerie de texte en orientation portrait/verticale, définissez sa propriété Items sur Names et définissez la propriété Text de Subtitle1 sur ThisItem.FirstName.

4. (facultatif) Dans la galerie de modèles, supprimez l’étiquette inférieure, nommée Body1 et définissez la propriété TemplateSize de la galerie sur 80.

5. Appuyez sur F5, tapez une chaîne de texte dans inputFirst et inputLast, puis cliquez ou appuyez sur le bouton Ajouter .

6. (facultatif) Ajoutez d’autres noms à la collection, puis appuyez sur Échap pour revenir à l’espace de travail par défaut.

Demander un mot de passe

1. Ajoutez un contrôle d’entrée de texte, nommez-le inputPassword et définissez sa propriété Mode sur Mot de passe.

2. Ajoutez un libellé et définissez sa propriété Text sur la formule suivante :
   If(inputPassword.Text = « P@ssw0rd », « Accès accordé », « Accès refusé »)

   Vous souhaitez plus d’informations sur la fonction If ou d’autres fonctions ?

3. Appuyez sur F5, puis tapez P@ssw0rd dans inputPassword.

   Lorsque vous avez terminé de taper le mot de passe, l’étiquette cesse d’afficher Access refusé et commence à afficher Access accordé.

4. Pour revenir à l’espace de travail par défaut, appuyez sur Échap.

5. (facultatif) Ajoutez un contrôle tel qu’une flèche, configurez-le pour accéder à un autre écran et affichez-le uniquement après que l’utilisateur tape le mot de passe.

6. (facultatif) Ajoutez un bouton, configurez sa propriété Text pour afficher la connexion, ajoutez un minuteur et désactivez le contrôle entrée-texte pendant un certain temps si l’utilisateur tape le mot de passe incorrect, puis clique ou appuie sur le bouton Se connecter.

Conseils sur l’accessibilité

Contraste des couleurs

• Les exigences de contraste de couleur standard s’appliquent.

Prise en charge du lecteur d’écran

• AccessibleLabel doit être présent.

Prise en charge du clavier

• TabIndex doit être égal à zéro ou supérieur afin que les utilisateurs du clavier puissent y accéder.
• Les indicateurs de focus doivent être clairement visibles. Utilisez FocusBorderColor et FocusBorderThickness pour y parvenir.