Siirry pääsisältöön

ProgressBar

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

ProgressBar-komponentti kertoo visuaalisesti toiminnan valmistumistilan. Kun työ etenee, suorakulmio täyttyy vähitellen heijastamaan nykyistä prosenttiosuutta. Baarissa voi myös näyttää tekstimuotoisen arvon, ja se tukee sekä määrättyjä että määräämättömiä tiloja tehtäville, joiden kesto on tunnettu tai tuntematon.

Käyttökohteet​

ProgressBar-komponentti on hyödyllinen tehtävien valmistumistilan visualisoimiseksi. Se tukee:

  • Määritettävät minimija maksimiväli.
  • Määräämätön tila jatkuville tehtäville, joilla ei ole selkeää loppua.
  • Vaihtoehtoja tekstin näkyvyyteen, animaatioihin ja raidallisiin muotoiluihin paremman visuaalisen palautteen saamiseksi.

Seuraavassa esimerkissä on raidallinen, animaatiota sisältävä progress bar, jossa on aloita, keskeytä ja nollaustilat:

Näytä koodi

Arvojen asettaminen​

ProgressBar-komponentti mahdollistaa sen nykyarvon, minimirajan ja maksimirajan asettamisen ja hakemisen.

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

Suunta​

ProgressBar voidaan asettaa vaakasuoraan tai pystysuoraan.

Näytä koodi

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

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

Näytä koodi

Teksti ja tekstin näkyvyys​

Oletuksena luotaessa progress bar näyttää prosenttiosuuden muodossa XX%. Käyttämällä setText()-metodia voit käyttää paikkamerkkiä {{x}} saadaksesi nykyarvon prosentteina. Lisäksi voit käyttää paikkamerkkiä {{value}} saadaksesi raakaan nykyarvoon.

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

Tyylit​

Teemat​

ProgressBar-komponentissa on sisäänrakennettuna teemoja nopeaa tyylittelyä varten ilman CSS:n käyttöä. Nämä teemat ovat ennalta määriteltyjä tyylejä, joita voidaan soveltaa painikkeisiin niiden ulkoasun ja visuaalisen esityksen muuttamiseksi. Ne tarjoavat nopean ja johdonmukaisen tavan mukauttaa ProgressBarien ulkoasua koko sovelluksessa.

Näytä koodi

Loading...

Parhaat käytännöt​

  • Käytä Sopivia Minimi- ja Maksimiväliä: Aseta minimija maksimiväli tehtävän alueen tarkkaa heijastamista varten.
  • Päivitä Edistystä Säännöllisesti: Päivitä jatkuvasti edistymisarvo tarjotaksesi käyttäjille reaaliaikaista palautetta.
  • Hyödynnä Määräämätöntä Tilaa Tuntemattomille Kestoille: Käytä määräämätöntä tilaa tehtäville, joiden kesto on arvaamaton, osoittaaksesi jatkuvaa edistymistä.
  • Näytä Teksti Parempaa Käyttäjäpalautetta Varten: Näytä teksti progress barissa tarjotaksesi lisäkontekstia tehtävän edistyksestä.