Siirry pääsisältöön

Toast

Avaa ChatGPT:ssä
Varjo dwc-toast 24.10
Java API

Toast on pieni, tilapäinen ilmoitus, joka ilmestyy antaakseen käyttäjille palautetta toiminnasta tai tapahtumasta. Toastit esittävät viestejä, kuten onnistumisvahvistuksia, varoituksia tai virheitä ilman, että ne keskeyttävät nykyistä työskentelyä, ja häviävät automaattisesti asetetun ajan kuluttua.

Toast.show() -metodi luo Toastin, lisää sen Frameen ja näyttää sen yhdellä koodirivillä. Anna parametreja show()-metodiin konfiguroidaksesi näytettävän Toastin:

Toast.show("Toiminto suoritettu onnistuneesti!", Theme.SUCCESS);

Jos haluat enemmän tarkkuutta komponentin hallintaan, voit myös luoda Toastin standardirakentajalla ja käyttää open()-metodia sen näyttämiseen.

Toast toast = new Toast("Toiminto suoritettu onnistuneesti!", 3000, Theme.SUCCESS, Placement.TOP);
toast.open();
Näytä koodi

Oletuskäyttäytyminen

Toisin kuin muut komponentit, Toastia ei tarvitse erikseen lisätä säilöön, kuten Frameen. Kun kutsut open()-metodia, Toast liitetään automaattisesti ensimmäiseen sovelluksen Frameen.

Toastit ovat monipuolisia ja tarjoavat hienovaraisia ilmoituksia reaaliaikaisesta palautteesta. Esimerkiksi:

  • Reaaliaikainen palaute toimille, kuten lomakkeiden lähettämisille, datan tallentamisille tai virheille.
  • Mukautettavat teemat onnistumisten, virheiden, varoitusten tai tiedottavien viestien erottamiseksi.
  • Joustavat sijaintivaihtoehdot ilmoitusten näyttämiseen eri paikoissa näytöllä ilman, että käyttäjän työskentely keskeytyy.

Kesto​

Voit konfiguroida Toast-ilmoitukset häviämään asetetun keston jälkeen tai pysymään näytöllä, kunnes ne hylätään, tarpeidesi mukaan. Voit mukauttaa kestoa setDuration()-metodilla tai yksinkertaisesti määrittää kesto-parametrin rakentajalle tai show()-metodille.

Oletuskesto

Oletuksena Toast sulkeutuu automaattisesti 5000 millisekunnin jälkeen.

Toast toast = new Toast("Esimerkkihälytys");
toast.setDuration(10000);
toast.open();

Kestävät toastit​

Voit luoda kestävän Toastin asettamalla negatiivisen kestön. Kestävät Toast-ilmoitukset eivät sulkeudu automaattisesti, mikä voi olla hyödyllistä kriittisille hälytyksille tai tilanteissa, joissa vaaditaan käyttäjän vuorovaikutusta tai tunnustamista.

varoitus

Ole varovainen kestävien Toast-ilmoitusten kanssa, ja varmista, että käyttäjälle on tarjottu tapa hylätä ilmoitus. Käytä close()-metodia piilottaaksesi Toast sen jälkeen, kun käyttäjä on tunnustanut sen tai suorittanut vaaditun vuorovaikutuksen.

Toast toast = new Toast("Toiminto suoritettu onnistuneesti!", -1, Theme.SUCCESS, Placement.TOP);
toast.open();

Sijainti​

webforJ:n Toast-komponentin avulla voit valita, mihin ilmoitus ilmestyy näytöllä sovelluksesi ulkoasun ja käytettävyyden vaatimusten mukaan. Oletuksena Toast-ilmoitukset näkyvät näytön alhaalla keskellä.

