Contrôle Texte-input dans Power Apps
Une zone dans laquelle l’utilisateur peut taper du texte, des nombres et d’autres données.
Description
L’utilisateur peut spécifier des données en tapant dans un contrôle Texte-input. 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 clés
Default : 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.
Align : emplacement du texte par rapport au centre horizontal de son contrôle.
BorderColor : couleur de bordure du contrôle.
BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.
BorderThickness : épaisseur de bordure d’un contrôle.
Clear : indique si un contrôle Texte-input affiche un « X » sur lequel l’utilisateur peut appuyer ou cliquer pour effacer le contenu de ce contrôle. Fonctionne uniquement en mode SingleLine.
Color : couleur du texte dans un contrôle.
DelayOutput : lorsque la valeur est définie sur true, l’entrée utilisateur est enregistrée après une demi-seconde. Cela peut être utile pour retarder les opérations coûteuses jusqu’à ce que l’utilisateur termine d’entrer du texte (p. ex. pour filtrer lorsque l’entrée est utilisée dans d’autres formules).
DisplayMode : indique si le contrôle autorise l’entrée utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).
DisabledBorderColor : couleur de bordure d’un contrôle si sa propriété DisplayMode est définie sur Disabled.
DisabledColor : couleur du texte d’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 : si un contrôle de saisie de texte doit utiliser la fonction de vérification orthographique du navigateur. Power Apps pour Windows ne prend pas en charge cette propriété.
Fill : couleur d’arrière-plan d’un contrôle.
FocusedBorderColor : couleur de bordure d’un contrôle lorsque le contrôle est actif.
FocusedBorderThickness : épaisseur de bordure d’un contrôle lorsque le contrôle est actif.
Font : nom de la famille de polices dans laquelle le texte s’affiche.
FontWeight : épaisseur du texte dans un contrôle : Gras, Semibold, Normal ou Plus claire.
Format : indique si l’entrée utilisateur est limitée aux chiffres 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 saisis. 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.
Height : distance entre le haut et le bas d’un contrôle.
HintText : texte gris clair qui apparaît dans un contrôle Texte-input s’il est vide.
HoverBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.
HoverColor : couleur du texte d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.
HoverFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.
Italic : indique si le texte d’un contrôle est en italique.
LineHeight : distance entre, par exemple, les lignes de texte ou les éléments d’une liste.
MaxLength : le nombre de caractères que l’utilisateur peut taper dans un contrôle Texte-input.
Mode : le contrôle est en mode SingleLine, MultiLine ou Password.
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 celui-ci.
PaddingRight : distance entre le texte d’un contrôle et le bord droit de celui-ci.
PaddingTop : distance entre le texte d’un contrôle et le bord supérieur de ce contrôle.
PressedBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur appuie ou clique dessus.
PressedColor : couleur de texte d’un contrôle lorsque l’utilisateur appuie ou clique dessus.
PressedFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur appuie ou clique dessus.
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.
Reset : indique si un contrôle revient à sa valeur par défaut.
Size : taille de police du texte qui apparaît sur un contrôle.
Barré : indique si une ligne s’affiche sur le texte qui apparaît sur un contrôle.
TabIndex : ordre de navigation à l’aide du clavier par rapport à d’autres contrôles.
Info-bulle : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.
Underline : indique si une ligne s’affiche sous le texte qui apparaît sur un contrôle.
VirtualKeyboardMode : type de clavier virtuel, texte ou numérique, qui apparaît 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 qui exécutent iOS doivent avoir au moins la version 12.2. La version recommandée de Android est 9.0, et les capacités des claviers numériques varient pour les dispositifs Android. Windows 10 ne prend pas en charge cette propriété.
Visible : indique si un contrôle est visible ou est masqué.
Width : distance entre les côtés droit et gauche 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 connexes
Exemples
Collecter des données
Ajoutez deux contrôles Texte-input et nommez-les inputFirst et inputLast.
Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?
Ajoutez un bouton, définissez sa propriété Texte sur Add, puis définissez sa propriété OnSelect sur la formule suivante :
Collect(Names, {FirstName:inputFirst.Texte, LastName:inputLast.Texte})Vous souhaitez obtenir davantage d’informations sur la fonction Collect ou d’autres fonctions ?
Ajouter une galerie de texte dans l’orientation verticale/portrait, définissez sa propriété Items sur Names et définissez la propriété Texte de Subtitle1 sur ThisItem.FirstName.
(facultatif) Dans la galerie de modèles, supprimez l’étiquette du bas, nommée Body1, et définissez la propriété TemplateSize de la galerie sur 80.
Appuyez sur F5, tapez une chaîne de texte dans inputFirst et inputLast, puis cliquez ou appuyez sur le bouton Ajouter.
(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
Ajoutez un contrôle Texte-input, nommez-le inputPassword et définissez sa propriété Mode sur Password.
Ajoutez un libellé et définissez sa propriété Texte sur la formule suivante :
If(inputPassword.Texte = "P@ssw0rd", "Access granted", "Access denied")Vous souhaitez davantage d’informations sur la fonction If ou d’autres fonctions ?
Appuyez sur F5, puis tapez P@ssw0rd dans inputPassword.
Quand vous terminez de taper le mot de passe, l’étiquette cesse d’afficher Accès refusé et commence à afficher Accès accordé.
Appuyez sur Échap pour revenir à l’espace de travail par défaut.
(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 a tapé le mot de passe.
(facultatif) Ajoutez un bouton, configurez sa propriété Texte pour qu’il affiche Se connecter, ajoutez une minuterie et désactivez le contrôle Texte-input pour un certain temps si l’utilisateur tape un mot de passe incorrect, puis clique ou appuie sur le bouton Se connecter.
Instructions d’accessibilité
Contraste des couleurs
- La configuration requise du contraste des couleurs standard s’applique.
Prise en charge du lecteur d’écran
- AccessibleLabel doit être présent.
Prise en charge du clavier
- TabIndex doit être égal ou supérieur à zéro afin que les utilisateurs du clavier puissent y accéder.
- Les indicateurs de focus doivent être clairement visibles. Pour ce faire, utilisez FocusedBorderColor et FocusedBorderThickness.
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).