DesktopNotification

Avaa ChatGPT:ssä

25.00 Experimental

Java API

WebforJ-version 25.00 ja uudemmat, DesktopNotification-komponentti tarjoaa yksinkertaisen käyttöliittymän työpöytäilmoitusten luomiseen, näyttämiseen ja hallintaan. Keskityttäessä minimaaliseen konfigurointiin ja sisäänrakennettuun tapahtumankäsittelyyn, komponenttia voidaan käyttää, kun käyttäjille on tarpeen ilmoittaa reaaliaikaisista tapahtumista (kuten uusista viesteistä, ilmoituksista tai järjestelmäntapahtumista) samalla kun he selaavat sovellustasi.

kokeellinen ominaisuus

DesktopNotification-komponentti on vielä kehittymässä, ja sen API voi kokea muutoksia kehittyessään. Aloittaaksesi tämän ominaisuuden käytön, varmista, että lisäät seuraavan riippuvuuden pom.xml-tiedostoon.

<dependency>
  <groupId>com.webforj</groupId>
  <artifactId>webforj-desktop-notification</artifactId>
</dependency>

Esivaatimukset

Ennen DesktopNotification-komponentin integroimista varmista, että:

• Sovelluksesi toimii turvallisessa kontekstissa (HTTPS).
• Selain ei ole yksityisessä tai incognito-tilassa.
• Käyttäjä on ollut vuorovaikutuksessa sovelluksen kanssa (esim. painanut painiketta tai näppäintä), sillä ilmoitukset vaativat käyttäjän eleen näyttämiseksi.
• Käyttäjä on myöntänyt ilmoitusluvat (tämä pyydetään automaattisesti, jos tarpeen).

Peruskäyttö

Ilmoituksen luomiseen ja näyttämiseen on useita tapoja. Useimmissa tilanteissa yksinkertaisin lähestymistapa on kutsua yhtä staattisista show-menetelmistä, jotka kapseloivat koko ilmoituksen elinkaaren.

Esimerkki: Perusilmoituksen näyttäminen

// Perusilmoitus, jossa on otsikko ja viesti
DesktopNotification.show("Päivitys saatavilla", "Latauksesi on valmis!");

Tämä yksirivinen koodi luo ilmoituksen, jossa on otsikko ja sisältö, ja yrittää sitten näyttää sen.

Ilmoituksen mukauttaminen

Ilmoituksen ulkonäön ja tunteen mukauttamiseen on useita vaihtoehtoja, riippuen sovelluksen tarpeista ja ilmoituksen tarkoituksesta.

Mukautetun Icon-asetuksen asettaminen

Oletusarvoisesti ilmoitus käyttää määrittelemääsi sovellusikonia ikoni-protokollan kautta. Voit asettaa mukautetun ikonin käyttämällä setIcon-menetelmää. Komponentti tukee eri URL-protokollia:

• context://: Ratkaisee kontekstin URL:ksi, joka osoittaa sovelluksen resurssikansioon; kuva on base64-koodattu.
• ws://: Ratkaisee verkkopalvelimen URL:ksi, joka antaa täysin määritellyn URL-osoitteen.
• icons://: Ratkaisee ikonien URL-osoitteeksi.

Esimerkki:

// Luodaan ilmoitus mukautetulla ikonu URL-osoitteella
DesktopNotification notification = new DesktopNotification(
  "Muistutus", "Kokous alkaa 10 minuutin kuluttua."
);
notification.setIcon("context://images/custom-icon.png");
notification.open();

Ilmoitustapahtumat

DesktopNotification tukee useita elinkaaritapahtumia, ja kuuntelijoita voidaan liittää käsittelemään tapahtumia, kuten kun ilmoitus näytetään, suljetaan, klikataan tai syntyy virhe.

Tapahtuma	Kuvaus	Milloin käyttää
Avaa	Käynnistyy, kun ilmoitus näytetään.	Ilmoituksen näyttämisen lokittaminen, käyttöliittymän päivittäminen, sitoutumisen seuraaminen.
Sulje	Käynnistyy, kun ilmoitus suljetaan.	Resurssien puhdistaminen, hylkäysten lokittaminen, seurantatoimien suorittaminen.
Virhe	Käynnistyy, kun ilmoituksessa syntyy virhe tai käyttäjä ei myöntänyt lupia.	Virheiden käsitteleminen sujuvasti, käyttäjän ilmoittaminen, varajärjestelmien soveltaminen.
Klikkaus	Käynnistyy, kun käyttäjä klikkaa ilmoitusta.	Siirtyminen tiettyyn osioon, vuorovaikutusten lokittaminen, sovelluksen fokusoiminen.

DesktopNotification notification = new DesktopNotification("Ilmoitus", "Sinulla on uusi viesti!")

// Liitetään tapahtumakuuntelija avautumisen tapahtumalle
notification.onOpen(event -> {
  System.out.println("Ilmoitus avattiin käyttäjän toimesta.");
});

// Vastaavasti, kuunnellaan klikkaustapahtumaa
notification.onClick(event -> {
  System.out.println("Ilmoitus klikattu.");
});

Klikkauskäyttäytyminen

Selaimen turvallisuuspolitiikat estävät ilmoituksen klikkaustapahtuman automaattisesti tuomasta sovelluksesi ikkunaa tai välilehteä fokukseen. Tämä käyttäytyminen on selaimen täytäntöönpanema eikä sitä voida ohittaa ohjelmallisesti. Jos sovelluksesi vaatii ikkunan fokusoimista, sinun on kehotettava käyttäjiä klikkaamaan sovelluksessa ilmoituksen vuorovaikutuksen jälkeen.

Turvallisuus- ja yhteensopivuusnäkökohtia

Käyttäessäsi DesktopNotification-komponenttia, pidä mielessä seuraavat seikat:

• Turvallisuuskonteksti: Sovelluksesi on tarjottava HTTPS:n kautta, jotta ilmoitukset ovat sallittuja useimmissa moderneissa selaimissa.
• Käyttäjän elevaatimus: Ilmoitukset näytetään vain käyttäjän aiheuttaman toiminnan jälkeen. Pelkkä sivun lataaminen ei laukaise ilmoitusta.
• Selaimen rajoitukset: Kaikki selaimet eivät käsittele mukautettuja ikoneita tai fokusoimiskäyttäytymistä samalla tavalla. Esimerkiksi mukautetut ikonit eivät välttämättä toimi Safarissa, kun taas tapahtumakäyttäytyminen voi vaihdella muissa selaimissa.
• Luvat: Varmista aina, että sovelluksesi tarkistaa ja pyytää ilmoituslupia käyttäjältä sujuvasti.

Käyttöparhaat käytännöt

Pidä mielessä seuraavat parhaat käytännöt käyttäessäsi DesktopNotification-komponenttia sovelluksessasi:

• Tiedota käyttäjiä: Kerro käyttäjille, miksi ilmoituksia tarvitaan ja miten niistä voi olla hyötyä.
• Tarjoa varajärjestelmiä: Koska jotkut selaimet saattavat rajoittaa ilmoituksia, harkitse vaihtoehtoisia tapoja varoittaa käyttäjiä (esimerkiksi sovelluksen sisäiset viestit).
• Virheiden käsittely: Rekisteröi aina virhekuuntelija hallitaksesi sujuvasti tilanteita, joissa ilmoitusten näyttäminen epäonnistuu.