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

package/dist/autocomplete.js

@@ -6,33 +6,33 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
     capitalize = capitalize && Object.prototype.hasOwnProperty.call(capitalize, 'default') ? capitalize['default'] : capitalize;
     tooltip = tooltip && Object.prototype.hasOwnProperty.call(tooltip, 'default') ? tooltip['default'] : tooltip;
 
-    /**
-     * 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) 2015-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) 2015-2020 (original work) Open Assessment Technologies SA ;
      */
 
-    /**
-     * Namespace for component
-     * @type {String}
+    /**
+     * Namespace for component
+     * @type {String}
      */
     var NS = 'autocompleter';
 
-    /**
-     * Default config for tooltip displayed when the server returns less records than available
-     * @type {Object}
+    /**
+     * Default config for tooltip displayed when the server returns less records than available
+     * @type {Object}
      */
     var tooltipConfigTooMany = {
       container: $('body').get(0),
@@ -40,170 +40,170 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
     };
     var toolTipMessage = __('Too many suggestions match your query. Only a few are listed');
 
-    /**
-     * A list of default values for allowed options
-     * @type {Object}
+    /**
+     * A list of default values for allowed options
+     * @type {Object}
      */
     var defaults = {
-      /**
-       * The name of the wrapped plugin
-       * @type {String}
+      /**
+       * The name of the wrapped plugin
+       * @type {String}
        */
       pluginName: 'autocomplete',
-      /**
-       * Defines the URL to data source
-       * @type {String}
+      /**
+       * Defines the URL to data source
+       * @type {String}
        */
       url: null,
-      /**
-       * Defines a list of extra params to be sent with the query.
-       * @type {Object}
+      /**
+       * Defines a list of extra params to be sent with the query.
+       * @type {Object}
        */
       params: null,
-      /**
-       * Defines the root for seach params.
-       * When provided, all the search params are wrapped under the same root.
-       * @type {String}
+      /**
+       * Defines the root for seach params.
+       * When provided, all the search params are wrapped under the same root.
+       * @type {String}
        */
       paramsRoot: null,
-      /**
-       * Defines the name of the param providing the ontology URI
-       * @type {String|String[]}
+      /**
+       * Defines the name of the param providing the ontology URI
+       * @type {String|String[]}
        */
       ontologyParam: 'rootNode',
-      /**
-       * Defines the name of the param providing the searched pattern
-       * @type {String}
+      /**
+       * Defines the name of the param providing the searched pattern
+       * @type {String}
        */
       queryParam: 'query',
-      /**
-       * Defines the request method. Can be either GET or POST, default to GET.
-       * @type {String}
+      /**
+       * Defines the request method. Can be either GET or POST, default to GET.
+       * @type {String}
        */
       type: 'GET',
-      /**
-       * Defines the URI of the target ontology.
-       * @type {String}
+      /**
+       * Defines the URI of the target ontology.
+       * @type {String}
        */
       ontology: null,
-      /**
-       * The current value
-       * @type {String}
+      /**
+       * The current value
+       * @type {String}
        */
       value: null,
-      /**
-       * The current label
-       * @type {String}
+      /**
+       * The current label
+       * @type {String}
        */
       label: null,
-      /**
-       * Defines the name of the field containing the value within the received data.
-       * @type {String}
+      /**
+       * Defines the name of the field containing the value within the received data.
+       * @type {String}
        */
       valueField: 'id',
-      /**
-       * Defines the name of the field containing the label within the received data.
-       * @type {String}
+      /**
+       * Defines the name of the field containing the label within the received data.
+       * @type {String}
        */
       labelField: 'http://www.w3.org/2000/01/rdf-schema#label',
-      /**
-       * When set to true the component acts as a data provider.
-       * In this mode, each time an item is selected from a list,
-       * it will be directly removed from the input, so the listener
-       * has to take care of the selected value and to add it in its own list.
-       * @type {Boolean}
+      /**
+       * When set to true the component acts as a data provider.
+       * In this mode, each time an item is selected from a list,
+       * it will be directly removed from the input, so the listener
+       * has to take care of the selected value and to add it in its own list.
+       * @type {Boolean}
        */
       isProvider: false,
-      /**
-       * When set to true the component prevents auto submit when the user hit enter on the text box.
-       * @type {Boolean}
+      /**
+       * When set to true the component prevents auto submit when the user hit enter on the text box.
+       * @type {Boolean}
        */
       preventSubmit: false,
-      /**
-       * Number of milliseconds to defer ajax request.
-       * @type {Number}
+      /**
+       * Number of milliseconds to defer ajax request.
+       * @type {Number}
        */
       delay: 250,
-      /**
-       * Minimum number of characters required to trigger the ajax request.
-       * @type {Number}
+      /**
+       * Minimum number of characters required to trigger the ajax request.
+       * @type {Number}
        */
       minChars: 3,
-      /**
-       * Flag used to checks if too many suggestions are available on server side for the current query
-       * @type {Boolean}
+      /**
+       * Flag used to checks if too many suggestions are available on server side for the current query
+       * @type {Boolean}
        */
       tooManySuggestions: false,
-      /**
-       * Flag used to auto add a wildcard char at the end of the query.
-       * @type {Boolean}
+      /**
+       * Flag used to auto add a wildcard char at the end of the query.
+       * @type {Boolean}
        */
       addWilcard: false
     };
     var autocompleter = {
-      /**
-       * @event beforeSelectItem Fired when the user select a suggestion in the list.
-       * @param {Event} event
-       * @param {String} value
-       * @param {String} label
-       * @param {autocompleter} instance
-       * @returns {Boolean} The handler can returns `false` to prevent default handling
+      /**
+       * @event beforeSelectItem Fired when the user select a suggestion in the list.
+       * @param {Event} event
+       * @param {String} value
+       * @param {String} label
+       * @param {autocompleter} instance
+       * @returns {Boolean} The handler can returns `false` to prevent default handling
        */
 
-      /**
-       * @event selectItem Fired after the user has selected a suggestion in the list.
-       * @param {Event} event
-       * @param {String} value
-       * @param {String} label
-       * @param {autocompleter} instance
+      /**
+       * @event selectItem Fired after the user has selected a suggestion in the list.
+       * @param {Event} event
+       * @param {String} value
+       * @param {String} label
+       * @param {autocompleter} instance
        */
 
-      /**
-       * @event searchStart Fired when the user input text and a query is about to be requested.
-       * @param {Event} event
-       * @param {Object} params The list of params which will be bound the query
-       * @param {autocompleter} instance
-       * @returns {Boolean} The handler can returns `false` to prevent default handling
+      /**
+       * @event searchStart Fired when the user input text and a query is about to be requested.
+       * @param {Event} event
+       * @param {Object} params The list of params which will be bound the query
+       * @param {autocompleter} instance
+       * @returns {Boolean} The handler can returns `false` to prevent default handling
        */
 
-      /**
-       * @event searchComplete Fired after ajax response is processed.
-       * @param {Event} event
-       * @param {String} query The requested fragment
-       * @param {Object} suggestions An array containing the results.
-       * @param {autocompleter} instance
+      /**
+       * @event searchComplete Fired after ajax response is processed.
+       * @param {Event} event
+       * @param {String} query The requested fragment
+       * @param {Object} suggestions An array containing the results.
+       * @param {autocompleter} instance
        */
 
-      /**
-       * @event searchError Fired if ajax request fails.
-       * @param {Event} event
-       * @param {String} query
-       * @param {jqXHR} jqXHR
-       * @param {String} textStatus
-       * @param {Exception} errorThrown
-       * @param {autocompleter} instance
+      /**
+       * @event searchError Fired if ajax request fails.
+       * @param {Event} event
+       * @param {String} query
+       * @param {jqXHR} jqXHR
+       * @param {String} textStatus
+       * @param {Exception} errorThrown
+       * @param {autocompleter} instance
        */
 
-      /**
-       * @event invalidateSelection Fired when input is altered after selection has been made.
-       * @param {Event} event
-       * @param {autocompleter} instance
+      /**
+       * @event invalidateSelection Fired when input is altered after selection has been made.
+       * @param {Event} event
+       * @param {autocompleter} instance
        */
 
-      /**
-       * @event beforeRender Fired before displaying the suggestions.
-       * You may manipulate suggestions DOM before it is displayed.
-       * @param {Event} event
-       * @param {jQuery} $container
-       * @param {autocompleter} instance
+      /**
+       * @event beforeRender Fired before displaying the suggestions.
+       * You may manipulate suggestions DOM before it is displayed.
+       * @param {Event} event
+       * @param {jQuery} $container
+       * @param {autocompleter} instance
        */
 
-      /**
-       * Initializes the component. Installs the autocompleter onto an element.
-       * @param {jQuery|Element|String} element The element on which install the autocompleter
-       * @param {Object} options A list of options to set
-       * The complete list of plugin options can be found at: https://github.com/devbridge/jQuery-Autocomplete
-       * @returns {autocompleter} this
+      /**
+       * Initializes the component. Installs the autocompleter onto an element.
+       * @param {jQuery|Element|String} element The element on which install the autocompleter
+       * @param {Object} options A list of options to set
+       * The complete list of plugin options can be found at: https://github.com/devbridge/jQuery-Autocomplete
+       * @returns {autocompleter} this
        */
       init: function (element, options) {
         // fetch the element to handle, we need an input element
@@ -229,11 +229,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         this.$element[this.pluginName](this.parseOptions(options));
         return this;
       },
-      /**
-       * Destroys the wrapped plugin instance.
-       * All events are detached and suggestion containers removed.
-       * The value is conserved.
-       * @returns {autocompleter} this
+      /**
+       * Destroys the wrapped plugin instance.
+       * All events are detached and suggestion containers removed.
+       * The value is conserved.
+       * @returns {autocompleter} this
        */
       destroy: function () {
         this.applyPlugin('dispose');
@@ -244,13 +244,13 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         this.$element = null;
         return this;
       },
-      /**
-       * Parses the provided options and filters them.
-       * Separates the component options from those which go the plugin instance.
-       * Immediately applies the component options, returns the plugin options.
-       * @param {Object} options A list of options to filter.
-       * The complete list of plugin options can be found at: https://github.com/devbridge/jQuery-Autocomplete
-       * @returns {Object} Returns the list of plugin options and their values.
+      /**
+       * Parses the provided options and filters them.
+       * Separates the component options from those which go the plugin instance.
+       * Immediately applies the component options, returns the plugin options.
+       * @param {Object} options A list of options to filter.
+       * The complete list of plugin options can be found at: https://github.com/devbridge/jQuery-Autocomplete
+       * @returns {Object} Returns the list of plugin options and their values.
        */
       parseOptions: function (options) {
         var self = this;
@@ -295,21 +295,21 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         });
         return pluginOptions;
       },
