@oat-sa/tao-core-ui 1.60.2 → 1.62.0

package/dist/incrementer.js

@@ -5,10 +5,10 @@ define(['jquery', 'lodash', 'core/pluginifier', 'lib/gamp/gamp'], function ($, _
     Pluginifier = Pluginifier && Object.prototype.hasOwnProperty.call(Pluginifier, 'default') ? Pluginifier['default'] : Pluginifier;
     gamp = gamp && Object.prototype.hasOwnProperty.call(gamp, 'default') ? gamp['default'] : gamp;
 
-    /**
-     * @author Bertrand Chevrier <bertrand@taotesting.com>
-     * @requires jquery
-     * @requires core/pluginifier
+    /**
+     * @author Bertrand Chevrier <bertrand@taotesting.com>
+     * @requires jquery
+     * @requires core/pluginifier
      */
     var ns = 'incrementer';
     var dataNs = 'ui.' + ns;
@@ -23,31 +23,32 @@ define(['jquery', 'lodash', 'core/pluginifier', 'lib/gamp/gamp'], function ($, _
       incrementerWrapperClass: 'incrementer-ctrl-wrapper',
       decimal: 0
     };
-    /**
-     * The Incrementer component, it transforms a text input in an number input, the data-attr way
-     * (has the HTML5 number input type is not yet very well supported, we don't use polyfill to have a consistent UI)
-     * @exports ui/incrementer
-     */
 
+    /**
+     * The Incrementer component, it transforms a text input in an number input, the data-attr way
+     * (has the HTML5 number input type is not yet very well supported, we don't use polyfill to have a consistent UI)
+     * @exports ui/incrementer
+     */
     var Incrementer = {
-      /**
-       * Initialize the plugin.
-       *
-       * Called the jQuery way once registered by the Pluginifier.
-       * @example $('selector').incrementer({step : 1, min : 0, max : 12 });
-       * @public
-       *
-       * @constructor
-       * @param {Object} [options] - the plugin options
-       * @param {Number} [options.step = 1] - the increment step
-       * @param {Number} [options.min] - the minimum value
-       * @param {Number} [options.max] - the maximum value
-       * @param {Number} [options.zero] - whether input can take zero value even in min value more than zero
-       * @returns {jQueryElement} for chaining
+      /**
+       * Initialize the plugin.
+       *
+       * Called the jQuery way once registered by the Pluginifier.
+       * @example $('selector').incrementer({step : 1, min : 0, max : 12 });
+       * @public
+       *
+       * @constructor
+       * @param {Object} [options] - the plugin options
+       * @param {Number} [options.step = 1] - the increment step
+       * @param {Number} [options.min] - the minimum value
+       * @param {Number} [options.max] - the maximum value
+       * @param {Number} [options.zero] - whether input can take zero value even in min value more than zero
+       * @returns {jQueryElement} for chaining
        */
-      init: function init(options) {
-        var self = Incrementer; //get options using default
+      init: function (options) {
+        var self = Incrementer;
 
+        //get options using default
         options = _.defaults(options || {}, defaults);
         return this.each(function () {
           var $elt = $(this);
@@ -55,7 +56,6 @@ define(['jquery', 'lodash', 'core/pluginifier', 'lib/gamp/gamp'], function ($, _
             class: options.incrementerWrapperClass
           });
           var $ctrl, currentValue;
-
           if (!$elt.data(dataNs)) {
             //basic type checking
             if (!$elt.is('input[type="text"]')) {
@@ -65,50 +65,50 @@ define(['jquery', 'lodash', 'core/pluginifier', 'lib/gamp/gamp'], function ($, _
               $elt.wrap(wrapper);
               $elt.data(dataNs, options) //add data to the element
               .addClass(options.incrementerClass) //add the css class
-              .after( //set up controls
+              .after(
+              //set up controls
               '<span class="ctrl ' + options.incrementerCtrlClass + '">' + '<a href="#" class="inc" title="+' + options.step + '" tabindex="-1"></a>' + '<a href="#" class="dec" title="-' + options.step + '" tabindex="-1"></a>' + '</span>').on('keydown', function (e) {
                 if (e.which === 38) {
                   //up
                   self._inc($elt);
-
                   this.select();
                 } else if (e.which === 40) {
                   //down
                   self._dec($elt);
-
                   this.select();
                 }
-              }) //debounce the keyup callback to give the user a chance to complete an invalid state
+              })
+              //debounce the keyup callback to give the user a chance to complete an invalid state
               //(for instance, while taping an negative value)
               .on('keyup', _.debounce(function () {
                 var value = $elt.val(),
-                    negative = value.charAt(0) === '-',
-                    options = $elt.data(dataNs); //sanitize the string by removing all invalid characters (only allow digit and dot)
+                  negative = value.charAt(0) === '-',
+                  options = $elt.data(dataNs);
 
+                //sanitize the string by removing all invalid characters (only allow digit and dot)
                 value = parseFloat(value.replace(/[^\d\.]/g, ''));
-
                 if (isNaN(value)) {
                   //allow empty input
                   $elt.val('');
                 } else {
                   //allow negative values
-                  value = negative ? -value : value; //check if the min and max are respected:
+                  value = negative ? -value : value;
 
+                  //check if the min and max are respected:
                   if (options.min === null || _.isNumber(options.min) && value >= options.min || options.zero === true && value === 0) {
                     $elt.val(value);
                   } else {
                     $elt.val(options.min);
                     value = options.min;
                   }
-
                   if (options.max === null || _.isNumber(options.max) && value <= options.max) {
                     $elt.val(value);
                   } else {
                     $elt.val(options.max);
                   }
-                } //trigger change again after the input has been corrected
-
+                }
 
+                //trigger change again after the input has been corrected
                 $elt.trigger('change');
               }, 600)).on('focus', function () {
                 this.select();
@@ -118,174 +118,155 @@ define(['jquery', 'lodash', 'core/pluginifier', 'lib/gamp/gamp'], function ($, _
               }).on('enable.incrementer', function () {
                 $elt.prop('disabled', false).removeClass('disabled');
                 $ctrl.find('.inc,.dec').removeProp('disabled').removeClass('disabled');
-              }); //set up the default value if needed
+              });
 
+              //set up the default value if needed
               if (_.isNaN(currentValue) || options.min !== null && currentValue < options.min || options.max !== null && currentValue > options.max) {
                 $elt.val(options.min || 0);
               }
-
               $ctrl = $elt.next('.' + options.incrementerCtrlClass);
               $ctrl.find('.inc').click(function (e) {
                 e.preventDefault();
-
                 if (!$(this).prop('disabled')) {
                   self._inc($elt);
                 }
               });
               $ctrl.find('.dec').click(function (e) {
                 e.preventDefault();
-
                 if (!$(this).prop('disabled')) {
                   self._dec($elt);
                 }
               });
-              /**
-               * The plugin have been created.
-               * @event Incrementer#create.incrementer
-               */
 
+              /**
+               * The plugin have been created.
+               * @event Incrementer#create.incrementer
+               */
               $elt.trigger('create.' + ns);
             }
           }
         });
       },
-      _toFixedDown: function _toFixedDown(number, precision) {
+      _toFixedDown: function (number, precision) {
         var m = Math.pow(10, precision || 0);
         return Math.floor(number * m) / m;
       },
-      _decimalPlaces: function _decimalPlaces(number) {
+      _decimalPlaces: function (number) {
         var match = ('' + number).match(/(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/);
-
         if (!match) {
           return 0;
         }
-
         return Math.max(0, (match[1] ? match[1].length : 0) - (match[2] ? +match[2] : 0));
       },
-
-      /**
-       * Increment value
-       *
-       * @private
-       * @param {jQueryElement} $elt - plugin's element
-       * @fires Incrementer#plus.incrementer
+      /**
+       * Increment value
+       *
+       * @private
+       * @param {jQueryElement} $elt - plugin's element
+       * @fires Incrementer#plus.incrementer
        */
-      _inc: function _inc($elt) {
+      _inc: function ($elt) {
         var options = $elt.data(dataNs),
-            current = parseFloat($elt.val() || 0),
-            value;
+          current = parseFloat($elt.val() || 0),
+          value;
         value = gamp.add(current, options.step);
-
         if (_.isNumber(options.min) && value < options.min) {
           value = options.min;
         }
-
         if (options.max === null || _.isNumber(options.max) && value <= options.max) {
           $elt.val(value);
-          /**
-           * The target has been toggled.
-           * @event Incrementer#increment.incrementer
-           */
 
+          /**
+           * The target has been toggled.
+           * @event Incrementer#increment.incrementer
+           */
           $elt.trigger('increment.' + ns, [value]).trigger('change');
         }
       },
-
-      /**
-       * Decrement value
-       *
-       * @private
-       * @param {jQueryElement} $elt - plugin's element
-       * @fires Incrementer#minus.incrementer
+      /**
+       * Decrement value
+       *
+       * @private
+       * @param {jQueryElement} $elt - plugin's element
+       * @fires Incrementer#minus.incrementer
        */
-      _dec: function _dec($elt) {
+      _dec: function ($elt) {
         var options = $elt.data(dataNs),
-            current = parseFloat($elt.val() || 0),
-            value;
+          current = parseFloat($elt.val() || 0),
+          value;
         value = gamp.sub(current, options.step);
-
         if (options.zero === true && _.isNumber(options.min) && value < options.min) {
           value = 0;
         }
-
         if (options.min === null || _.isNumber(options.min) && value >= options.min || options.zero === true && value === 0) {
           $elt.val(value);
-          /**
-           * The target has been toggled.
-           * @event Incrementer#decrement.incrementer
-           */
 
+          /**
+           * The target has been toggled.
+           * @event Incrementer#decrement.incrementer
+           */
           $elt.trigger('decrement.' + ns, [value]).trigger('change');
         }
       },
-
-      /**
-       * Destroy completely the plugin.
-       *
-       * Called the jQuery way once registered by the Pluginifier.
-       * @example $('selector').incrementer('destroy');
-       * @public
+      /**
+       * Destroy completely the plugin.
+       *
+       * Called the jQuery way once registered by the Pluginifier.
+       * @example $('selector').incrementer('destroy');
+       * @public
        */
-      destroy: function destroy() {
+      destroy: function () {
         this.each(function () {
           var $elt = $(this);
           var options = $elt.data(dataNs);
           $elt.off('keyup keydown').siblings('.' + options.incrementerCtrlClass).remove();
-          /**
-           * The plugin have been destroyed.
-           * @event Incrementer#destroy.incrementer
-           */
 
+          /**
+           * The plugin have been destroyed.
+           * @event Incrementer#destroy.incrementer
+           */
           $elt.trigger('destroy.' + ns);
         });
       }
-    }; //Register the incrementer to behave as a jQuery plugin.
+    };
 
+    //Register the incrementer to behave as a jQuery plugin.
     Pluginifier.register(ns, Incrementer);
-    /**
-     * The only exposed function is used to start listening on data-attr
-     *
-     * @public
-     * @example define(['ui/incrementer'], function(incrementer){ incrementer($('rootContainer')); });
-     * @param {jQueryElement} $container - the root context to listen in
-     */
 
+    /**
+     * The only exposed function is used to start listening on data-attr
+     *
+     * @public
+     * @example define(['ui/incrementer'], function(incrementer){ incrementer($('rootContainer')); });
+     * @param {jQueryElement} $container - the root context to listen in
+     */
     function listenDataAttr($container) {
       $container.find('[data-increment]').each(function () {
         var $elt = $(this);
-
         var decimal = Incrementer._decimalPlaces($elt.attr('data-increment'));
-
         var step = parseFloat($elt.attr('data-increment'));
         var zero = !!$elt.data('zero');
         var min, max;
         var options = {};
         options.zero = zero;
-
         if (!_.isNaN(step)) {
           options.step = step;
         }
-
         if (!_.isNaN(decimal)) {
           options.decimal = decimal;
         }
-
         if ($elt.attr('data-min')) {
           min = parseFloat($elt.attr('data-min'));
-
           if (!_.isNaN(min)) {
             options.min = min;
           }
         }
-
         if ($elt.attr('data-max')) {
           max = parseFloat($elt.attr('data-max'));
-
           if (!_.isNaN(max)) {
             options.max = max;
           }
         }
-
         $elt.incrementer(options);
       });
     }