From bf2221b2e13303f90d773602de608e7f351a087e Mon Sep 17 00:00:00 2001 From: elpeleq42 <35039309+elpeleq42@users.noreply.github.com> Date: Sun, 6 Jan 2019 16:20:20 -0200 Subject: [PATCH 1/2] Create Notification.md --- docs/References/Notification.md | 81 +++++++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 docs/References/Notification.md diff --git a/docs/References/Notification.md b/docs/References/Notification.md new file mode 100644 index 0000000000..b50dd57207 --- /dev/null +++ b/docs/References/Notification.md @@ -0,0 +1,81 @@ + +_Notification API requires node-webkit >= v0.10.1_ + +`Notification` specification is based from http://www.w3.org/TR/notifications/ + +Here is the API specification: +```javascript +[Constructor(DOMString title, optional NotificationOptions options)] +interface Notification : EventTarget { + + attribute EventHandler onclick; + attribute EventHandler onshow; + attribute EventHandler onerror; + attribute EventHandler onclose; + + readonly attribute DOMString body; + readonly attribute DOMString icon; + + void close(); +}; + +dictionary NotificationOptions { + DOMString body; + DOMString icon; +}; +``` + +# Sample code +```javascript + +var options = { + icon: "http://yourimage.jpg", + body: "Here is the notification text" + }; + +var notification = new Notification("Notification Title",options); +notification.onclick = function () { + document.getElementById("output").innerHTML += "Notification clicked"; +} + +notification.onshow = function () { + // play sound on show + myAud=document.getElementById("audio1"); + myAud.play(); + + // auto close after 1 second + setTimeout(function() {notification.close();}, 1000); +} +``` +# General Notes +you can use `http://` or `file://` for the `icon`. node-webkit supports jpg / png files +## Windows +### Balloon Notification +if no icon is specified, it will use the app's icon. + +icon size must be >= 32x32 + +### Toast Notification (requires node-webkit >= v0.11) +* Only for Win8 (or newer) +* The icon must be using `file://` +* A shortcut to your app, with a System.AppUserModel.ID, must be installed to the Start screen. Note, however, that it does not need to be pinned to the Start screen. For more information, see How to enable desktop toast notifications through an AppUserModelID (http://msdn.microsoft.com/en-us/library/windows/desktop/hh802762(v=vs.85).aspx). + +The shortcut, ideally should be created by the application installer, but we have the API to create this, recommended to run this once during the application startup (in case the user deleted the shortcut link) + +```javascript +var gui = require('nw.gui'); +gui.App.createShortcut(process.env.APPDATA + "\\Microsoft\\Windows\\Start Menu\\Programs\\node-webkit.lnk"); +``` +the command will create / update the shortcut link with AppUserModelID + +The AppUserModelID can be specified in package.json file +```javascript +{ +"app-id": "com.node.webkit.notification.test" +} +``` +if it is not, it will use the application name as the AppUserModelID + +for complete sample code, go here https://github.com/rogerwang/node-webkit/tree/master/tests/manual_tests/notification + + From f9b404b987e781c3eac6e9fa29e00ec5ef8ce0ac Mon Sep 17 00:00:00 2001 From: elpeleq42 <35039309+elpeleq42@users.noreply.github.com> Date: Wed, 9 Jan 2019 17:42:30 -0200 Subject: [PATCH 2/2] Update Notification.md --- docs/References/Notification.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/References/Notification.md b/docs/References/Notification.md index b50dd57207..45f3ba224a 100644 --- a/docs/References/Notification.md +++ b/docs/References/Notification.md @@ -48,14 +48,14 @@ notification.onshow = function () { } ``` # General Notes -you can use `http://` or `file://` for the `icon`. node-webkit supports jpg / png files +you can use `http://` or `file://` for the `icon`. NW.js supports jpg / png files ## Windows ### Balloon Notification if no icon is specified, it will use the app's icon. icon size must be >= 32x32 -### Toast Notification (requires node-webkit >= v0.11) +### Toast Notification (requires NW.js >= v0.11) * Only for Win8 (or newer) * The icon must be using `file://` * A shortcut to your app, with a System.AppUserModel.ID, must be installed to the Start screen. Note, however, that it does not need to be pinned to the Start screen. For more information, see How to enable desktop toast notifications through an AppUserModelID (http://msdn.microsoft.com/en-us/library/windows/desktop/hh802762(v=vs.85).aspx). @@ -76,6 +76,6 @@ The AppUserModelID can be specified in package.json file ``` if it is not, it will use the application name as the AppUserModelID -for complete sample code, go here https://github.com/rogerwang/node-webkit/tree/master/tests/manual_tests/notification +for complete sample code, go here https://github.com/nwjs/nw.js/tree/master/tests/manual_tests/notification