ProgressIndicator hallinta

Artikkeli
03/21/2023

Latauskokemuksen luova ohjausobjekti.

Muistiinpano

Täydellinen dokumentaatio ja lähdekoodi löytyvät koodikomponenttien GitHub-säilöstä.

ProgressIndicator-ohjausobjekti

Description

Tilanneilmaisimilla näytetään yli kaksi sekuntia kestävän toiminnon valmistumisen tila. Jos etenemisen tilaa ei voi määrittää, käytä Spinner-ohjausobjektia tai Indeterminate Indicator -tyyppiä sen sijaan. Tilanneilmaisimia voidaan näyttää uudessa paneelissa, pikaikkunassa, toiminnon käynnistäneessä käyttöliittymässä. Ne voivat myös korvata käynnistävän käyttöliittymän, kunhan käyttöliittymä voi palata, jos peruutat tai pysäytät aktiviteetin.

Tämä koodikomponentti paketoi Fluent UI:n ProgressIndicator-ohjausobjektin pohjaan perustuvilla ja mukautetuilla sivuilla käytettäväksi. Katso parhaat käytännöt komponenttien dokumentaatiosta.

Ominaisuudet

Tärkeimmät ominaisuudet

Ominaisuus	Description
`Label`	Hyrräkuvakkeen valinnainen otsikko.
`Percentage Complete`	Toiminnon valmistumisen prosenttiosuus asteikolla 0–1. Jos arvoa ei ole määritetty, näkyviin tulee määrittämätön ilmaisin.
`TypeOfIndicator`	Määrittää ilmaisimen tyylin tyypin. Vaihtoehdot: `Default Indicator` tai `IndeterminateIndicator`
`HideProgressState`	Määritä arvoksi true, jos haluat piilottaa edistymisen tilan
`BarHeight`	Määritä palkille asiaankuuluva korkeus

Tyylin ominaisuudet

Ominaisuus	Description
`Theme`	Hyväksyy Fluent UI Theme Designer (windows.net) -sovelluksella luodun JSON-merkkijonon. Tämän kentän jättäminen tyhjäksi käyttää Power Appsin määrittämää oletusteemaa. Katso määritysohjeet kohdasta Teemat.
`AccessibilityLabel`	Näytönlukuohjelman aria-otsikko

Toiminta

Lataamisen edistymisen näyttäminen

Varsinainen ProgressIndicator-ohjausobjekti (tai pinta, jossa se sijaitsee) tehdään näkyväksi, kun prosessi alkaa, jonka jälkeen muuttuja päivitetään arvolla, kun prosessin osat valmistuvat. Se piilotetaan, kun prosessi on valmis. Ohjausobjektin näkyvyyttä hallitaan muuttujan avulla, ja arvot päivitetään prosessien ilmaistavien prosessin tärkeiden koodilohkojen välillä.

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

var_showProgress-muuttuja annetaan ProgressIndicator-ohjausobjektin (tai sen sisältävän pinnan) Visible-ominaisuuden arvona ja Value-ominaisuudelle määritetään var_progressValue-muuttuja.

Rajoitukset

Tätä pohjaan perustuvaa komponenttia voi käyttää vain pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.

Jaa