Contrôle Étiquette dans Power Apps

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

Description

Une Étiquette montre les données que vous spécifiez sous la forme d’une chaîne littérale de texte qui s’affiche exactement comme vous les tapez, ou sous la forme d’une formule qui s’évalue en 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éfinissez cette valeur sur true pour permettre à l’étiquette d’ajuster automatiquement sa hauteur de façon à afficher tout le texte. Définissez-la sur false pour tronquer le texte à la hauteur affectée.

Color  : couleur du texte dans un contrôle.

Font  : nom de la famille de polices dans laquelle le texte s’affiche.

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

DelayOutput  : définissez cette valeur sur true pour différer l’action pendant la saisie de texte.

Propriétés supplémentaires

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

AutoHeight : indique si une Étiquette augmente automatiquement la valeur de sa propriété Height si sa propriété Texte contient plus de caractères que ce que le contrôle peut afficher à la fois.

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.

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.

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.

FontWeight  : épaisseur du texte dans un contrôle : Bold, Semibold, Normal, or Lighter.

Height  : distance entre le haut et le bas d’un contrôle.

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.

Live  : comment un lecteur d’écran annonce des modifications de la valeur de la propriété Texte de l’étiquette.

• Lorsqu’il est réglé sur Désactivé, le lecteur d’écran n’annonce pas de changements.
• Quand il est réglé sur Polite, le lecteur d’écran finit de parler avant d’annoncer tout changement survenu pendant que le lecteur d’écran parlait.
• Lorsqu’il est réglé sur Assertive, le lecteur d’écran finit de parler pour annoncer tout changement survenu pendant que le lecteur d’écran parlait.

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

Overflow : indique si une barre de défilement apparaît dans une Étiquette dans le cas où sa propriété Wrap est définie sur true et où la valeur de la propriété Texte du contrôle contient plus de caractères que le contrôle peut 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 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.

Role : 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.

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.

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

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.

Wrap : Indique si le texte doit être renvoyé sur 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 connexes

Texte( Number, "FormatCodes" )

Exemples

Afficher une chaîne littérale

• Ajoutez une Étiquette et définissez sa propriété Texte sur "Hello, world" (avec 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é Texte sur une formule similaire à celle-ci :
  Today()

  Notes

  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, mettez l’argument (pas la formule) entre guillemets doubles.

  Vous souhaitez davantage 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 les données relatives à la population de différentes villes en Europe. Ensuite, vous allez afficher ces données dans une galerie contenant trois Étiquettes et spécifier le type de données présenté par chaque Étiquette.

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", Country:"Italy", Population:2874000}, {City:"Paris", Country:"France", Population:2273000}, {City:"Hamburg", Country:"Germany", Population:1760000}, {City:"Barcelona", Country:"Spain", Population:1602000}, {City:"Munich", Country:"Germany", Population: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 de droite affiche les options correspondantes.

4. Dans le volet Gallery1, définissez la liste du haut sur Population, la liste du milieu sur City et la liste du bas sur Country.

Instructions d’accessibilité

En dépit de son nom, un contrôle Étiquette ne doit pas être utilisé en tant qu’Étiquette pour un autre contrôle. Il peut être utilisé pour afficher toute partie du texte.

Une Étiquette peut être utilisée comme un bouton ou un lien en spécifiant le comportement OnSelect. Utilisée de cette façon, les considérations d’accessibilité sont similaires à celles des boutons.

Contraste des couleurs

Il doit exister un contraste des couleurs adéquat entre :

• Color et Fill
• D’autres exigences relatives au contraste des couleurs standard s’appliquent (s’il est utilisé comme un bouton ou un lien)

Prise en charge du lecteur d’écran

• Texte doit être présent.

• Live doit être défini sur Polite ou Assertive si un lecteur d’écroit doit annoncer des modifications de la valeur de la propriété Texte.

  Notes

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

Prise en charge de la malvoyance

• Étiquette doit ressembler à un lien, si elle est utilisée comme un lien.
  • Définissez Underline sur true
  • HoverColor doit être différent de Color

Prise en charge du clavier

• TabIndex doit être égal ou supérieur à zéro, si le texte est utilisé comme un bouton ou un lien. Ainsi, les utilisateurs du clavier peuvent y accéder.
• Les indicateurs de focus doivent être clairement visibles, si le texte est utilisé comme un bouton. Pour ce faire, utilisez FocusedBorderColor et FocusedBorderThickness.