@oat-sa/tao-core-ui 1.64.2 → 1.65.0

package/dist/itemButtonList.js

@@ -18,7 +18,7 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
     function program1(depth0,data) {
       
       var buffer = "", stack1, helper;
-      buffer += "\r\n    <li class=\"buttonlist-item ";
+      buffer += "\n    <li class=\"buttonlist-item ";
       if (helper = helpers.status) { stack1 = helper.call(depth0, {hash:{},data:data}); }
       else { helper = (depth0 && depth0.status); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
       buffer += escapeExpression(stack1);
@@ -30,30 +30,30 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
       if (helper = helpers.id) { stack1 = helper.call(depth0, {hash:{},data:data}); }
       else { helper = (depth0 && depth0.id); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
       buffer += escapeExpression(stack1)
-        + "\">\r\n        <button class=\"buttonlist-btn\"\r\n                role=\"link\"\r\n                ";
+        + "\">\n        <button class=\"buttonlist-btn\"\n                role=\"link\"\n                ";
       stack1 = helpers['if'].call(depth0, (depth0 && depth0.title), {hash:{},inverse:self.noop,fn:self.program(6, program6, data),data:data});
       if(stack1 || stack1 === 0) { buffer += stack1; }
-      buffer += "\r\n                aria-label=\"";
+      buffer += "\n                aria-label=\"";
       if (helper = helpers.ariaLabel) { stack1 = helper.call(depth0, {hash:{},data:data}); }
       else { helper = (depth0 && depth0.ariaLabel); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
       buffer += escapeExpression(stack1)
-        + "\"\r\n                ";
+        + "\"\n                ";
       stack1 = helpers['if'].call(depth0, (depth0 && depth0.disabled), {hash:{},inverse:self.noop,fn:self.program(8, program8, data),data:data});
       if(stack1 || stack1 === 0) { buffer += stack1; }
-      buffer += "\r\n                data-id=\"";
+      buffer += "\n                data-id=\"";
       if (helper = helpers.id) { stack1 = helper.call(depth0, {hash:{},data:data}); }
       else { helper = (depth0 && depth0.id); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
       buffer += escapeExpression(stack1)
-        + "\">\r\n            <span class=\"icon-indicator indicator\" aria-hidden=\"true\"></span>\r\n            ";
+        + "\">\n            <span class=\"icon-indicator indicator\" aria-hidden=\"true\"></span>\n            ";
       stack1 = helpers['if'].call(depth0, (depth0 && depth0.scoreType), {hash:{},inverse:self.noop,fn:self.program(10, program10, data),data:data});
       if(stack1 || stack1 === 0) { buffer += stack1; }
-      buffer += "\r\n            <span class=\"buttonlist-icon";
+      buffer += "\n            <span class=\"buttonlist-icon";
       stack1 = helpers['if'].call(depth0, (depth0 && depth0.icon), {hash:{},inverse:self.noop,fn:self.program(12, program12, data),data:data});
       if(stack1 || stack1 === 0) { buffer += stack1; }
-      buffer += "\" aria-hidden=\"true\"></span>\r\n            <span class=\"buttonlist-label\" aria-hidden=\"true\">";
+      buffer += "\" aria-hidden=\"true\"></span>\n            <span class=\"buttonlist-label\" aria-hidden=\"true\">";
       stack1 = helpers['if'].call(depth0, (depth0 && depth0.numericLabel), {hash:{},inverse:self.noop,fn:self.program(14, program14, data),data:data});
       if(stack1 || stack1 === 0) { buffer += stack1; }
-      buffer += "</span>\r\n        </button>\r\n    </li>\r\n    ";
+      buffer += "</span>\n        </button>\n    </li>\n    ";
       return buffer;
       }
     function program2(depth0,data) {
@@ -92,11 +92,11 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
     function program10(depth0,data) {
       
       var buffer = "", stack1, helper;
-      buffer += "\r\n                <span class=\"buttonlist-score-badge\">\r\n                    <span class=\"buttonlist-score-icon icon-";
+      buffer += "\n                <span class=\"buttonlist-score-badge\">\n                    <span class=\"buttonlist-score-icon icon-";
       if (helper = helpers.scoreType) { stack1 = helper.call(depth0, {hash:{},data:data}); }
       else { helper = (depth0 && depth0.scoreType); stack1 = typeof helper === functionType ? helper.call(depth0, {hash:{},data:data}) : helper; }
       buffer += escapeExpression(stack1)
-        + "\" aria-hidden=\"true\"></span>\r\n                </span>\r\n            ";
+        + "\" aria-hidden=\"true\"></span>\n                </span>\n            ";
       return buffer;
       }
 
@@ -118,10 +118,10 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
       return escapeExpression(stack1);
       }
 
-      buffer += "<ol class=\"buttonlist-items\">\r\n    ";
+      buffer += "<ol class=\"buttonlist-items\">\n    ";
       stack1 = helpers.each.call(depth0, (depth0 && depth0.items), {hash:{},inverse:self.noop,fn:self.program(1, program1, data),data:data});
       if(stack1 || stack1 === 0) { buffer += stack1; }
-      buffer += "\r\n</ol>\r\n";
+      buffer += "\n</ol>\n";
       return buffer;
       });
     function itemButtonListTpl(data, options, asString) {
@@ -129,36 +129,36 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
       return (asString || true) ? html : $(html);
     }
 
-    /**
-     * 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) 2022 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) 2022 Open Assessment Technologies SA ;
      */
 
-    /**
-     * CSS classes involved in the component
-     * @type {Object}
+    /**
+     * CSS classes involved in the component
+     * @type {Object}
      */
     const cssClasses = {
       active: 'buttonlist-item-active',
       keyfocused: 'buttonlist-btn-focus'
     };
 
-    /**
-     * CSS selectors that match some particular elements
-     * @type {Object}
+    /**
+     * CSS selectors that match some particular elements
+     * @type {Object}
      */
     const cssSelectors = {
       active: `.${cssClasses.active}`,
@@ -168,29 +168,29 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
       navigableById: id => `.buttonlist-btn[data-id="${id}"]`
     };
 
-    /**
-     * @typedef {Object} ItemButton
-     * @property {String} id - item id
-     * @property {Number} position - 0-based list index
-     * @property {String} numericLabel - displayed number
-     * @property {String} ariaLabel
-     * @property {String} status - 'answered'/'viewed'/'unseen'
-     * @property {String} scoreType - 'correct'/'incorrect'/null
-     * @property {String} icon - 'info'/'flagged'/null
-     * @property {Boolean} disabled
-     * @property {String} [title] - optional tooltip
+    /**
+     * @typedef {Object} ItemButton
+     * @property {String} id - item id
+     * @property {Number} position - 0-based list index
+     * @property {String} numericLabel - displayed number
+     * @property {String} ariaLabel
+     * @property {String} status - 'answered'/'viewed'/'unseen'
+     * @property {String} scoreType - 'correct'/'incorrect'/null
+     * @property {String} icon - 'info'/'flagged'/null
+     * @property {Boolean} disabled
+     * @property {String} [title] - optional tooltip
      */
-    /**
-     * Item Button List
-     * Ordered list of buttons representing items from a testMap section
-     * Mostly presentational component
-     *
-     * @param {Object} config
-     * @param {ItemButton[]} [config.items] - The list of entries to display
-     * @param {String|jQuery|HTMLElement} [scrollContainer] - scroll container element, for autoscroll
-     * @returns {component}
-     * @fires ready - When the component is ready to work
-     * @fires click When an item is selected by the user
+    /**
+     * Item Button List
+     * Ordered list of buttons representing items from a testMap section
+     * Mostly presentational component
+     *
+     * @param {Object} config
+     * @param {ItemButton[]} [config.items] - The list of entries to display
+     * @param {String|jQuery|HTMLElement} [scrollContainer] - scroll container element, for autoscroll
+     * @returns {component}
+     * @fires ready - When the component is ready to work
+     * @fires click When an item is selected by the user
      */
     function itemButtonListFactory() {
       let config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
@@ -198,17 +198,17 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
       let activeItemId = null;
 
       //jQuery or HTMLElement!
-      /**
-       * Get scroll container element
-       * @returns {HTMLElement}
+      /**
+       * Get scroll container element
+       * @returns {HTMLElement}
        */
       const getScrollContainer = () => {
         return config.scrollContainer || component.getElement();
       };
 
-      /**
-       * Selects the active item
-       * @param {String|null} itemId
+      /**
+       * Selects the active item
+       * @param {String|null} itemId
        */
       const selectItem = itemId => {
         // first deactivate already active elements
@@ -228,11 +228,11 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
         }
       };
 
-      /**
-       * Update single item properties:
-       * Only `icon`, `numericLabel`, `ariaLabel` are supported
-       * @param {String} itemId
-       * @param {Object} itemData
+      /**
+       * Update single item properties:
+       * Only `icon`, `numericLabel`, `ariaLabel` are supported
+       * @param {String} itemId
+       * @param {Object} itemData
        */
       const updateItemData = (itemId, itemData) => {
         const $target = component.getElement().find(cssSelectors.itemById(itemId));
@@ -257,9 +257,9 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
         }
       };
 
-      /**
-       * 'tabfocus' styling, for Safari until :focus-visible supported
-       * @param {jQuery|null}  $target
+      /**
+       * 'tabfocus' styling, for Safari until :focus-visible supported
+       * @param {jQuery|null}  $target
        */
       const setFocusStyle = $target => {
         component.getElement().find(cssSelectors.keyfocused).removeClass(cssClasses.keyfocused);
@@ -268,53 +268,53 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
         }
       };
 