-      /**
-       * Applies options onto the component and the wrapped plugin instance.
-       * @param {Object} options A list of named options to set.
-       * The complete list of plugin options can be found at: https://github.com/devbridge/jQuery-Autocomplete
-       * @returns {autocompleter} this
+      /**
+       * Applies options onto the component and the wrapped plugin instance.
+       * @param {Object} options A list of named options to set.
+       * The complete list of plugin options can be found at: https://github.com/devbridge/jQuery-Autocomplete
+       * @returns {autocompleter} this
        */
       setOptions: function (options) {
         this.applyPlugin('setOptions', [this.parseOptions(options)]);
         return this;
       },
-      /**
-       * Calls a method on the inner element with the provided list of params.
-       * @param {String} action The name of the method to call
-       * @param {Array} [params] A list of optional params to pass to the called method
-       * @returns {*} Returns the callee result
+      /**
+       * Calls a method on the inner element with the provided list of params.
+       * @param {String} action The name of the method to call
+       * @param {Array} [params] A list of optional params to pass to the called method
+       * @returns {*} Returns the callee result
        */
       applyElement: function (action, params) {
         var $element = this.$element;
@@ -317,11 +317,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
           return $element[action].apply($element, params);
         }
       },
-      /**
-       * Calls a method on the wrapped plugin with the provided list of params.
-       * @param {String} action The name of the method to call
-       * @param {Array} [params] A list of optional params to pass to the called method
-       * @returns {*} Returns the callee result
+      /**
+       * Calls a method on the wrapped plugin with the provided list of params.
+       * @param {String} action The name of the method to call
+       * @param {Array} [params] A list of optional params to pass to the called method
+       * @returns {*} Returns the callee result
        */
       applyPlugin: function (action, params) {
         var $element = this.$element;
@@ -330,77 +330,77 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
           return $plugin[action].apply($plugin, params);
         }
       },
