ProgressIndicator Kontrolle
Ein Steuerelement, das verwendet wird, um eine Ladeerfahrung zu erstellen.
Notiz
Sie finden die vollständige Dokumentation und den Quellcode im GitHub-Codekomponenten-Repository.
Beschreibung des Dataflows
Fortschrittsanzeigen werden verwendet, um den Abschlussstatus eines Vorgangs anzuzeigen, der länger als zwei Sekunden dauert. Wenn der Fortschrittsstatus nicht bestimmt werden kann, verwenden Sie stattdessen einen Wartekreisel oder den Indeterminate Indicator-Typ. Fortschrittsanzeigen können in einem neuen Bereich, einem Flyout-Fenster, unter der Benutzeroberfläche angezeigt werden, die den Vorgang initiiert, oder sogar die initiierende Benutzeroberfläche ersetzen. Die Benutzeroberfläche muss nur zurückkehren können, wenn Sie die Aktivität abbrechen oder beenden.
Diese Codekomponente stellt einen Wrapper um das Fluent-UI-ProgressIndicator-Steuerelement zur Verwendung in Canvas-Apps und benutzerdefinierten Seiten bereit. Siehe Komponentendokumentation für bewährte Methoden.
Eigenschaften
Schlüsseleigenschaften
| Eigenschaften | Beschreibung des Dataflows |
|---|---|
Label |
Optionale Beschriftung für Wartekreisel. |
Percentage Complete |
Prozentsatz des abgeschlossenen Vorgangs auf einer Skala von 0 bis 1. Wenn nicht festgelegt, wird ein unbestimmter Indikator angezeigt. |
TypeOfIndicator |
Gibt den Typ des Indikatorstils an. Auswahl: Default Indicator oder IndeterminateIndicator |
HideProgressState |
„True“ angeben, um den Fortschrittsstatus auszublenden |
BarHeight |
Gegebenenfalls die Höhe der Leiste angeben |
Stileigenschaften
| Eigenschaften | Beschreibung des Dataflows |
|---|---|
Theme |
Akzeptiert eine JSON-Zeichenfolge, die mithilfe des Fluent-UI-Themen-Designers (windows.net) generiert wird. Wenn Sie dieses Feld leer lassen, wird das in Power Apps definierte Standarddesign verwendet. Siehe Designs für eine Konfigurationsanleitung. |
AccessibilityLabel |
Aria-Beschriftung für Sprachausgabe |
Behavior
Ladefortschritt anzeigen
Machen Sie das ProgressIndicator-Steuerelement selbst (oder die Oberfläche, in der es sich befindet) sichtbar, wenn ein Prozess beginnt, und aktualisieren Sie dann eine Variable mit dem Wert, wenn Segmente des Prozesses abgeschlossen sind. Blenden Sie es aus, wenn der Prozess abgeschlossen ist. Verwenden Sie eine Variable, um die Sichtbarkeit des Steuerelements zu steuern, und aktualisieren Sie die Werte zwischen dem Hauptcodeblock des Prozesses, die angezeigt werden müssen.
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 });
Stellen Sie die var_showProgress-Variable als Wert für die Visible-Eigenschaft des ProgressIndicator (oder der Oberfläche, die es enthält) bereit und weisen Sie die var_progressValue-Variable für die Value-Eigenschaft zu.
Einschränkungen
Diese Canvas-Komponente kann nur in Canvas-Apps und benutzerdefinierten Seiten verwendet werden.