-      /**
-       * Apply a callback on each navigable element
-       * @param {*} callback
+      /**
+       * Apply a callback on each navigable element
+       * @param {*} callback
        */
       const eachNavigable = callback => {
         component.getElement().find(cssSelectors.navigable).each(callback);
       };
 
-      /**
-       * Enables the keyboard navigation using 'tab' keys
+      /**
+       * Enables the keyboard navigation using 'tab' keys
        */
       const enableKeyboard = () => {
         eachNavigable((index, el) => el.removeAttribute('tabindex'));
       };
 
-      /**
-       * Disables the keyboard navigation using 'tab' keys
+      /**
+       * Disables the keyboard navigation using 'tab' keys
        */
       const disableKeyboard = () => {
         eachNavigable((index, el) => el.setAttribute('tabindex', -1));
         setFocusStyle(null);
       };
 
-      /**
-       * Emits the click event detailing the clicked item
-       * The active item change should be handled by the consumer through the API, in case it is conditional or asynchronous
-       * @param {String} itemId
+      /**
+       * Emits the click event detailing the clicked item
+       * The active item change should be handled by the consumer through the API, in case it is conditional or asynchronous
+       * @param {String} itemId
        */
       const onClick = itemId => {
-        /**
-         * @event click
-         * @param {String} itemId
+        /**
+         * @event click
+         * @param {String} itemId
          */
         component.trigger('click', {
           id: itemId
         });
       };
 