-      /**
-       * Shows the tooltip displayed when the server returns less records than available
+      /**
+       * Shows the tooltip displayed when the server returns less records than available
        */
       showTooltipTooMany: function () {
         if (this.$element) {
           this.tooltip.show();
         }
       },
-      /**
-       * Hides the tooltip displayed when the server returns less records than available
+      /**
+       * Hides the tooltip displayed when the server returns less records than available
        */
       hideTooltipTooMany: function () {
         if (this.$element) {
           this.tooltip.hide();
         }
       },
-      /**
-       * Fires an event handler.
-       * @param {String} eventName The name of the event to trigger
-       * @param {Array} [params] A list of optional parameters
-       * @returns {*} Returns the call result
+      /**
+       * Fires an event handler.
+       * @param {String} eventName The name of the event to trigger
+       * @param {Array} [params] A list of optional parameters
+       * @returns {*} Returns the call result
        */
       trigger: function (eventName, params) {
         return this.applyElement('triggerHandler', [adjustEventName(eventName), params]);
       },
-      /**
-       * Installs an event handler.
-       * @param {String} eventName The name of the event to listen
-       * @param {Function } callback The function called back when the event occurs
-       * @returns {autocompleter} this
+      /**
+       * Installs an event handler.
+       * @param {String} eventName The name of the event to listen
+       * @param {Function } callback The function called back when the event occurs
+       * @returns {autocompleter} this
        */
       on: function (eventName, callback) {
         this.applyElement('on', [adjustEventName(eventName), callback]);
         return this;
       },
