- add toggler function

   - useful if we want to chain toggling to other object such as
     ldcover.
 - bump version

Author: zbryikt

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## v2.1.0
+
+ - add `toggler` function
+   - useful if we want to chain toggling to other object such as ldcover.
+
+
 ## v2.0.1
 
  - remove deprecated `ldLoader`

README.md

@@ -33,8 +33,11 @@ config includes following options:
  * ctrl: custom animation control unit. should at least contains a member function "step(t)".
    - step(t): will be invoked repeatedly by requestAnimationFrame during loading period. context (aka this) will be root.
  * atomic: default true. when atomic is false, you will need N ldloader.off() call to dismiss ldloader if there was already N ldloader.on() call.
+ * toggler(v): optional toggler triggered when `on/off` status changed. useful for chaining toggling events.
+   - `v`: on/off status.
 
 Methods:
+
  * on(delay): toggle loader on. return promise. (if delay is provided, wait delay(ms) before on )
  * off(delay): toggle loader off. (if delay is provided, wait delay(ms) before off )
  * cancel(v): cancel delayed action. force state to `v` if v is defined.

dist/index.js

@@ -10,6 +10,9 @@
       className: '',
       atomic: true
     }, opt);
+    this._toggler = typeof opt.toggler === 'function'
+      ? opt.toggler
+      : function(){};
     if (opt.zmgr) {
       this.zmgr(opt.zmgr);
     }
@@ -127,7 +130,7 @@
       });
     },
     toggle: function(v, delay, force){
-      var d, this$ = this;
+      var d, ret, this$ = this;
       delay == null && (delay = 0);
       force == null && (force = false);
       d = !(v != null)
@@ -147,7 +150,7 @@
           }, delay);
         });
       }
-      return new Promise(function(res, rej){
+      ret = new Promise(function(res, rej){
         var ref$, running, zmgr;
         this$.count = (ref$ = this$.count + d) > 0 ? ref$ : 0;
         if (!force && !this$.opt.atomic && (this$.count >= 2 || (this$.count === 1 && d < 0))) {
@@ -180,6 +183,9 @@
         }
         return res();
       });
+      return ret.then(function(){
+        return this$._toggler(d > 0 ? true : false);
+      });
     }
   });
   import$(ldloader, {

dist/index.min.js

@@ -3,7 +3,7 @@
   "name": "ldloader",
   "license": "MIT",
   "description": "loader manipulation library",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "files": [
     "dist/**/*"
   ],

package-lock.json

@@ -1,5 +1,6 @@
 ldloader = (opt={}) ->
   @opt = {active-class: \running, base-z: 4000, auto-z: false, class-name: '', atomic: true} <<< opt
+  @_toggler = if typeof(opt.toggler) == \function => opt.toggler else (->)
   if opt.zmgr => @zmgr opt.zmgr
   <[root container]>.map (n) ~> if opt[n] =>
     list = if Array.isArray(opt[n]) => opt[n]
@@ -51,7 +52,7 @@ ldloader.prototype = Object.create(Object.prototype) <<< do
       #if d > 0 => @toggle(v)then ~> setTimeout (~> res!), delay
       # if is off: off after resolve
       #else => setTimeout (~> @toggle(v)then ~> res!), delay
-    new Promise (res, rej) ~>
+    ret = new Promise (res, rej) ~>
       @count = (@count + d >? 0)
       if !force and !@opt.atomic and ( @count >= 2 or (@count == 1 and d < 0)) => return res!
       @root.map ~>
@@ -68,6 +69,7 @@ ldloader.prototype = Object.create(Object.prototype) <<< do
         zmgr.remove @z
         @root.map ~> it.style.zIndex = ""
       res!
+    ret.then ~> @_toggler(if d > 0 => true else false)
 
 ldloader <<< do
   _zmgr: do

package.json

@@ -10,6 +10,9 @@
       className: '',
       atomic: true
     }, opt);
+    this._toggler = typeof opt.toggler === 'function'
+      ? opt.toggler
+      : function(){};
     if (opt.zmgr) {
       this.zmgr(opt.zmgr);
     }
@@ -127,7 +130,7 @@
       });
     },
     toggle: function(v, delay, force){
-      var d, this$ = this;
+      var d, ret, this$ = this;
       delay == null && (delay = 0);
       force == null && (force = false);
       d = !(v != null)
@@ -147,7 +150,7 @@
           }, delay);
         });
       }
-      return new Promise(function(res, rej){
+      ret = new Promise(function(res, rej){
         var ref$, running, zmgr;
         this$.count = (ref$ = this$.count + d) > 0 ? ref$ : 0;
         if (!force && !this$.opt.atomic && (this$.count >= 2 || (this$.count === 1 && d < 0))) {
@@ -180,6 +183,9 @@
         }
         return res();
       });
+      return ret.then(function(){
+        return this$._toggler(d > 0 ? true : false);
+      });
     }
   });
   import$(ldloader, {