-      /**
-       * Defines the buttonList API
-       * @type {buttonList}
+      /**
+       * Defines the buttonList API
+       * @type {buttonList}
        */
       const api = {
-        /**
-         * Sets the active item
-         * @param {String} itemId
-         * @returns {buttonList}
+        /**
+         * Sets the active item
+         * @param {String} itemId
+         * @returns {buttonList}
          */
         setActiveItem(itemId) {
           activeItemId = itemId;
@@ -323,12 +323,12 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
           }
           return this;
         },
-        /**
-         * Update single item properties:
-         * Only `icon`, `numericLabel`, `ariaLabel` are supported
-         * @param {String} itemId
-         * @param {Object} itemData
-         * @returns {buttonList}
+        /**
+         * Update single item properties:
+         * Only `icon`, `numericLabel`, `ariaLabel` are supported
+         * @param {String} itemId
+         * @param {Object} itemData
+         * @returns {buttonList}
          */
         updateItem(itemId, itemData) {
           if (this.is('rendered')) {
@@ -338,8 +338,8 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
         }
       };
 
-      /**
-       * @typedef {component} buttonList
+      /**
+       * @typedef {component} buttonList
        */
       component = componentFactory(api, {})
       // set the component's layout
@@ -370,8 +370,8 @@ define(['jquery', 'ui/autoscroll', 'ui/component', 'handlebars', 'lib/handlebars
           disableKeyboard();
         }
 
-        /**
-         * @event ready
+        /**
+         * @event ready
          */
         this.setState('ready', true).trigger('ready');
       })

