Ovládací prvok ProgressIndicator

Článok
03/21/2023

Ovládací prvok používaný na vytvorenie prostredia na načítanie.

Poznámka

Úplnú dokumentáciu a zdrojový kód nájdete v odkladacom priestore komponentov kódu GitHub.

Riadenie indikátora pokroku.

Description

Indikátory priebehu sa používajú na zobrazenie stavu dokončenia operácie trvajúcej viac ako dve sekundy. Ak sa stav postupu nedá určiť, použite Spinner alebo namiesto toho použite typ Indeterminate Indicator. Indikátory priebehu sa môžu objaviť na novom paneli, v rozbaľovacom okne, pod používateľským rozhraním, ktoré spustilo operáciu, alebo môžu dokonca nahradiť spúšťacie používateľské rozhranie, pokiaľ sa používateľské rozhranie môže vrátiť, ak aktivitu zrušíte alebo zastavíte.

Tento komponent kódu poskytuje obal okolo ovládacieho prvku Fluent UI ProgressIndicator na použitie na plátne a vlastných stránkach. Najlepšie postupy nájdete v dokumentácii k súčasti.

Vlastnosti

Vlastnosti kľúča

Vlastnosť	Description
`Label`	Voliteľné označenie pre spinner.
`Percentage Complete`	Percento dokončenej operácie na stupnici od 0 do 1. Ak nie je nastavené, zobrazí sa neurčitý indikátor.
`TypeOfIndicator`	Určuje typ štýlu indikátora. Voľby: `Default Indicator` alebo `IndeterminateIndicator`
`HideProgressState`	Ak chcete skryť stav priebehu, zadajte hodnotu pravda
`BarHeight`	Podľa potreby zadajte výšku tyče

Vlastnosti štýlu

Vlastnosť	Description
`Theme`	Akceptuje reťazec JSON, ktorý je vygenerovaný pomocou aplikácie Fluent UI Theme Designer (windows.net). Ak toto necháte prázdne, použije sa predvolený motív definovaný v Power Apps. Pokyny na konfiguráciu nájdete v časti nastavenie motívov.
`AccessibilityLabel`	Označenie aria-label pre čítačky obrazovky

Správanie

Zobrazenie priebehu načítania

Zviditeľnite samotný ovládací prvok ProgressIndicator (alebo povrch, na ktorom sa nachádza) pri spustení procesu a potom aktualizujte premennú hodnotou, keď budú segmenty procesu dokončené. Skryte ho po dokončení. Použite premennú na ovládanie viditeľnosti ovládacieho prvku a aktualizujte hodnoty medzi hlavnými blokmi kódu procesu, ktoré je potrebné indikovať.

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

Zadajte premennú var_showProgress ako hodnotu vlastnosti Visible pre ProgressIndicator (alebo povrchu, ktorý ju obsahuje) a priraďte premennú var_progressValue pre vlastnosť Value.

Obmedzenia

Tento komponent plátna je možné použiť iba v aplikáciách plátna a vlastných stránkach.

Zdieľať cez