-      /**
-       * Uninstalls an event handler.
-       * @param {String} eventName The name of the event to release
-       * @param {Function } [callback] The callback provided at install
-       * @returns {autocompleter} this
+      /**
+       * Uninstalls an event handler.
+       * @param {String} eventName The name of the event to release
+       * @param {Function } [callback] The callback provided at install
+       * @returns {autocompleter} this
        */
       off: function (eventName, callback) {
         this.applyElement('off', [adjustEventName(eventName), callback]);
         return this;
       },
-      /**
-       * Gets the nested element on which the component is installed.
-       * @returns {*|jQuery|HTMLElement}
+      /**
+       * Gets the nested element on which the component is installed.
+       * @returns {*|jQuery|HTMLElement}
        */
       getElement: function () {
         return this.$element;
       },
-      /**
-       * Checks if the server can provide more suggestions than displayed for the current query
-       * @returns {Boolean}
+      /**
+       * Checks if the server can provide more suggestions than displayed for the current query
+       * @returns {Boolean}
        */
       hasTooManySuggestions: function () {
         return !!this.tooManySuggestions;
       },
-      /**
-       * Gets the field value.
-       * @returns {String}
+      /**
+       * Gets the field value.
+       * @returns {String}
        */
       getValue: function () {
         return this.value;
       },
-      /**
-       * Sets the field value.
-       * @param {String} value The value to set inside the field
-       * @param {String} label The label to display inside the field
-       * @returns {autocompleter} this
+      /**
+       * Sets the field value.
+       * @param {String} value The value to set inside the field
+       * @param {String} label The label to display inside the field
+       * @returns {autocompleter} this
        */
       setValue: function (value, label) {
         this.value = value;
@@ -409,17 +409,17 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
         return this;
       },
-      /**
-       * Gets the displayed label.
-       * @returns {String}
+      /**
+       * Gets the displayed label.
+       * @returns {String}
        */
       getLabel: function () {
         return this.label;
       },
-      /**
-       * Sets the displayed label.
-       * @param {String} label The label to display inside the field
-       * @returns {autocompleter} this
+      /**
+       * Sets the displayed label.
+       * @param {String} label The label to display inside the field
+       * @returns {autocompleter} this
        */
       setLabel: function (label) {
         this.label = label;
@@ -428,117 +428,117 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
         return this;
       },
-      /**
-       * Gets the URI of the target ontology.
-       * @returns {String}
+      /**
+       * Gets the URI of the target ontology.
+       * @returns {String}
        */
       getOntology: function () {
         return this.ontology;
       },