Voit asettaa Toast-ilmoituksen sijainnin setPlacement-metodilla käyttäen Toast.Placement-erotinta, jossa on yksi seuraavista arvoista:

  • BOTTOM: Asettuu ilmoitus näytön alaosaan keskelle.
  • BOTTOM_LEFT: Asettuu ilmoitus näytön vasempaan alakulmaan.
  • BOTTOM_RIGHT: Asettuu ilmoitus näytön oikeaan alakulmaan.
  • TOP: Asettuu ilmoitus näytön yläosaan keskelle.
  • TOP_LEFT: Asettuu ilmoitus näytön vasempaan yläkulmaan.
  • TOP_RIGHT: Asettuu ilmoitus näytön oikeaan yläkulmaan.

Nämä vaihtoehdot mahdollistavat Toast-ilmoituksen sijainnin hallinnan sovelluksesi ulkoasun ja käytettävyyden tarpeiden mukaan.

Toast toast = new Toast("Esimerkkihälytys");
toast.setPlacement(Toast.Placement.TOP_LEFT);
toast.open();
Näytä koodi

Mukauttamalla Toast-ilmoitustesi sijaintia voit varmistaa, että käyttäjät saavat informaatiota tavalla, joka on sopiva mille tahansa sovellukselle, näytön asettelulle ja kontekstille.

Pinout​

Toast-komponentti voi näyttää useita ilmoituksia samanaikaisesti, pinottuna pystysuunnassa niiden sijainnin perusteella. Uudemmat ilmoitukset ilmestyvät lähempänä sijaintireunaa, työntäen vanhempia ilmoituksia kauemmas. Tämä varmistaa, että käyttäjät eivät jää paitsi tärkeästä tiedosta, vaikka ympärillä tapahtuisi paljon.

Toiminnot ja vuorovaikutus​

Vaikka Toast-ilmoitukset eivät vaadi käyttäjän vuorovaikutusta oletusarvoisesti, webforJ antaa sinun lisätä painikkeita tai muita vuorovaikutteisia elementtejä, jotka tekevät niistä hyödyllisemmiksi kuin pelkät ilmoitukset.

Näytä koodi

Lisäämällä tällaisia vuorovaikutteisuuksia voit antaa käyttäjille mahdollisuuden käsitellä tehtäviä ja suorittaa toimintoja ilman, että heidän tarvitsee siirtyä pois nykyiseltä näytöltään, muuttaen Toast-ilmoituksen arvokkaaksi vuorovaikutus- ja sitoutumiskanavaksi.

Tyylittely​

Voit tyylitellä Toast-ilmoituksia teemoilla aivan kuten muutkin webforJ-komponentit, tarjoten käyttäjille arvokasta kontekstiä näytettävän tiedon luonteesta ja luoden johdonmukaisen ulkoasun koko sovelluksessa. Voit joko asettaa teeman luodessasi Toastin tai käyttää setTheme()-metodia.

Toast toast = new Toast("Esimerkkihälytys", Theme.INFO);
Toast toast = new Toast("Esimerkkihälytys");
toast.setTheme(Theme.INFO);

Mukautetut teemat​

Sisäänrakennettujen teemojen lisäksi voit luoda omia mukautettuja teemoja Toast-ilmoituksille. Tämä mahdollistaa henkilökohtaisemman ja brändätyn käyttäjäkokemuksen, antaen sinulle täyden hallinnan Toastin kokonaisulkoasusta.

Lisätäksesi mukautetun teeman Toastille, voit määrittää mukautettuja CSS-muuttujia, jotka muokkaavat komponentin ulkoasua. Seuraava esimerkki havainnollistaa, kuinka luodaan Toast, jossa on mukautettu teema webforJ:n avulla.

Toast-kohdistus

Koska Toast ei sijaitse tietyssä paikassa DOM:ssa, voit kohdistaa sen käyttämällä CSS-muuttujia. Nämä muuttujat helpottavat johdonmukaisten mukautettujen tyylien soveltamista kaikille Toast-ilmoituksille.

Näytä koodi

Loading...