@oat-sa/tao-core-ui 1.54.2 → 1.55.0

package/dist/autocomplete.js

@@ -6,32 +6,32 @@ 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 = {
@@ -40,189 +40,189 @@ 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 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 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 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
-       */
-
-      /**
-       * 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
+      /**
+       * @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 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 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 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
        */
       init: function init(element, options) {
         // fetch the element to handle, we need an input element
@@ -246,11 +246,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         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 destroy() {
         this.applyPlugin('dispose');
@@ -264,13 +264,13 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         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 parseOptions(options) {
         var self = this;
@@ -317,22 +317,22 @@ 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 setOptions(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 applyElement(action, params) {
         var $element = this.$element;
@@ -342,11 +342,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 applyPlugin(action, params) {
         var $element = this.$element;
@@ -357,8 +357,8 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 showTooltipTooMany() {
         if (this.$element) {
@@ -366,8 +366,8 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 hideTooltipTooMany() {
         if (this.$element) {
@@ -375,67 +375,67 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 trigger(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 on(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 off(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 getElement() {
         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 hasTooManySuggestions() {
         return !!this.tooManySuggestions;
       },
 
-      /**
-       * Gets the field value.
-       * @returns {String}
+      /**
+       * Gets the field value.
+       * @returns {String}
        */
       getValue: function getValue() {
         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 setValue(value, label) {
         this.value = value;
@@ -447,18 +447,18 @@ 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 getLabel() {
         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 setLabel(label) {
         this.label = label;
@@ -470,129 +470,129 @@ 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 getOntology() {
         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 setOntology(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 getValueField() {
         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 setValueField(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 getLabelField() {
         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 setLabelField(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 getIsProvider() {
         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 setIsProvider(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 getPreventSubmit() {
         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 setPreventSubmit(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 getParamsRoot() {
         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 setParamsRoot(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 getParams() {
         var _this = this;
@@ -619,157 +619,157 @@ 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 setParams(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 getQueryParam() {
         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 setQueryParam(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 getOntologyParam() {
         var 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 setOntologyParam(ontologyParam) {
         this.ontologyParam = ontologyParam;
         return this;
       },
 
-      /**
-       * Gets the URL to data source
-       * @returns {String}
+      /**
+       * Gets the URL to data source
+       * @returns {String}
        */
       getUrl: function getUrl() {
         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 setUrl(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 getType() {
         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 setType(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 getDelay() {
         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 setDelay(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 getMinChars() {
         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 setMinChars(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 enable() {
         this.applyPlugin('enable');
         return this;
       },
 
-      /**
-       * Deactivates the component.
-       * @returns {autocompleter} this
+      /**
+       * Deactivates the component.
+       * @returns {autocompleter} this
        */
       disable: function disable() {
         this.applyPlugin('disable');
         return this;
       },
 
-      /**
-       * Hides suggestions.
-       * @returns {autocompleter} this
+      /**
+       * Hides suggestions.
+       * @returns {autocompleter} this
        */
       hide: function hide() {
         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 clear() {
         this.tooManySuggestions = false;
@@ -777,21 +777,21 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         return this;
       },
 
-      /**
-       * Clears suggestion cache.
-       * @returns {autocompleter} this
+      /**
+       * Clears suggestion cache.
+       * @returns {autocompleter} this
        */
       clearCache: function clearCache() {
         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 reset() {
         this.setValue(null, '');
@@ -800,10 +800,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         return this;
       },
 
-      /**
-       * Fired on each keyboard actions
-       * @param {Event} event
-       * @private
+      /**
+       * Fired on each keyboard actions
+       * @param {Event} event
+       * @private
        */
       _onKeyEvent: function _onKeyEvent(event) {
         // prevent auto submit when the option preventSubmit is enabled
@@ -812,10 +812,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 _onSelect(suggestion) {
         var value = suggestion && suggestion.data;
@@ -836,10 +836,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 _onSearchStart(params) {
         var queryParam = this.getQueryParam();
@@ -860,11 +860,11 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * 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 _onSearchComplete(query, suggestions) {
         // clear cache when the query returns no records :
@@ -876,40 +876,40 @@ 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 _onSearchError(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 _onInvalidateSelection() {
         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 _onBeforeRender($container) {
         this.trigger('beforeRender', [$container, this]);
       },
 
-      /**
-       * Fired when the input element has the focus
-       * @param {Event} event
-       * @private
+      /**
+       * Fired when the input element has the focus
+       * @param {Event} event
+       * @private
        */
       _onFocus: function _onFocus(event) {
         if (this.hasTooManySuggestions()) {
@@ -917,19 +917,19 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         }
       },
 
-      /**
-       * Fired when the input element lose the focus
-       * @param {Event} event
-       * @private
+      /**
+       * Fired when the input element lose the focus
+       * @param {Event} event
+       * @private
        */
       _onBlur: function _onBlur(event) {
         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 _transformResult(response) {
         var self = this;
@@ -962,10 +962,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 adjustParam(param) {
         if (this.paramsRoot) {
@@ -975,10 +975,10 @@ define(['jquery', 'lodash', 'i18n', 'util/capitalize', 'ui/tooltip', 'jquery.aut
         return param;
       }
     };
-    /**
-     * Adjusts an event name
-     * @param {string} eventName
-     * @returns {string}
+    /**
+     * Adjusts an event name
+     * @param {string} eventName
+     * @returns {string}
      */
 
     var adjustEventName = function adjustEventName(eventName) {
@@ -994,10 +994,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}
      */
 
 
@@ -1010,11 +1010,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
      */