-      /**
-       * Sets the URI of the target ontology.
-       * @param {String} ontology
-       * @returns {autocompleter} this
+      /**
+       * Sets the URI of the target ontology.
+       * @param {String} ontology
+       * @returns {autocompleter} this
        */
       setOntology: function (ontology) {
         this.ontology = ontology;
         return this;
       },
-      /**
-       * Gets the name of the field containing the value within the received data.
-       * @returns {String}
+      /**
+       * Gets the name of the field containing the value within the received data.
+       * @returns {String}
        */
       getValueField: function () {
         return this.valueField;
       },
-      /**
-       * Sets the name of the field containing the value within the received data.
-       * @param {String} valueField
-       * @returns {autocompleter} this
+      /**
+       * Sets the name of the field containing the value within the received data.
+       * @param {String} valueField
+       * @returns {autocompleter} this
        */
       setValueField: function (valueField) {
         this.valueField = valueField;
         return this;
       },
-      /**
-       * Gets the name of the field containing the label within the received data.
-       * @returns {String}
+      /**
+       * Gets the name of the field containing the label within the received data.
+       * @returns {String}
        */
       getLabelField: function () {
         return this.labelField;
       },
-      /**
-       * Sets the name of the field containing the label within the received data.
-       * @param {String} labelField
-       * @returns {autocompleter} this
+      /**
+       * Sets the name of the field containing the label within the received data.
+       * @param {String} labelField
+       * @returns {autocompleter} this
        */
       setLabelField: function (labelField) {
         this.labelField = labelField;
         return this;
       },
-      /**
-       * Gets the value of the isProvider option.
-       * When set to true the component acts as a data provider.
-       * In this mode, each time an item is selected from a list,
-       * it will be directly removed from the input, so the listener
-       * has to take care of the selected value and to add it in its own list.
-       * @returns {Boolean}
+      /**
+       * Gets the value of the isProvider option.
+       * When set to true the component acts as a data provider.
+       * In this mode, each time an item is selected from a list,
+       * it will be directly removed from the input, so the listener
+       * has to take care of the selected value and to add it in its own list.
+       * @returns {Boolean}
        */
       getIsProvider: function () {
         return this.isProvider;
       },
-      /**
-       * Sets the value of the isProvider option.
-       * When set to true the component acts as a data provider.
-       * In this mode, each time an item is selected from a list,
-       * it will be directly removed from the input, so the listener
-       * has to take care of the selected value and to add it in its own list.
-       * @param {Boolean} isProvider
-       * @returns {autocompleter} this
+      /**
+       * Sets the value of the isProvider option.
+       * When set to true the component acts as a data provider.
+       * In this mode, each time an item is selected from a list,
+       * it will be directly removed from the input, so the listener
+       * has to take care of the selected value and to add it in its own list.
+       * @param {Boolean} isProvider
+       * @returns {autocompleter} this
        */
       setIsProvider: function (isProvider) {
         this.isProvider = toBoolean(isProvider);
         return this;
       },
-      /**
-       * Gets the value of the preventSubmit option.
-       * When set to true the component prevents auto submit when the user hit enter on the text box.
-       * @returns {Boolean}
+      /**
+       * Gets the value of the preventSubmit option.
+       * When set to true the component prevents auto submit when the user hit enter on the text box.
+       * @returns {Boolean}
        */
       getPreventSubmit: function () {
         return this.preventSubmit;
       },
-      /**
-       * Sets the value of the preventSubmit option.
-       * When set to true the component prevents auto submit when the user hit enter on the text box.
-       * @param {Boolean} preventSubmit
-       * @returns {autocompleter} this
+      /**
+       * Sets the value of the preventSubmit option.
+       * When set to true the component prevents auto submit when the user hit enter on the text box.
+       * @param {Boolean} preventSubmit
+       * @returns {autocompleter} this
        */
       setPreventSubmit: function (preventSubmit) {
         this.preventSubmit = toBoolean(preventSubmit);
         return this;
       },
-      /**
-       * Gets the root for seach params.
-       * When provided, all the search params are wrapped under the same root.
-       * @returns {String}
+      /**
+       * Gets the root for seach params.
+       * When provided, all the search params are wrapped under the same root.
+       * @returns {String}
        */
       getParamsRoot: function () {
         return this.paramsRoot;
       },
