Guida introduttiva: Invio di un aggiornamento di notifica (HTML)
[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]
Nota Se non usi JavaScript, vedi Guida introduttiva: Invio di un aggiornamento di notifica (XAML).
In questo argomento viene illustrato come creare o aggiornare una notifica in un riquadro. Invierai una notifica di badge che include un glifo o un valore numerico. Imparerai inoltre a rimuovere la notifica dal riquadro.
Una notifica è costituita da un numero o un glifo visualizzato sul riquadro per indicare lo stato di un app. La notifica è un'immagine sovrapposta al riquadro, non una parte di esso. Può essere visualizzata in vari punti del riquadro:
- Nell'angolo in basso a destra in Windows quando si usa una lingua da sinistra a destra, come l'inglese
- Nell'angolo in basso a sinistra in Windows quando si usa una lingua da destra a sinistra, come l'arabo
- Nell'angolo in alto a destra in Windows Phone 8.1 quando si usa una lingua da sinistra a destra
- Nell'angolo in alto a sinistra in Windows Phone 8.1 quando si usa una lingua da destra a sinistra
È possibile manipolare la notifica tramite le API e lo schema specifici e aggiornarla tramite notifiche specifiche. Questo argomento illustra la procedura necessaria per definire il contenuto della notifica badge, inviarlo tramite una notifica e rimuoverlo quando non è più necessario. Queste operazioni vengono mostrate usando una notifica locale, che è la notifica più facile da implementare.
Nota In questo argomento manipolerai il contenuto della notifica direttamente mediante il modello di oggetti documento XML. Un approccio alternativo è disponibile tramite la libreria NotificationsExtensions, che presenta il contenuto XML come proprietà dell'oggetto, incluso Intellisense. Per altre informazioni, vedi Guida introduttiva: Uso della raccolta NotificationsExtensions nel codice. Per vedere il codice di questo argomento usando NotificationsExtenstions, vedi Esempio di riquadri e notifiche dell'app.
Prerequisiti
Per comprendere questo argomento, devi disporre di:
- Conoscenza operativa di termini e concetti correlati a notifiche badge e notifiche. Per altre informazioni, vedi Riquadri, notifiche e avvisi.
- Familiarità con lo schema XML per le notifiche. Per altre informazioni, vedi Schema della notifica.
- Capacità di creare un'app di Windows Store di base in JavaScript usando le API Windows Runtime. Per ulteriori informazioni, vedi Creare la prima app di Windows Store scritta in JavaScript.
- Familiarità con XML e la relativa manipolazione tramite API Document Object Model (DOM).
Istruzioni
1. Facoltativo: dichiarare una variabile spazio dei nomi
Questa procedura ti fornisce un nome breve da usare al posto del nome completo dello spazio dei nomi. È equivalente all'istruzione "using" in C# o all'istruzione "Imports" in Visual Basic e ti consente di semplificare il codice.
Nota Il resto del codice in questo argomento presuppone che la variabile sia stata dichiarata.
var notifications = Windows.UI.Notifications;
2. Scegliere se visualizzare un numero o un glifo
In una notifica possono essere visualizzati numeri da 0 a 99 o uno dei glifi di stato definiti dal sistema. La notifica scelta dipende dallo scenario specifico. Ad esempio, un programma e-mail può visualizzare il numero di messaggi non letti o il glifo "nuovo messaggio" all'arrivo di una nuova e-mail. Per altre informazioni sui glifi disponibili, vedi Panoramica delle notifiche. Per altre informazioni sulla scelta tra numeri o glifi, vedi Linee guida ed elenco di controllo per i riquadri e le notifiche.
Nota In Windows Phone 8.1 sono supportati solo i glifi di stato per "avviso" e "attenzione", nonché i numeri, per le notifiche del telefono. Se vengono inviati altri glifi al telefono, la notifica verrà cancellata.
Le notifiche numeriche e quelle con glifi vengono definite tramite modelli di notifiche specifici. Devi recuperare il modello appropriato per il tipo di notifica che hai scelto. In questo esempio viene recuperato il modello per una notifica numerica.
var badgeType = notifications.BadgeTemplateType.badgeNumber;
var badgeXml = notifications.BadgeUpdateManager.getTemplateContent(badgeType);
In questo esempio viene recuperato il modello per una notifica con glifi.
var badgeType = notifications.BadgeTemplateType.badgeGlyph;
var badgeXml = notifications.BadgeUpdateManager.getTemplateContent(badgeType);
3. Assegnare un valore alla notifica
In questo esempio viene recuperato l'elemento badge dal modello e gli viene assegnato un valore numerico.
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "7");
Questo esempio assegna un valore di glifo alla notifica.
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "newMessage");
4. Creare la notifica badge e inviarla
Questo esempio incorpora l'XML che hai definito in una notifica e la invia.
var badgeNotification = new notifications.BadgeNotification(badgeXml);
notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
5. Facoltativo: Cancellare la notifica se non è più valida
Se le informazioni contenute nel numero o nel glifo della notifica non sono più utili, devi rimuoverle. Il codice seguente rimuove la notifica corrente dal riquadro dell'app chiamante. Puoi anche inviare il valore "none" come aggiornamento di notifica anziché chiamare il metodo Clear.
Nota A differenza dei riquadri, è possibile cancellare una notifica tramite il cloud.
notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().clear();
Riepilogo e passaggi successivi
In questa Guida introduttiva hai definito e inviato nuovo contenuto a una notifica nel riquadro dell'app, quindi lo hai rimosso quando non era più valido.
La Guida introduttiva ha illustrato come inviare un aggiornamento della notifica come notifica locale. Puoi anche esplorare gli altri metodi di recapito delle notifiche: pianificato, periodico e push. Per altre informazioni, vedi Recapito di notifiche.