ProgressIndicator controle

Artikel
03/21/2023

Een besturingselement dat wordt gebruikt om een laadervaring te maken.

Notitie

Volledige documentatie en broncode vindt u in de GitHub-opslagplaats voor codeonderdelen.

Besturingselement ProgressIndicator.

Omschrijving

Voortgangsindicatoren worden gebruikt om de voltooiingsstatus weer te geven van een bewerking die langer dan twee seconden duurt. Als de voortgangsstatus niet kan worden bepaald, gebruikt u een Spinner of gebruikt u in plaats daarvan het type Indeterminate Indicator. Voortgangsindicatoren kunnen worden weergegeven in een nieuw paneel, in een flyout-venster, onder de UI die de bewerking initieert of zelfs ter vervanging van de beginnende gebruikersinterface, zolang de gebruikersinterface kan terugkeren als u de activiteit annuleert of stopt.

Dit codeonderdeel biedt een wrapper rond het besturingselement ProgressIndicator van Fluent UI voor gebruik in canvas-apps en aangepaste pagina's. Zie onderdeeldocumentatie voor best practices.

Eigenschappen

Belangrijke eigenschappen

Eigenschappen	Omschrijving
`Label`	Optioneel label voor spinner.
`Percentage Complete`	Percentage van de bewerking voltooid op een schaal van 0 tot 1. Indien niet ingesteld, wordt Onbepaalde indicator weergegeven.
`TypeOfIndicator`	Hiermee wordt het type indicatorstijl opgegeven. Opties: `Default Indicator` en `IndeterminateIndicator`
`HideProgressState`	Geef waar op om de voortgangsstatus te verbergen
`BarHeight`	Geef de hoogte van de balk op indien van toepassing

Stijleigenschappen

Eigenschappen	Omschrijving
`Theme`	Accepteert een JSON-tekenreeks die is gegenereerd met Ontwerper van Fluent UI Theme (windows.net). Als u dit leeg laat, wordt het standaardthema gebruikt dat door Power Apps is gedefinieerd. Zie Themagebruik voor richtlijnen voor configureren.
`AccessibilityLabel`	Arialabel voor schermlezers

Gedrag

Voortgang van laden weergeven

Maak het besturingselement ProgressIndicator zelf (of het oppervlak waarin het zich bevindt) zichtbaar wanneer een proces begint en werk vervolgens een variabele bij met de waarde als segmenten van het proces zijn voltooid. Verberg het zodra het proces is voltooid. Gebruik een variabele om de zichtbaarheid van het besturingselement te regelen en de waarden bij te werken tussen de belangrijkste codeblokken van het proces die moeten worden aangegeven.

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 });

Geef de variabele var_showProgress op als de waarde voor de eigenschap Visible van de ProgressIndicator (of het oppervlak dat het bevat), en wijs de variabele var_progressValue toe voor de eigenschap Value.

Beperkingen

Dit canvasonderdeel kan alleen worden gebruikt in canvas-apps en aangepaste pagina's.

Delen via