-      /**
-       * Set the root for seach params.
-       * When provided, all the search params are wrapped under the same root.
-       * @param {String} paramsRoot
-       * @returns {autocompleter} this
+      /**
+       * Set the root for seach params.
+       * When provided, all the search params are wrapped under the same root.
+       * @param {String} paramsRoot
+       * @returns {autocompleter} this
        */
       setParamsRoot: function (paramsRoot) {
         this.paramsRoot = paramsRoot;
         return this;
       },
-      /**
-       * Gets the list of extra params to be sent with the query.
-       * @returns {Object}
+      /**
+       * Gets the list of extra params to be sent with the query.
+       * @returns {Object}
        */
       getParams: function () {
         var params = _.merge({}, this.params || {});
@@ -558,161 +558,161 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
         return params;
       },
-      /**
-       * Sets a list of extra params to be sent with the query.
-       * @param {Object} params
-       * @returns {autocompleter} this
+      /**
+       * Sets a list of extra params to be sent with the query.
+       * @param {Object} params
+       * @returns {autocompleter} this
        */
       setParams: function (params) {
         this.params = params;
         return this;
       },
-      /**
-       * Gets the name of the param providing the searched pattern.
-       * If paramsRoot has been defined, the param name will be wrapped.
-       * @returns {String}
+      /**
+       * Gets the name of the param providing the searched pattern.
+       * If paramsRoot has been defined, the param name will be wrapped.
+       * @returns {String}
        */
       getQueryParam: function () {
         return this.adjustParam(this.queryParam);
       },
-      /**
-       * Sets the name of the param providing the searched pattern.
-       * @param {String} queryParam
-       * @returns {autocompleter} this
+      /**
+       * Sets the name of the param providing the searched pattern.
+       * @param {String} queryParam
+       * @returns {autocompleter} this
        */
       setQueryParam: function (queryParam) {
         this.queryParam = queryParam;
         return this;
       },
-      /**
-       * Gets the name of the param providing the ontology URI.
-       * If paramsRoot has been defined, the param name will be wrapped.
-       * @returns {String}
+      /**
+       * Gets the name of the param providing the ontology URI.
+       * If paramsRoot has been defined, the param name will be wrapped.
+       * @returns {String}
        */
       getOntologyParam: function () {
         const p = Array.isArray(this.ontologyParam) ? this.ontologyParam[0] : this.ontologyParam;
         return this.adjustParam(p);
       },
-      /**
-       * Sets the name of the param providing the ontology URI.
-       * @param {String} ontologyParam
-       * @returns {autocompleter} this
+      /**
+       * Sets the name of the param providing the ontology URI.
+       * @param {String} ontologyParam
+       * @returns {autocompleter} this
        */
       setOntologyParam: function (ontologyParam) {
         this.ontologyParam = ontologyParam;
         return this;
       },
-      /**
-       * Gets the URL to data source
-       * @returns {String}
+      /**
+       * Gets the URL to data source
+       * @returns {String}
        */
       getUrl: function () {
         return this.url;
       },
-      /**
-       * Sets the URL to data source
-       * @param {String} url
-       * @returns {autocompleter} this
+      /**
+       * Sets the URL to data source
+       * @param {String} url
+       * @returns {autocompleter} this
        */
       setUrl: function (url) {
         this.url = url;
         return this;
       },
-      /**
-       * Gets the request method. Can be either GET or POST, default to GET.
-       * @returns {String}
+      /**
+       * Gets the request method. Can be either GET or POST, default to GET.
+       * @returns {String}
        */
       getType: function () {
         return this.type || 'GET';
       },
-      /**
-       * Sets the request method. Can be either GET or POST, default to GET.
-       * @param {String} type
-       * @returns {autocompleter} this
+      /**
+       * Sets the request method. Can be either GET or POST, default to GET.
+       * @param {String} type
+       * @returns {autocompleter} this
        */
       setType: function (type) {
         this.type = type;
         return this;
       },
-      /**
-       * Gets the number of miliseconds to defer ajax request.
-       * @returns {number}
+      /**
+       * Gets the number of miliseconds to defer ajax request.
+       * @returns {number}
        */
       getDelay: function () {
         return this.delay;
       },
