Comment planifier une notification toast (HTML)

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Remarque  Vous n’utilisez pas JavaScript ? Voir Comment planifier une notification toast (XAML).

Cette rubrique montre comment planifier une notification toast afin qu’elle s’affiche à un moment spécifique.

Ce que vous devez savoir

Technologies

• Windows Runtime

Prérequis

• Bonnes connaissances des termes et des concepts liés aux notifications toast. Pour plus d’informations, voir Vue d’ensemble des notifications toast.
• Aptitude à créer une application du Windows Store élémentaire en JavaScript à l’aide des API Windows Runtime. Pour plus d’informations, voir Créer votre première application du Windows Store en JavaScript.
• L’option Compatible toast doit avoir la valeur « Oui » dans le manifeste de votre application pour permettre l’envoi ou la réception de notifications toast. Pour plus d’informations, voir Comment s’abonner aux notifications toast.

Instructions

Étape 1: Spécifier un modèle

Avant de pouvoir spécifier l’heure de remise, vous devez créer la notification.

var template = Windows.UI.Notifications.ToastTemplateType.toastText02;                        
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);

Étape 2: Fournir le contenu d’une notification toast

Nous n’aborderons pas cela ici car la procédure est la même pour une notification toast planifiée que pour une notification toast non planifiée. Pour plus d’informations, voir Démarrage rapide : envoi d’une notification toast.

Étape 3: Spécifier l’heure à laquelle la notification toast doit être remise

Cet exemple spécifie que la notification doit apparaître dans 3 secondes. Cet exemple utilise l’objet Date JavaScript pour récupérer l’heure actuelle.

var currentTime = new Date();
var startTime = new Date(currentTime.getTime() + 3 * 1000);

Étape 4: Créer l’objet notification toast planifiée

Envoyez le contenu de la notification toast et l’heure de remise planifiée au constructeur.

var scheduledToast = new Windows.UI.Notifications.ScheduledToastNotification(toastXml, startTime);

Étape 5: Facultatif : attribuer un ID à la notification toast planifiée

Cet ID ne doit pas dépasser 16 caractères. Vous pouvez l’utiliser plus tard pour annuler la notification.

scheduledToast.id = "Future_Toast";

Étape 6: Ajoutez votre notification toast à la planification.

Créez l’objet ToastNotifier, lequel est à son tour utilisé pour ajouter votre notification à la planification.

var toastNotifier = Windows.UI.Notifications.ToastNotificationManager.createToastNotifier();
toastNotifier.addToSchedule(scheduledToast);

Ajout d’une notification toast qui se répète à intervalles spécifiques

Le code suivant permet d’afficher une seule notification toast à cinq reprises, à une minute d’intervalle. Pour plus de clarté, le code utilisé pour renseigner le modèle a été omis.

var template = Windows.UI.Notifications.ToastTemplateType.toastText02;
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);

// TO DO: Fill in the template with your notification content here. 
 
var currentTime = new Date();
var startTime = new Date(currentTime.getTime() + 1000);
 
var recurringToast = new Windows.UI.Notifications.ScheduledToastNotification(toastXml, startTime, 60 * 1000, 5);
recurringToast.id = "Recurring_Toast";

var toastNotifier = Windows.UI.Notifications.ToastNotificationManager.createToastNotifier();
toastNotifier.addToSchedule(recurringToast);