Siirry pääsisältöön

ProgressBar

Avaa ChatGPT:ssä
Varjo dwc-progressbar 24.02
Java API

ProgressBar komponentti esittää visuaalisesti toiminnan valmistumisen tilan. Työn edetessä suorakulmio täyttyy vähitellen heijastamaan nykyistä prosenttia. Baarissa voidaan myös näyttää tekstimuotoinen esitys sen arvosta, ja se tukee sekä määritettyjä että määrittämättömiä tiloja tunnetuilla tai tuntemattomilla kestolla.

Käytöt​

ProgressBar komponentti on hyödyllinen tehtävien valmistumisen tilan visualisoimiseksi. Se tukee:

  • Konfiguroitavia vähimmäis- ja enimmäisarvoja.
  • Määrittämätöntä tilaa jatkuville tehtäville, joilla ei ole tarkkaa loppua.
  • Vaihtoehtoja tekstin näkyvyyteen, animaatioon ja raidoitettuihin suunnitteluihin paremman visuaalisen palautteen saamiseksi.

Seuraava esimerkki näyttää raidallisen, animaatiolla varustetun edistymispalkin, jossa on käynnistys-, tauko- ja nollausohjaimet:

Näytä koodi

Arvojen asettaminen​

ProgressBar komponentti sallii nykyisen arvonsa, vähimmäis- ja enimmäisrajat asettamisen ja saamisen.

ProgressBar bar = new ProgressBar();
bar.setMin(0);
bar.setMax(100);
bar.setValue(50);

Suunta​

ProgressBar voidaan suunnata vaakasuoraan tai pystysuoraan.

Näytä koodi

Määrittämätön tila​

ProgressBar tukee määrittämätöntä tilaa tehtäville, joiden valmistumisaika on tuntematon.

Näytä koodi

Teksti ja tekstin näkyvyys​

Oletuksena, kun progress bar luodaan, se näyttää prosenttiosuuden valmistumisesta muodossa XX%. Käyttämällä setText() menetelmää voit käyttää paikkamerkkiä {{x}} saadaksesi nykyisen arvon prosentteina. Lisäksi voit käyttää paikkamerkkiä {{value}} saadaksesi raakamuotoisen nykyarvon.

ProgressBar bar = new ProgressBar(15, "Lataus: {{x}}%");

Tyylittely​

Teemat​

ProgressBar komponentti tulee mukana teemoja , jotka on sisällytetty nopeaan tyylittelyyn ilman CSS:ää. Nämä teemat ovat ennalta määritettyjä tyylejä, joita voidaan soveltaa painikkeisiin niiden ulkoasun ja visuaalisen esityksen muuttamiseksi. Ne tarjoavat nopean ja johdonmukaisen tavan mukauttaa ProgressBarien ulkoasua sovelluksessa.

Näytä koodi

Loading...

Parhaat käytännöt​

  • Käytä sopivia vähimmäis- ja enimmäisarvoja: Aseta vähimmäis- ja enimmäisarvot tarkasti tehtävän alueen heijastamiseksi.
  • Päivitä edistystä säännöllisesti: Päivitä jatkuvasti edistyksen arvoa antaaksesi käyttäjille reaaliaikaista palautetta.
  • Hyödynnä määrittämätöntä tilaa tuntemattomille kestolle: Käytä määrittämätöntä tilaa tehtäville, joilla on arvaamaton kesto, osoittaaksesi jatkuvaa edistystä.
  • Näytä tekstiä paremman käyttäjäpalautteen saamiseksi: Näytä tekstiä edistymispalkissa tarjotaksesi lisäkonseptia tehtävän edistymisestä.