-      /**
-       * Sets the number of miliseconds to defer ajax request.
-       * @param {Number} delay
-       * @returns {autocompleter}
+      /**
+       * Sets the number of miliseconds to defer ajax request.
+       * @param {Number} delay
+       * @returns {autocompleter}
        */
       setDelay: function (delay) {
         this.delay = Math.max(0, Number(delay));
         return this;
       },
-      /**
-       * Gets the minimum number of characters required to trigger the ajax request.
-       * @returns {number}
+      /**
+       * Gets the minimum number of characters required to trigger the ajax request.
+       * @returns {number}
        */
       getMinChars: function () {
         return this.minChars;
       },
-      /**
-       * Sets the minimum number of characters required to trigger the ajax request.
-       * @param {Number} minChars
-       * @returns {autocompleter} this
+      /**
+       * Sets the minimum number of characters required to trigger the ajax request.
+       * @param {Number} minChars
+       * @returns {autocompleter} this
        */
       setMinChars: function (minChars) {
         this.minChars = Math.max(1, Number(minChars));
         return this;
       },
-      /**
-       * Activates the component if it was deactivated before.
-       * @returns {autocompleter} this
+      /**
+       * Activates the component if it was deactivated before.
+       * @returns {autocompleter} this
        */
       enable: function () {
         this.applyPlugin('enable');
         return this;
       },
-      /**
-       * Deactivates the component.
-       * @returns {autocompleter} this
+      /**
+       * Deactivates the component.
+       * @returns {autocompleter} this
        */
       disable: function () {
         this.applyPlugin('disable');
         return this;
       },
-      /**
-       * Hides suggestions.
-       * @returns {autocompleter} this
+      /**
+       * Hides suggestions.
+       * @returns {autocompleter} this
        */
       hide: function () {
         this.applyPlugin('hide');
         return this;
       },
-      /**
-       * Clears suggestion cache and current suggestions.
-       * @returns {autocompleter} this
+      /**
+       * Clears suggestion cache and current suggestions.
+       * @returns {autocompleter} this
        */
       clear: function () {
         this.tooManySuggestions = false;
         this.applyPlugin('clear');
         return this;
       },
-      /**
-       * Clears suggestion cache.
-       * @returns {autocompleter} this
+      /**
+       * Clears suggestion cache.
+       * @returns {autocompleter} this
        */
       clearCache: function () {
         this.applyPlugin('clearCache');
         return this;
       },
-      /**
-       * Resets the component:
-       * - clears the current selection,
-       * - clears suggestion cache and current suggestions,
-       * - hides suggestions.
-       * @returns {autocompleter} this
+      /**
+       * Resets the component:
+       * - clears the current selection,
+       * - clears suggestion cache and current suggestions,
+       * - hides suggestions.
+       * @returns {autocompleter} this
        */
       reset: function () {
         this.setValue(null, '');
@@ -720,10 +720,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         this.applyPlugin('hide');
         return this;
       },
-      /**
-       * Fired on each keyboard actions
-       * @param {Event} event
-       * @private
+      /**
+       * Fired on each keyboard actions
+       * @param {Event} event
+       * @private
        */
       _onKeyEvent: function (event) {
         // prevent auto submit when the option preventSubmit is enabled
@@ -731,10 +731,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
           event.preventDefault();
         }
       },
-      /**
-       * Fired when the user select a suggestion in the list.
-       * @param {Object} suggestion
-       * @private
+      /**
+       * Fired when the user select a suggestion in the list.
+       * @param {Object} suggestion
+       * @private
        */
       _onSelect: function (suggestion) {
         var value = suggestion && suggestion.data;
@@ -751,10 +751,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
           return false;
         }
       },
-      /**
-       * Fired when the user input text and a query is about to be requested.
-       * @param {Object} params The list of params which will be bound the query
-       * @private
+      /**
+       * Fired when the user input text and a query is about to be requested.
+       * @param {Object} params The list of params which will be bound the query
+       * @private
        */
       _onSearchStart: function (params) {
         var queryParam = this.getQueryParam();
@@ -771,11 +771,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
           return false;
         }
       },
