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);