Contrôle Bouton à bascule dans Power Apps

Contrôle que l’utilisateur peut activer ou désactiver en déplaçant sa poignée.

Description

Un bouton bascule, ou « toggle », est conçu pour les interfaces graphiques utilisateur récentes, mais il fonctionne de la même manière qu’une case à cocher.

Propriétés clés

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

Value  : valeur d’un contrôle d’entrée.

Propriétés supplémentaires

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

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.

FalseFill : couleur de remplissage lorsque le bouton bascule est désactivé.

FalseHoverFill : couleur de remplissage par pointage lorsque le bouton bascule est désactivé.

FalseText : texte affiché lorsque le bouton bascule est désactivé.

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.

HandleFill : la couleur de remplissage de la poignée de bascule.

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.

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

OnCheck – Actions à effectuer lorsque la valeur d’une case à cocher ou d’un bouton-bascule passe sur true.

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

OnUncheck – Actions à effectuer lorsque la valeur d’une case à cocher ou d’un bouton-bascule passe sur false.

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

RailFill : couleur d’arrière-plan du rectangle dans un contrôle Bouton à bascule lorsque sa valeur est false ou la couleur de la ligne à droite de la poignée d’un contrôle Curseur.

RailHoverFill :lorsque vous pointez sur un contrôle Bouton à bascule ou un curseur, la couleur d’arrière-plan du rectangle dans un contrôle Bouton à bascule lorsque sa valeur est false ou la couleur de la ligne à droite de la poignée d’un contrôle Curseur.

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

ShowLabel : indique si une Étiquette de texte s’affiche en regard du contrôle Bouton à bascule.

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

TextPosition : indique si l’étiquette est à gauche ou à droite du contrôle Bouton à bascule.

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

TrueFill : couleur de remplissage lorsque le bouton bascule est activé.

TrueHoverFill : couleur de remplissage par pointage lorsque le bouton bascule est activé.

TrueText : texte affiché lorsque le bouton bascule est activé.

ValueFill : couleur d’arrière-plan du rectangle dans un contrôle Bouton à bascule lorsque sa valeur est true ou la couleur de la ligne à gauche de la poignée d’un contrôle Curseur.

ValueHoverFill : lorsque vous maintenez le pointeur de la souris sur un contrôle Bouton à bascule ou un curseur, la couleur d’arrière-plan du rectangle dans un contrôle Bouton à bascule lorsque sa valeur est true ou la couleur de la ligne à droite de la poignée d’un contrôle Curseur.

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

If( Condition, Result )

Exemple

1. Ajoutez un bouton bascule et nommez-le MemberDiscount.

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

2. Ajoutez un libellé et définissez sa propriété Texte sur la formule suivante :
   If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

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

3. Appuyez sur F5 et modifiez la valeur de MemberDiscount.

   L’Étiquette affiche un prix différent, selon que MemberDiscount est activé ou désactivé.

4. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Instructions d’accessibilité

Contraste des couleurs

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

• HandleFill et FalseFill
• HandleFill et FalseHoverFill
• HandleFill et TrueFill
• HandleFill et TrueHoverFill
• FalseFill et la couleur en dehors du contrôle
• FalseHoverFill et la couleur en dehors du contrôle
• TrueFill et la couleur en dehors du contrôle
• TrueHoverFill et la couleur en dehors du contrôle

Ceci s’ajoute à la configuration requise du contraste des couleurs.

Prise en charge du lecteur d’écran

• AccessibleLabel doit être présent.
• FalseText doit être présent.
• TrueText doit être présent.

Prise en charge de la malvoyance

• Envisagez de définir ShowLabel sur true afin que les utilisateurs puissent déterminer rapidement la valeur de bascule.

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.