Implements dismiss

ptrdo · ptrdo · commit cad6343bceac · 2019-06-18T06:04:28.000-07:00
diff --git a/README.md b/README.md
@@ -155,6 +155,7 @@ See the [Notify Options](#notify-options) or the [code documentation](postette.j
 | `success` | response, alternative | Convenience method for "success" level notification. |
 | `spinner` | response, alternative | Convenience method for "persist" level notification (indefinite). |
 | `done` | response, alternative | Convenience method for "update" level notification (stops spinner with message). |
+| `dismiss` | none | Remotely ends a current notification without message (same result as click-to-close or click-away). |
 | `setCustomLevel` | name | Adds a level of notification message ([CSS overrides](#advanced-usage) will be required for styling). |
 | `setComputeFactor` | value | Sets a per-character multiplier for computing pause-enough for a message to be read. The default is `100` (milliseconds). |
 | `setClickAway` | boolean | When true, `globalClickHandler();` will quit messages and close the log upon firing. |
diff --git a/example/package.json b/example/package.json
@@ -1,6 +1,6 @@
 {
   "name": "postette-example",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Sample implementation demonstrating Postette for the management and execution of notifications to a person interacting with a web client application.",
   "main": "postette.html",
   "repository": "https://github.com/ptrdo/postette.git",
diff --git a/example/postette.html b/example/postette.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="revised" content="2019/01/07">
+  <meta name="revised" content="2019/06/18">
   <title>Postette: Example</title>
   <style>
     @import url(//fonts.googleapis.com/css?family=Roboto:400,700);
@@ -107,6 +107,21 @@
       background: darkorange;
       color: white;
     }
+    form[action=demo] input[type=reset]:active,
+    form[action=demo] input[type=submit]:active {
+      background: saddlebrown;
+      color: silver;
+    }
+    form[action=demo] input[type=button] {
+      cursor: pointer;
+      background: lightgoldenrodyellow;
+      color: darkorange;
+    }
+    form[action=demo] input[type=button]:active {
+      cursor: pointer;
+      background: goldenrod;
+      color: whitesmoke;
+    }
     form[action=demo] input[type=checkbox] {
       display: inline;
       width: auto;
@@ -180,6 +195,7 @@
           <label><input type="checkbox" name="persist"/>Infinity (spinner)</label>
           <hr/>
           <input type="submit" value="Notify!" title="Send a Message" tabindex="0">
+          <input type="button" value="Dismiss" title="End a Message" tabindex="0">
           <input type="reset" value="Reset" title="Reset This Form" tabindex="0">
         </fieldset>
       </form>
@@ -266,6 +282,11 @@
       Postette.log();
     });
     $("form[action=demo]").on("submit", notify);
+    $("form input[value=Dismiss]").on("click", function(event){
+      event.preventDefault();
+      event.stopPropagation();
+      Postette.dismiss();
+    });
 
     $("form").on("click", function(event) {
        event.stopPropagation();
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "postette",
-  "version": "v0.2.0",
+  "version": "v0.3.0",
   "description": "A zero-dependency gadget for the management and execution of notifications to a person interacting with a web client application.",
   "homepage": "https://github.com/ptrdo/postette#readme",
   "main": "",
diff --git a/postette.js b/postette.js
@@ -75,7 +75,7 @@
        * @property {Element} clickerElement // the currently rendered BUTTON (to dismiss).
        */
 
-      var version = "0.2.0",
+      var version = "0.3.0",
           identity = "postette",
           markupId = identity + Date.now(),
           queue = [],
@@ -396,6 +396,7 @@
         clearClassList(element, STATE.active);
 
         timerDone = setTimeout(function () {
+          clearClassList(element, STATE);
           try {
             if (queue.length > 0) {
               execute(queue.pop());
@@ -1409,6 +1410,14 @@
           toaster(response, alternative, STATE.persist);
         },
 
+        /**
+         * dismiss remotely triggers the click event, essentially dismissing the current message.
+         * any queued messages will display as would be expected.
+         *
+         * @public
+         */
+        dismiss: clickHandler,
+
         /**
          * update (or done) is a convenience method to create a toast of state:update.
          * defaults will be applied for all customizable options. No callback allowed.

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "postette-example",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "0.3.0",`
`4`	`4`	`"description": "Sample implementation demonstrating Postette for the management and execution of notifications to a person interacting with a web client application.",`
`5`	`5`	`"main": "postette.html",`
`6`	`6`	`"repository": "https://github.com/ptrdo/postette.git",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "postette",`
`3`		`- "version": "v0.2.0",`
	`3`	`+ "version": "v0.3.0",`
`4`	`4`	`"description": "A zero-dependency gadget for the management and execution of notifications to a person interacting with a web client application.",`
`5`	`5`	`"homepage": "https://github.com/ptrdo/postette#readme",`
`6`	`6`	`"main": "",`