Siirry pääsisältöön

Toast

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

A Toast on pieni, väliaikainen ilmoitus, joka ilmestyy antamaan käyttäjille palautetta toiminnasta tai tapahtumasta. Toastit näyttävät viestejä, kuten onnistumisvahvistuksia, varoituksia tai virheitä, keskeyttämättä nykyistä työskentelyä, ja ne häipyvät automaattisesti asetetun ajan kuluttua.

Perusteet​

webforJ tarjoaa nopean ja helpon tavan luoda Toast-komponentti yhdellä koodirivillä Toast.show()-metodin avulla, joka luo Toast-komponentin, lisää sen Frame:en ja näyttää sen. Voit välittää parametreja show-metodille näyttäessäsi Toast-ilmoitusta:

Toast.show("Toimenpide suoritettiin onnistuneesti!", Theme.SUCCESS);

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

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

Oletuskäyttäytyminen

Toisin kuin muut komponentit, Toast ei tarvitse olla erikseen lisättynä säiliöön, kuten Frame:en. Kun kutsut open()-metodia, Toast liitetään automaattisesti ensimmäiseen sovellus Frame:en.

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

  • Reaaliaikainen palaute toimille, kuten lomakkeiden lähettämisille, tietojen tallennuksille tai virheille.
  • Mukautettavat teemat erottamaan onnistumiset, virheet, varoitukset tai informatiiviset viestit.
  • Joustavat sijoitusvaihtoehdot ilmoitusten näyttämiseen eri alueilla näytöllä ilman, että käyttäjän työskentely keskeytyy.

Kesto​

Voit konfiguroida Toast-ilmoituksia häipymään asetetun ajan kuluttua tai pysymään ruudulla, kunnes ne suljetaan, tarpeidesi mukaan. Voit mukauttaa kestot setDuration()-metodilla tai yksinkertaisesti antaa kestoparametrin rakentajalle tai show()-metodille.

Oletuskesto

Oletuksena Toast sulkeutuu automaattisesti 5000 millisekunnin kuluttua.

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

Pysyvät toastit​

Voit luoda pysyvän Toastin asettamalla negatiivisen keston. Pysyvät Toast-ilmoitukset eivät sulkeudu automaattisesti, mikä voi olla hyödyllistä kriittisissä hälytyksissä tai tapauksissa, joissa käyttäjältä vaaditaan vuorovaikutusta tai tunnustamista.

varoitus

Ole varovainen pysyvien Toast-ilmoitusten kanssa, ja varmista, että käyttäjälle on tarjottu tapa sulkea ilmoitus. Käytä close()-metodia piilottaaksesi Toastin, kun käyttäjä on tunnustanut sen tai suorittanut tarvittavan vuorovaikutuksen.

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

Sijoitus​

webforJ:n Toast-komponentin avulla voit valita, missä ilmoitus näkyy näytöllä, sopiaksesi sovelluksesi suunnittelu- ja käytettävyyden vaatimuksiin. Oletuksena Toast-ilmoitukset näkyvät näytön alaosassa keskellä.

Voit asettaa Toast-ilmoituksen placement-arvon setPlacement-metodilla käyttäen Toast.Placement enumia seuraavilla arvoilla:

  • BOTTOM: Asettaa ilmoituksen alaosaan keskelle näyttöä.
  • BOTTOM_LEFT: Asettaa ilmoituksen ala-vasempaan kulmaan.
  • BOTTOM_RIGHT: Asettaa ilmoituksen ala-oikeaan kulmaan.
  • TOP: Asettaa ilmoituksen yläosaan keskelle näyttöä.
  • TOP_LEFT: Asettaa ilmoituksen ylä-vasempaan kulmaan.
  • TOP_RIGHT: Asettaa ilmoituksen ylä-oikeaan kulmaan.

Nämä vaihtoehdot antavat sinulle hallintaa Toast-ilmoituksen sijoittelusta sovelluksesi suunnittelu- 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 sijoittelua voit varmistaa, että käyttäjät saavat tietoa sopivalla tavalla kussakin sovelluksessa, näytön asettelussa ja kontekstissa.

Pinottaminen​

Toast-komponentti voi näyttää useita ilmoituksia samanaikaisesti, pinoten niitä pystysuoraan sijoittelunsa mukaan. Uudemmat ilmoitukset näkyvät lähempänä sijoittelun reunaa, työntäen vanhempia ilmoituksia kauemmas. Tämä varmistaa, että käyttäjät eivät jää ilman tärkeitä tietoja, vaikka paljon tapahtuu.

Toiminnot ja vuorovaikutus​

Vaikka Toast-ilmoitukset eivät vaadi käyttäjän vuorovaikutusta oletusarvoisesti, webforJ sallii lisätä painikkeita tai muita interaktiivisia elementtejä, jotta ne olisivat käyttökelpoisempia kuin pelkät ilmoitukset.

Näytä koodi

Lisäämällä tällaista vuorovaikutusta voit antaa käyttäjille mahdollisuuden hoitaa tehtäviä ja suorittaa toimintoja siirtymättä pois nykyiseltä näytöltään, muuttaen Toast-ilmoituksesta arvokkaan vuorovaikutus- ja sitoutumiskanavan.

Tyylittely​

Voit tyylittää Toast-ilmoituksia teemoilla kuten muutkin webforJ-komponentit, tarjoten käyttäjille arvokasta kontekstia esitettävän tiedon tyypistä ja luoden johdonmukaisen tyylin koko sovellukseen. Voit joko asettaa teeman luodessasi Toastia 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​

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 Toast:n kokonestyylin yli.

Voit lisätä mukautetun teeman Toast:lle määrittämällä mukautettuja CSS-muuttujia, jotka muokkaavat komponentin ulkoasua. Seuraava esimerkki havainnollistaa, kuinka luoda Toast mukautetulla teemalla käyttäen webforJ:ta.

Toast Kohdistaminen

Koska Toast ei sijaitse tietyssä paikassa DOM:ssa, voit kohdistaa sen CSS-muuttujilla. Nämä muuttujat helpottavat yhdenmukaisten mukautettujen tyylien soveltamista kaikkiin Toast-ilmoituksiin.

Näytä koodi

Loading...