package/dist/keyNavigation/navigableDomElement.js

@@ -5,64 +5,64 @@ define(['jquery', 'lodash', 'core/eventifier', 'util/shortcut/registry'], functi
     eventifier = eventifier && Object.prototype.hasOwnProperty.call(eventifier, 'default') ? eventifier['default'] : eventifier;
     shortcutRegistry = shortcutRegistry && Object.prototype.hasOwnProperty.call(shortcutRegistry, 'default') ? shortcutRegistry['default'] : shortcutRegistry;
 
-    /*
-     * 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-2020 (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-2020 (original work) Open Assessment Technologies SA;
+     *
      */
     const navigableCls = 'key-navigation-highlight';
     const eventNS = '.ui-key-navigator';
 
-    /**
-     * The list of mandatory methods a navigable element must expose.
-     * @type {String[]}
+    /**
+     * The list of mandatory methods a navigable element must expose.
+     * @type {String[]}
      */
     const navigableApi = ['init', 'destroy', 'getType', 'getElement', 'isVisible', 'isEnabled', 'isFocused', 'blur', 'focus'];
 
-    /**
-     * From a dom element, create a navigable element compatible with ui/KeyNavigator/navigator
-     * @param {String|Element|jQuery} element
-     * @returns {navigableDomElement}
-     * @fires key
-     * @fires blur
-     * @fires focus
+    /**
+     * From a dom element, create a navigable element compatible with ui/KeyNavigator/navigator
+     * @param {String|Element|jQuery} element
+     * @returns {navigableDomElement}
+     * @fires key
+     * @fires blur
+     * @fires focus
      */
     function navigableDomElement(element) {
       const $element = $(element);
       const shortcuts = shortcutRegistry($element);
       let initialTabIndex = null;
 
-      /**
-       * @typedef navigableDomElement
+      /**
+       * @typedef navigableDomElement
        */
       return eventifier({
-        /**
-         * Inits the navigableDomElement instance
-         * @param {Boolean} propagateTab - allows the key event to propagate when the Tab key is pressed.
-         * @returns {navigableDomElement}
+        /**
+         * Inits the navigableDomElement instance
+         * @param {Boolean} propagateTab - allows the key event to propagate when the Tab key is pressed.
+         * @returns {navigableDomElement}
          */
         init() {
           let {
             propagateTab = false
           } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
           const keyboard = (key, el) => {
-            /**
-             * @event key
-             * @param {String} key
-             * @param {Element} el
+            /**
+             * @event key
+             * @param {String} key
+             * @param {Element} el
              */
             this.trigger('key', key, el);
           };
@@ -74,15 +74,15 @@ define(['jquery', 'lodash', 'core/eventifier', 'util/shortcut/registry'], functi
 
           // add a tabindex to enable focusing, this tabindex is not actually used in tabbing order
           $element.addClass(navigableCls).attr('tabindex', -1).on(`focus${eventNS}`, e => {
-            /**
-             * @event focus
-             * @param {Element} el
+            /**
+             * @event focus
+             * @param {Element} el
              */
             this.trigger('focus', e.target);
           }).on(`blur${eventNS}`, e => {
-            /**
-             * @event blur
-             * @param {Element} el
+            /**
+             * @event blur
+             * @param {Element} el
              */
             this.trigger('blur', e.target);
           })
@@ -129,9 +129,9 @@ define(['jquery', 'lodash', 'core/eventifier', 'util/shortcut/registry'], functi
           });
           return this;
         },
-        /**
-         * Destroys the navigableDomElement instance
-         * @returns {navigableDomElement}
+        /**
+         * Destroys the navigableDomElement instance
+         * @returns {navigableDomElement}
          */
         destroy() {
           $element.removeClass(navigableCls).off(eventNS);
@@ -146,53 +146,53 @@ define(['jquery', 'lodash', 'core/eventifier', 'util/shortcut/registry'], functi
           }
           return this;
         },
-        /**
-         * Gets the type of navigable element
-         * @returns {String}
+        /**
+         * Gets the type of navigable element
+         * @returns {String}
          */
         getType() {
           return 'element';
         },
-        /**
-         * Gets the dom element
-         * @returns {jQuery}
+        /**
+         * Gets the dom element
+         * @returns {jQuery}
          */
         getElement() {
           return $element;
         },
-        /**
-         * Checks if the navigable element is visible
-         * @returns {Boolean}
+        /**
+         * Checks if the navigable element is visible
+         * @returns {Boolean}
          */
         isVisible() {
           return $element.is(':visible');
         },
-        /**
-         * Checks if the navigable element is enabled
-         * @returns {Boolean}
+        /**
+         * Checks if the navigable element is enabled
+         * @returns {Boolean}
          */
         isEnabled() {
           return !$element.is(':disabled');
         },
-        /**
-         * Checks if the navigable element is focused
-         * @returns {Boolean}
+        /**
+         * Checks if the navigable element is focused
+         * @returns {Boolean}
          */
         isFocused() {
           const el = $element.get(0);
           return document.activeElement && el === document.activeElement;
         },
-        /**
-         * Removes the focus from the navigable element
-         * @returns {navigableDomElement}
+        /**
+         * Removes the focus from the navigable element
+         * @returns {navigableDomElement}
          */
         blur() {
           $element.blur();
           return this;
         },
-        /**
-         * Sets the focus on the navigable element
-         * @returns {navigableDomElement}
+        /**
+         * Sets the focus on the navigable element
+         * @returns {navigableDomElement}
          */
         focus() {
           $element.focus();
@@ -201,10 +201,10 @@ define(['jquery', 'lodash', 'core/eventifier', 'util/shortcut/registry'], functi
       });
     }
 
-    /**
-     * From a jQuery container, returns an array of navigableDomElement
-     * @param {jQuery|Element[]} $elements
-     * @returns {Array}
+    /**
+     * From a jQuery container, returns an array of navigableDomElement
+     * @param {jQuery|Element[]} $elements
+     * @returns {Array}
      */
     navigableDomElement.createFromDoms = $elements => {
       const list = [];
@@ -219,11 +219,11 @@ define(['jquery', 'lodash', 'core/eventifier', 'util/shortcut/registry'], functi
       return list;
     };
 
-    /**
-     * Checks if the provided object is a valid navigable element
-     *
-     * @param {Object} navigable
-     * @returns {Boolean}
+    /**
+     * Checks if the provided object is a valid navigable element
+     *
+     * @param {Object} navigable
+     * @returns {Boolean}
      */
     navigableDomElement.isNavigableElement = navigable => !!navigable && navigableApi.every(n => 'function' === typeof navigable[n]);