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

package/dist/component/placeable.js

@@ -3,22 +3,22 @@ define(['lodash', 'ui/transformer'], function (_, transformer) { 'use strict';
     _ = _ && Object.prototype.hasOwnProperty.call(_, 'default') ? _['default'] : _;
     transformer = transformer && Object.prototype.hasOwnProperty.call(transformer, 'default') ? transformer['default'] : transformer;
 
-    /**
-     * This program is free software; you can redistribute it and/or
-     * modify it under the terms of the GNU General Public License
-     * as published by the Free Software Foundation; under version 2
-     * of the License (non-upgradable).
-     *
-     * This program is distributed in the hope that it will be useful,
-     * but WITHOUT ANY WARRANTY; without even the implied warranty of
-     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-     * GNU General Public License for more details.
-     *
-     * You should have received a copy of the GNU General Public License
-     * along with this program; if not, write to the Free Software
-     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-     *
-     * Copyright (c) 2016 (original work) Open Assessment Technologies SA;
+    /**
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Public License
+     * as published by the Free Software Foundation; under version 2
+     * of the License (non-upgradable).
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+     *
+     * Copyright (c) 2016 (original work) Open Assessment Technologies SA;
      */
     var defaultConfig = {
       initialX: 0,
@@ -26,167 +26,150 @@ define(['lodash', 'ui/transformer'], function (_, transformer) { 'use strict';
     };
     var positioningMode = 'absolute';
     var placeableComponent = {
-      /**
-       * Set the translation of the component
-       * @param {Number} xOffsetAbsolute
-       * @param {Number} yOffsetAbsolute
-       *
-       * @fires Component#move
-       * @private
+      /**
+       * Set the translation of the component
+       * @param {Number} xOffsetAbsolute
+       * @param {Number} yOffsetAbsolute
+       *
+       * @fires Component#move
+       * @private
        */
       _translate: function _translate(xOffsetAbsolute, yOffsetAbsolute) {
         var $element = this.getElement();
-        transformer.translateXY($element, xOffsetAbsolute, yOffsetAbsolute); // retrieving current translate values is a costly process (see ui/transformer and/or lib/unmatrix)
-        // thus, we store them as custom attributes for later use, and especially when a relative transform will be needed (eg, .moveBy())
+        transformer.translateXY($element, xOffsetAbsolute, yOffsetAbsolute);
 
+        // retrieving current translate values is a costly process (see ui/transformer and/or lib/unmatrix)
+        // thus, we store them as custom attributes for later use, and especially when a relative transform will be needed (eg, .moveBy())
         this._translateX = xOffsetAbsolute;
-        this._translateY = yOffsetAbsolute; // we also save current coordinates instead so we don't need to compute them each time they are needed
+        this._translateY = yOffsetAbsolute;
 
+        // we also save current coordinates instead so we don't need to compute them each time they are needed
         this._x = xOffsetAbsolute + this.config.initialX;
         this._y = yOffsetAbsolute + this.config.initialY;
-        /**
-         * @event Component#move - the component has moved
-         * @param {Number} newX
-         * @param {Number} newY
-         */
 
+        /**
+         * @event Component#move - the component has moved
+         * @param {Number} newX
+         * @param {Number} newY
+         */
         this.trigger('move', this._x, this._y);
       },
-
-      /**
-       * Center the component inside its parent container
-       * @returns {Component} chains
-       *
-       * @fires Component#center
+      /**
+       * Center the component inside its parent container
+       * @returns {Component} chains
+       *
+       * @fires Component#center
        */
       center: function center() {
         var $container = this.getContainer(),
-            $element = this.getElement(),
-            centerX,
-            centerY;
-
+          $element = this.getElement(),
+          centerX,
+          centerY;
         if (this.is('rendered') && !this.is('disabled')) {
           if ($container.length) {
             centerX = $container.width() / 2 - $element.width() / 2;
             centerY = $container.height() / 2 - $element.height() / 2;
             this.moveTo(centerX, centerY);
-            /**
-             * @event Component#center the component has been centered
-             * @param {Number} centerX
-             * @param {Number} centerY
-             */
 
+            /**
+             * @event Component#center the component has been centered
+             * @param {Number} centerX
+             * @param {Number} centerY
+             */
             this.trigger('center', centerX, centerY);
           }
         }
-
         return this;
       },
-
-      /**
-       * Moves the component by the given offset, which is relative to the current position
-       * @param {Number} xOffsetRelative
-       * @param {Number} yOffsetRelative
-       * @returns {Component} chains
+      /**
+       * Moves the component by the given offset, which is relative to the current position
+       * @param {Number} xOffsetRelative
+       * @param {Number} yOffsetRelative
+       * @returns {Component} chains
        */
       moveBy: function moveBy(xOffsetRelative, yOffsetRelative) {
         var xOffsetAbsolute, yOffsetAbsolute;
-
         if (this.is('rendered') && !this.is('disabled')) {
           xOffsetAbsolute = this._translateX + xOffsetRelative;
           yOffsetAbsolute = this._translateY + yOffsetRelative;
-
           this._translate(xOffsetAbsolute, yOffsetAbsolute);
         }
-
         return this;
       },
-
-      /**
-       * Moves the component to the given position
-       * @param {Number} x
-       * @param {Number} y
-       * @returns {Component} chains
+      /**
+       * Moves the component to the given position
+       * @param {Number} x
+       * @param {Number} y
+       * @returns {Component} chains
        */
       moveTo: function moveTo(x, y) {
         var xOffsetAbsolute, yOffsetAbsolute;
-
         if (this.is('rendered') && !this.is('disabled')) {
           xOffsetAbsolute = x - this.config.initialX;
           yOffsetAbsolute = y - this.config.initialY;
-
           this._translate(xOffsetAbsolute, yOffsetAbsolute);
         }
-
         return this;
       },
-
-      /**
-       * Moves the component to the given X position
-       * @param {Number} x
-       * @returns {Component} chains
+      /**
+       * Moves the component to the given X position
+       * @param {Number} x
+       * @returns {Component} chains
        */
       moveToX: function moveToX(x) {
         return this.moveTo(x, this._y);
       },
-
-      /**
-       * Moves the component to the given Y position
-       * @param {Number} y
-       * @returns {Component} chains
+      /**
+       * Moves the component to the given Y position
+       * @param {Number} y
+       * @returns {Component} chains
        */
       moveToY: function moveToY(y) {
         return this.moveTo(this._x, y);
       },
-
-      /**
-       * Restore the default position of the component
-       * @returns {Component} chains
+      /**
+       * Restore the default position of the component
+       * @returns {Component} chains
        */
       resetPosition: function resetPosition() {
         var $element = this.getElement();
-
         if (this.is('rendered')) {
           // set default position
           $element.css({
             left: this.config.initialX,
             top: this.config.initialY
-          }); // reset translations
+          });
 
+          // reset translations
           this._translate(0, 0);
         }
-
         return this;
       },
-
-      /**
-       * Gets the actual position of the component inside its container,
-       * with respect to the possible translation
-       * @returns {Object}
+      /**
+       * Gets the actual position of the component inside its container,
+       * with respect to the possible translation
+       * @returns {Object}
        */
       getPosition: function getPosition() {
         var position;
-
         if (this.is('rendered')) {
           position = {
             x: this._x || 0,
             y: this._y || 0
           };
         }
-
         return position;
       }
     };
-    /**
-     * @param {Component} component - an instance of ui/component
-     * @param {Object} config
-     * @param {Number} config.initialX - x start position
-     * @param {Number} config.initialY - y start position
-     */
 
+    /**
+     * @param {Component} component - an instance of ui/component
+     * @param {Object} config
+     * @param {Number} config.initialX - x start position
+     * @param {Number} config.initialY - y start position
+     */
     function makePlaceable(component, config) {
       _.assign(component, placeableComponent);
-
       return component.off('.makePlaceable').on('init.makePlaceable', function () {
         _.defaults(this.config, config || {}, defaultConfig);
       }).on('render.makePlaceable', function () {
@@ -197,13 +180,12 @@ define(['lodash', 'ui/transformer'], function (_, transformer) { 'use strict';
         this.resetPosition();
       });
     }
-    /**
-     * Check that the given component implements the placeableComponent API
-     * @param {Component} component - an instance of ui/component
-     * @returns {boolean}
-     */
-
 
+    /**
+     * Check that the given component implements the placeableComponent API
+     * @param {Component} component - an instance of ui/component
+     * @returns {boolean}
+     */
     makePlaceable.isPlaceable = function isPlaceable(component) {
       return Object.keys(placeableComponent).every(function (method) {
         return typeof component[method] === 'function';

package/dist/component/resizable.js

@@ -4,22 +4,22 @@ define(['lodash', 'interact', 'ui/component/placeable'], function (_, interact,
     interact = interact && Object.prototype.hasOwnProperty.call(interact, 'default') ? interact['default'] : interact;
     makePlaceable = makePlaceable && Object.prototype.hasOwnProperty.call(makePlaceable, 'default') ? makePlaceable['default'] : makePlaceable;
 
-    /**
-     * This program is free software; you can redistribute it and/or
-     * modify it under the terms of the GNU General Public License
-     * as published by the Free Software Foundation; under version 2
-     * of the License (non-upgradable).
-     *
-     * This program is distributed in the hope that it will be useful,
-     * but WITHOUT ANY WARRANTY; without even the implied warranty of
-     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-     * GNU General Public License for more details.
-     *
-     * You should have received a copy of the GNU General Public License
-     * along with this program; if not, write to the Free Software
-     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-     *
-     * Copyright (c) 2016 (original work) Open Assessment Technologies SA;
+    /**
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Public License
+     * as published by the Free Software Foundation; under version 2
+     * of the License (non-upgradable).
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+     *
+     * Copyright (c) 2016 (original work) Open Assessment Technologies SA;
      */
     var defaultConfig = {
       minWidth: 50,
@@ -32,135 +32,125 @@ define(['lodash', 'interact', 'ui/component/placeable'], function (_, interact,
       }
     };
     var resizableComponent = {
-      /**
-       * Make sure the given value is within given boundaries. If not, set it to the closest boundary.
-       * @param {Number} value
-       * @param {Number} min - lower boundary
-       * @param {Number} max - upper boundary
-       * @returns {Number} The new value
-       * @private
+      /**
+       * Make sure the given value is within given boundaries. If not, set it to the closest boundary.
+       * @param {Number} value
+       * @param {Number} min - lower boundary
+       * @param {Number} max - upper boundary
+       * @returns {Number} The new value
+       * @private
        */
-      _getCappedValue: function _getCappedValue(value, min, max) {
+      _getCappedValue: function (value, min, max) {
         var capped = value;
-
         if (!_.isUndefined(max) && !_.isNull(max)) {
           capped = Math.min(capped, max);
         }
-
         if (!_.isUndefined(min) && !_.isNull(min)) {
           capped = Math.max(capped, min);
         }
-
         return capped;
       },
-
-      /**
-       * Resize the mask (minimum constraints applies)
-       * @param {Number} newWidth - the new width
-       * @param {Number} newHeight - the new height
-       * @param {Boolean} resizeFromLeft - if the left border has been dragged for the resize
-       * @param {Boolean} resizeFromTop - if the bottom border has been dragged for the resize
-       * @returns {Component} chains
-       *
-       * @fires Component#beforeresize
-       * @fires Component#resize
+      /**
+       * Resize the mask (minimum constraints applies)
+       * @param {Number} newWidth - the new width
+       * @param {Number} newHeight - the new height
+       * @param {Boolean} resizeFromLeft - if the left border has been dragged for the resize
+       * @param {Boolean} resizeFromTop - if the bottom border has been dragged for the resize
+       * @returns {Component} chains
+       *
+       * @fires Component#beforeresize
+       * @fires Component#resize
        */
       resizeTo: function resizeTo(newWidth, newHeight, resizeFromLeft, resizeFromTop) {
         var currentSize,
-            newX,
-            newY,
-            rightX,
-            bottomY,
-            position,
-            shouldMove = false;
-
+          newX,
+          newY,
+          rightX,
+          bottomY,
+          position,
+          shouldMove = false;
         if (this.is('rendered') && !this.is('disabled')) {
-          /**
-           * @event Component#beforeresize the component is about to be resized (or not)
-           * @param {Number} width - the new expected width
-           * @param {Number} height - the new expected height
-           * @param {Boolean} resizeFromLeft - if resize happens from the left
-           * @param {Boolean} resizeFromTop - if resize happens from the top
+          /**
+           * @event Component#beforeresize the component is about to be resized (or not)
+           * @param {Number} width - the new expected width
+           * @param {Number} height - the new expected height
+           * @param {Boolean} resizeFromLeft - if resize happens from the left
+           * @param {Boolean} resizeFromTop - if resize happens from the top
            */
           this.trigger('beforeresize', newWidth, newHeight, resizeFromLeft, resizeFromTop);
           currentSize = this.getSize();
           newWidth = this._getCappedValue(newWidth, this.config.minWidth, this.config.maxWidth);
           newHeight = this._getCappedValue(newHeight, this.config.minHeight, this.config.maxHeight);
-          position = this.getPosition(); // make sure the component will stay right-aligned if resized from the left
+          position = this.getPosition();
 
+          // make sure the component will stay right-aligned if resized from the left
           if (resizeFromLeft && newWidth !== currentSize.width) {
             rightX = position.x + currentSize.width;
             newX = rightX - newWidth;
             shouldMove = true;
-          } // make sure the component will stay bottom-aligned if resized from the top
-
+          }
 
+          // make sure the component will stay bottom-aligned if resized from the top
           if (resizeFromTop && newHeight !== currentSize.height) {
             bottomY = position.y + currentSize.height;
             newY = bottomY - newHeight;
             shouldMove = true;
-          } // We can now move the component to its new position, if needed...
-
+          }
 
+          // We can now move the component to its new position, if needed...
           if (shouldMove) {
             this.moveTo(newX || position.x, newY || position.y);
-          } // ... and then resize it!
-
+          }
 
+          // ... and then resize it!
           this.setSize(newWidth, newHeight);
           position = this.getPosition(); // update the position
 
-          /**
-           * @event Component#resize the component has been resized
-           * @param {Number} width - the new width
-           * @param {Number} height - the new height
-           * @param {Boolean} resizeFromLeft - if resize happens from the left
-           * @param {Boolean} resizeFromTop - if resize happens from the top
-           * @param {Number} x - the new x position
-           * @param {Number} y - the new y position
+          /**
+           * @event Component#resize the component has been resized
+           * @param {Number} width - the new width
+           * @param {Number} height - the new height
+           * @param {Boolean} resizeFromLeft - if resize happens from the left
+           * @param {Boolean} resizeFromTop - if resize happens from the top
+           * @param {Number} x - the new x position
+           * @param {Number} y - the new y position
            */
-
           this.trigger('resize', newWidth, newHeight, resizeFromLeft, resizeFromTop, position.x, position.y);
         }
-
         return this;
       }
     };
-    /**
-     * @param {Component} component - an instance of ui/component
-     * @param {Object} config
-     * @param {Number} config.minWidth
-     * @param {Number} config.minHeight
-     * @param {Number} config.maxWidth
-     * @param {Number} config.maxHeight
-     * @param {jQuery|Element} config.resizeRestriction - interact restriction property. See {@link http://interactjs.io/docs/restriction/#restriction}
-     * @param {String} config.ignoreFrom - selectors of elements to ignore pointer events from (interactjs)
-     * @param {Object} config.edges
-     * @param {Object} config.edges.top - is resizing from the top allowed
-     * @param {Object} config.edges.right - is resizing from the right allowed
-     * @param {Object} config.edges.bottom - is resizing from the bottom allowed
-     * @param {Object} config.edges.left - is resizing from the left allowed
-     */
 
+    /**
+     * @param {Component} component - an instance of ui/component
+     * @param {Object} config
+     * @param {Number} config.minWidth
+     * @param {Number} config.minHeight
+     * @param {Number} config.maxWidth
+     * @param {Number} config.maxHeight
+     * @param {jQuery|Element} config.resizeRestriction - interact restriction property. See {@link http://interactjs.io/docs/restriction/#restriction}
+     * @param {String} config.ignoreFrom - selectors of elements to ignore pointer events from (interactjs)
+     * @param {Object} config.edges
+     * @param {Object} config.edges.top - is resizing from the top allowed
+     * @param {Object} config.edges.right - is resizing from the right allowed
+     * @param {Object} config.edges.bottom - is resizing from the bottom allowed
+     * @param {Object} config.edges.left - is resizing from the left allowed
+     */
     function makeResizable(component, config) {
       _.assign(component, resizableComponent);
-
       if (!makePlaceable.isPlaceable(component)) {
         makePlaceable(component);
       }
-
       return component.off('.makeResizable').on('init.makeResizable', function () {
         _.defaults(this.config, config || {}, defaultConfig);
       }).on('render.makeResizable', function () {
         var self = this,
-            $element = this.getElement(),
-            element = $element[0];
+          $element = this.getElement(),
+          element = $element[0];
         $element.css('touch-action', 'none');
-
         if (!this.config.resizeRestriction) {
           this.config.resizeRestriction = this.getContainer()[0];
         }
-
         if (!this.config.ignoreFrom) {
           this.config.ignoreFrom = '.no-resize'; // goal: to preserve text selectability in these form elements
         }

package/dist/component/stackable.js

@@ -3,22 +3,22 @@ define(['lodash', 'ui/stacker'], function (_, stackerFactory) { 'use strict';
     _ = _ && Object.prototype.hasOwnProperty.call(_, 'default') ? _['default'] : _;
     stackerFactory = stackerFactory && Object.prototype.hasOwnProperty.call(stackerFactory, 'default') ? stackerFactory['default'] : stackerFactory;
 
-    /**
-     * This program is free software; you can redistribute it and/or
-     * modify it under the terms of the GNU General Public License
-     * as published by the Free Software Foundation; under version 2
-     * of the License (non-upgradable).
-     *
-     * This program is distributed in the hope that it will be useful,
-     * but WITHOUT ANY WARRANTY; without even the implied warranty of
-     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-     * GNU General Public License for more details.
-     *
-     * You should have received a copy of the GNU General Public License
-     * along with this program; if not, write to the Free Software
-     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-     *
-     * Copyright (c) 2017 (original work) Open Assessment Technologies SA;
+    /**
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Public License
+     * as published by the Free Software Foundation; under version 2
+     * of the License (non-upgradable).
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+     *
+     * Copyright (c) 2017 (original work) Open Assessment Technologies SA;
      */
     var defaultConfig = {
       stackingScope: ''
@@ -26,32 +26,26 @@ define(['lodash', 'ui/stacker'], function (_, stackerFactory) { 'use strict';
     var stackableComponent = {
       bringToFront: function bringToFront() {
         var $element = this.getElement();
-
         this._stacker.bringToFront($element);
       }
     };
-    /**
-     * @param {Component} - an instance of ui/component
-     * @param {Object} config
-     * @param {String} config.stackingScope - scope id for the stacker
-     */
 
+    /**
+     * @param {Component} - an instance of ui/component
+     * @param {Object} config
+     * @param {String} config.stackingScope - scope id for the stacker
+     */
     function makeStackable(component, config) {
       _.assign(component, stackableComponent);
-
       return component.off('.makeStackable').on('init.makeStackable', function () {
         _.defaults(this.config, config || {}, defaultConfig);
-
         this._stacker = stackerFactory(this.config.stackingScope);
       }).on('show.makeStackable', function () {
         this.bringToFront();
       }).on('render.makeStackable', function () {
         var $element = this.getElement();
-
         this._stacker.reset($element);
-
         this._stacker.autoBringToFront($element);
-
         this.bringToFront();
       });
     }