ProgressIndicator contrôle

Article
03/21/2023

Un contrôle utilisé pour créer une expérience de chargement.

Note

La documentation complète et le code source sont accessibles dans le Référentiel de composants de code GitHub.

Contrôle ProgressIndicator

Description

Les indicateurs de progression sont utilisés pour montrer l’état d’achèvement d’une opération qui dure plus de deux secondes. Si l’état d’avancement ne peut être déterminé, utilisez plutôt un Spinner ou le type Indeterminate Indicator. Les indicateurs de progression peuvent apparaître dans un nouveau volet, une fenêtre volante, sous l’interface utilisateur ayant initié l’opération, ou ils peuvent même remplacer l’interface utilisateur initiatrice, tant que l’interface utilisateur peut revenir si vous annulez ou arrêtez l’activité.

Ce composant de code fournit un wrapper autour du contrôle ProgressIndicator de Fluent IU à utiliser dans les applications canevas et les pages personnalisées. Consultez la documentation des composants pour connaître les bonnes pratiques.

Propriétés

Propriétés principales

Property	Description
`Label`	Etiquette optionnelle pour le spinner.
`Percentage Complete`	Pourcentage de l’opération réalisée, sur une échelle de 0 à 1. S’il n’est pas défini, l’indicateur indéterminé (Indeterminate Indicator) s’affichera.
`TypeOfIndicator`	Spécifie le type du style d’indicateur. Choix : `Default Indicator` ou `IndeterminateIndicator`
`HideProgressState`	Spécifier True pour masquer l’état de progression
`BarHeight`	Spécifier la hauteur de la barre, le cas échéant

Propriétés du style

Property	Description
`Theme`	Accepte une chaîne JSON générée à l’aide du Concepteur de thème Fluent UI (windows.net). Si vous laissez ce champ vide, le thème par défaut défini par Power Apps sera utilisé. Consultez Création de thèmes pour obtenir des instructions de configuration.
`AccessibilityLabel`	Étiquette aria pour les lecteurs d’écran

Behavior

Afficher la progression du chargement

Rendez le contrôle ProgressIndicator lui-même (ou la surface dans laquelle il se trouve) visible lorsqu’un processus commence, puis mettez à jour une variable avec la valeur à mesure que les segments du processus sont terminés. Masquez-le quand le processus est terminé. Utilisez une variable pour contrôler la visibilité du contrôle et mettre à jour les valeurs entre les blocs de code principaux du processus qui nécessite une indication.

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

Fournissez la variable var_showProgress comme valeur de la propriété Visible du contrôle ProgressIndicator (ou de la surface qui le contient), et assignez la variable var_progressValue pour la propriété Value.

Limitations

Ce composant de canevas ne peut être utilisé que dans les applications canevas et les pages personnalisées.

Partager via