-      /**
-       * Fired after ajax response is processed.
-       * @param {String} query The requested fragment
-       * @param {Object} suggestions An array containing the results.
-       * @private
+      /**
+       * Fired after ajax response is processed.
+       * @param {String} query The requested fragment
+       * @param {Object} suggestions An array containing the results.
+       * @private
        */
       _onSearchComplete: function (query, suggestions) {
         // clear cache when the query returns no records :
@@ -785,53 +785,53 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
         return this.trigger('searchComplete', [query, suggestions, this]);
       },
-      /**
-       * Fired if ajax request fails.
-       * @param {String} query
-       * @param {jqXHR} jqXHR
-       * @param {String} textStatus
-       * @param {Exception} errorThrown
-       * @private
+      /**
+       * Fired if ajax request fails.
+       * @param {String} query
+       * @param {jqXHR} jqXHR
+       * @param {String} textStatus
+       * @param {Exception} errorThrown
+       * @private
        */
       _onSearchError: function (query, jqXHR, textStatus, errorThrown) {
         return this.trigger('searchError', [query, jqXHR, textStatus, errorThrown, this]);
       },
-      /**
-       * Fired when input is altered after selection has been made.
-       * @private
+      /**
+       * Fired when input is altered after selection has been made.
+       * @private
        */
       _onInvalidateSelection: function () {
         return this.trigger('invalidateSelection', [this]);
       },
-      /**
-       * Fired before displaying the suggestions.
-       * You may manipulate suggestions DOM before it is displayed.
-       * @param {jQuery} $container
-       * @private
+      /**
+       * Fired before displaying the suggestions.
+       * You may manipulate suggestions DOM before it is displayed.
+       * @param {jQuery} $container
+       * @private
        */
       _onBeforeRender: function ($container) {
         this.trigger('beforeRender', [$container, this]);
       },
-      /**
-       * Fired when the input element has the focus
-       * @private
+      /**
+       * Fired when the input element has the focus
+       * @private
        */
       _onFocus: function () {
         if (this.hasTooManySuggestions()) {
           this.showTooltipTooMany();
         }
       },
-      /**
-       * Fired when the input element lose the focus
-       * @private
+      /**
+       * Fired when the input element lose the focus
+       * @private
        */
       _onBlur: function () {
         this.hideTooltipTooMany();
       },
-      /**
-       * Adjusts the received data to comply to plugin needs
-       * @param response
-       * @returns {{suggestions: Array}}
+      /**
+       * Adjusts the received data to comply to plugin needs
+       * @param response
+       * @returns {{suggestions: Array}}
        */
       _transformResult: function (response) {
         var self = this;
@@ -859,10 +859,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
         return results;
       },
-      /**
-       * Adjusts a param name: if paramsRoot has been defined, the param name will be wrapped.
-       * @param {String} param
-       * @returns {String}
+      /**
+       * Adjusts a param name: if paramsRoot has been defined, the param name will be wrapped.
+       * @param {String} param
+       * @returns {String}
        */
       adjustParam: function (param) {
         if (this.paramsRoot) {
@@ -872,10 +872,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
       }
     };
 
-    /**
-     * Adjusts an event name
-     * @param {string} eventName
-     * @returns {string}
+    /**
+     * Adjusts an event name
+     * @param {string} eventName
+     * @returns {string}
      */
     function adjustEventName(eventName) {
       var names = _(eventName.split(' ')).map(function (name) {
@@ -888,10 +888,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
       return names.join(' ');
     }
 
-    /**
-     * Converts a value to boolean
-     * @param value
-     * @returns {Boolean}
+    /**
+     * Converts a value to boolean
+     * @param value
+     * @returns {Boolean}
      */
     function toBoolean(value) {
       if (_.isString(value)) {
@@ -902,11 +902,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
       return !!value;
     }
 
-    /**
-     * Installs the autocompleter onto an element.
-     * @param {jQuery|Element|String} element The element on which install the autocompleter
-     * @param {Object} options A list of options to set
-     * @returns {autocompleter} Returns the instance of the autocompleter component
+    /**
+     * Installs the autocompleter onto an element.
+     * @param {jQuery|Element|String} element The element on which install the autocompleter
+     * @param {Object} options A list of options to set
+     * @returns {autocompleter} Returns the instance of the autocompleter component
      */
     function autocompleteFactory(element, options) {
       var autocomplete = _.clone(autocompleter, true);