Contrôle d’étiquette dans Power Apps

Une zone qui affiche des données comme du texte, des nombres, des dates ou des devises.

Descriptif

Une étiquette affiche les données que vous spécifiez comme une chaîne littérale de texte, qui apparaît exactement comme vous le tapez, ou sous la forme d’une formule qui prend la valeur d’une chaîne de texte. Les Étiquettes apparaissent souvent en dehors des autres contrôles (par exemple une bannière qui identifie un écran), sous la forme d’une Étiquette qui identifie un autre contrôle (par exemple un contrôle Évaluation ou Audio), ou dans une galerie pour afficher un type spécifique d’informations sur un élément.

Propriétés clés

AutoHeight : défini sur true pour permettre à l’étiquette de développer automatiquement sa hauteur pour afficher tout le texte. Définissez la valeur false pour tronquer le texte à la hauteur affectée.

Couleur : couleur du texte dans un contrôle.

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

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

DelayOutput : définissez la valeur true pour retarder l’action pendant l’entrée de texte.

Propriétés supplémentaires

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

AutoHeight : indique si une étiquette augmente automatiquement sa propriété Height si sa propriété Text contient plus de caractères que le contrôle peut afficher à la fois. Si le contrôle n’est pas visible, la propriété de sortie Height ne sera pas mise à jour à mesure que le texte change.

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.

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.

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é.

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

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

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.

En direct : comment un lecteur d’écran annonce les modifications apportées à la valeur de la propriété Text de l’étiquette.

• Lorsque la valeur est Désactivée, le lecteur d’écran n’annonce pas les modifications.
• Lorsqu’il est défini sur Poli, le lecteur d’écran termine son discours avant d’annoncer les modifications qui se sont produites pendant que le lecteur d’écran parlait.
• Lorsqu’il est défini sur Assertive, le lecteur d’écran s’interrompt pour annoncer les modifications qui se sont produites pendant que le lecteur d’écran parlait.

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

Dépassement de capacité : indique si une barre de défilement apparaît dans une étiquette si sa propriété Wrap a la valeur true et que la valeur de la propriété Text du contrôle contient plus de caractères que le contrôle peut s’afficher à la fois.

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.

Rôle : rôle sémantique du texte de l’étiquette, tel que Titre 1. Ne modifie pas le style de l’étiquette, mais rend la sortie sémantiquement correcte pour l’interprétation par les lecteurs d’écran.

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.

VerticalAlign : emplacement du texte sur un contrôle par rapport au centre vertical de ce contrôle.

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

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

Habillage : indique si le texte doit être encapsulé à plusieurs lignes.

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

Text( Number, « FormatCodes » )

Examples

Afficher une chaîne littérale

• Ajoutez une étiquette et définissez sa propriété Text sur « Hello, world » (y compris les guillemets doubles).

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

Afficher le résultat d’une formule

• Ajoutez une étiquette et définissez sa propriété Text sur une formule telle que celle-ci :
  Aujourd’hui()

  Note

  Lorsque vous spécifiez une formule, vous n’utilisez pas de guillemets, sauf si un argument de la formule est une chaîne littérale. Dans ce cas, placez l’argument, et non la formule, entre guillemets doubles.

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

Afficher les données dans une galerie

Dans cette procédure, vous allez créer une collection, appelée CityPopulations, qui contient des données sur la population de différentes villes en Europe. Ensuite, vous allez afficher ces données dans une galerie qui contient trois étiquettes, et vous spécifiez le type de données que chaque étiquette affichera.

1. Ajoutez un bouton, puis définissez sa propriété OnSelect sur la formule suivante :
   ClearCollect(CityPopulations, {City :"London », Country :"United Kingdom », Population :8615000}, {City :"Berlin », Country :"Germany », Population :3562000}, {City :"Madrid », Country :"Spain », Population :3165000}, {City :"Rome », Pays :"Italie », Population :2874000}, {City :"Paris », Country :"France », Population :2273000}, {City :"Hambourg », Country :"Germany », Population :176000}, {City :"Barcelone », Country :"Espagne », Population :1602000}, {City :"Munich », Country :"Germany », Population :"Allemagne »,:1494000}, {City :"Milan », Country :"Italy », Population :1344000})

2. Appuyez sur F5, sélectionnez le bouton, puis appuyez sur Échap.

3. Ajoutez une galerie de texte et définissez sa propriété Items sur CityPopulations.

   Lorsque la galerie est sélectionnée, le volet droit affiche les options de cette galerie.

4. Dans le volet Galerie1 , définissez la liste supérieure sur Population, définissez la liste intermédiaire sur Ville et définissez la liste inférieure sur Country.

Conseils sur l’accessibilité

Malgré son nom, un contrôle Label n’a pas besoin d’être utilisé comme étiquette pour un autre contrôle. Il peut être utilisé pour afficher n’importe quel élément de texte.

Une étiquette peut être utilisée en tant que bouton ou lien en spécifiant le comportement OnSelect . Lorsqu’elle est utilisée de cette façon, il existe des considérations d’accessibilité similaires à celles des boutons.

Contraste des couleurs

Il doit y avoir un contraste de couleur adéquat entre :

• Couleur et remplissage
• D’autres exigences de contraste de couleur standard s’appliquent (si elles sont utilisées en tant que bouton ou lien)

Prise en charge du lecteur d’écran

• Le texte doit être présent.

• Live doit être défini sur Polite ou Assertive si un lecteur d’écran doit annoncer les modifications apportées à la valeur de la propriété Text .

  Note

  Les lecteurs d’écran traitent lesétiquettes comme des boutons lorsque TabIndex est égal à zéro ou supérieur.

Prise en charge de la faible vision

• L’étiquette doit ressembler à un lien, s’il est utilisé comme lien.
  • Définir le trait de soulignement sur true
  • HoverColor doit être différent de Color

Prise en charge du clavier

• TabIndex doit être égal à zéro ou supérieur, si le texte est utilisé comme bouton ou lien. Cela permet aux utilisateurs du clavier d’y accéder.
• Les indicateurs de focus doivent être clairement visibles si le texte est utilisé comme bouton ou lien. Utilisez FocusBorderColor et FocusBorderThickness pour y parvenir.