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

package/src/autocomplete.js

@@ -1,1027 +1,1027 @@
-/**
- * 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 ;
- */
-/**
- * Wraps a jQuery autocomplete plugin inside a component.
- * Source code of the wrapped plugin: https://github.com/devbridge/jQuery-Autocomplete
- * @author Jean-Sébastien Conan <jean-sebastien.conan@vesperiagroup.com>
- */
-import $ from 'jquery';
-import _ from 'lodash';
-import __ from 'i18n';
-import capitalize from 'util/capitalize';
-import tooltip from 'ui/tooltip';
-import 'jquery.autocomplete';
-import 'ui/autocomplete/css/autocomplete.css';
-
-/**
- * Namespace for component
- * @type {String}
- */
-var NS = 'autocompleter';
-
-/**
- * Default config for tooltip displayed when the server returns less records than available
- * @type {Object}
- */
-var tooltipConfigTooMany = {
-    container: $('body').get(0),
-    trigger: 'manual'
-};
-var toolTipMessage = __('Too many suggestions match your query. Only a few are listed');
-
-/**
- * A list of default values for allowed options
- * @type {Object}
- */
-var defaults = {
-    /**
-     * The name of the wrapped plugin
-     * @type {String}
-     */
-    pluginName: 'autocomplete',
-
-    /**
-     * Defines the URL to data source
-     * @type {String}
-     */
-    url: null,
-
-    /**
-     * 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}
-     */
-    paramsRoot: null,
-
-    /**
-     * 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}
-     */
-    queryParam: 'query',
-
-    /**
-     * 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}
-     */
-    ontology: null,
-
-    /**
-     * The current value
-     * @type {String}
-     */
-    value: null,
-
-    /**
-     * The current label
-     * @type {String}
-     */
-    label: null,
-
-    /**
-     * 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}
-     */
-    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}
-     */
-    isProvider: false,
-
-    /**
-     * 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}
-     */
-    delay: 250,
-
-    /**
-     * 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}
-     */
-    tooManySuggestions: false,
-
-    /**
-     * 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
-     */
-    init: function (element, options) {
-        // fetch the element to handle, we need an input element
-        this.$element = $(element);
-        if (!this.$element.is(':input')) {
-            this.$element = this.$element.find(':input');
-        }
-
-        // prepare the tooltip displayed when more suggestions are available on the server side for the current query
-        this.tooltip = tooltip.info(this.$element, toolTipMessage, tooltipConfigTooMany);
-
-        // loads some options from HTML5 data-* attributes
-        options = _.assign(
-            _.clone(options || {}),
-            _.pick(this.$element.data(), [
-                'url',
-                'ontology',
-                'paramsRoot',
-                'ontologyParam',
-                'queryParam',
-                'type',
-                'valueField',
-                'labelField',
-                'isProvider',
-                'preventSubmit',
-                'delay',
-                'minChars'
-            ])
-        );
-
-        // install the keyboard listener used to prevent auto submits
-        this.on('keyup keydown keypress', this._onKeyEvent.bind(this));
-
-        // install the events listener used to show/hide tooltip
-        this.on('focus', this._onFocus.bind(this));
-        this.on('blur', this._onBlur.bind(this));
-
-        // apply the nested plugin onto the element
-        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
-     */
-    destroy: function () {
-        this.applyPlugin('dispose');
-        if (this.$element) {
-            this.$element.off('.' + NS);
-            this.tooltip.dispose();
-        }
-        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.
-     */
-    parseOptions: function (options) {
-        var self = this;
-        var pluginOptions = {};
-
-        // filter the options
-        _.forOwn(options, function (value, name) {
-            var setterName = 'set' + capitalize(name);
-            if (self[setterName]) {
-                // a setter exists for this option
-                self[setterName](value);
-            } else if (name.substr(0, 2) === 'on') {
-                // this option is an event handler
-                self.on(name.substr(2), value);
-            } else {
-                // not a component option, forward it to the plugin instance
-                pluginOptions[name] = value;
-            }
-        });
-
-        // adjust options to be forwarded to the plugin instance
-        _.assign(pluginOptions, {
-            onSelect: this._onSelect.bind(this),
-            onSearchStart: this._onSearchStart.bind(this),
-            onSearchComplete: this._onSearchComplete.bind(this),
-            onSearchError: this._onSearchError.bind(this),
-            onInvalidateSelection: this._onInvalidateSelection.bind(this),
-            beforeRender: this._onBeforeRender.bind(this),
-            transformResult: this._transformResult.bind(this),
-            deferRequestBy: this.delay || 0,
-            preventBadQueries: false,
-            triggerSelectOnValidInput: false,
-            autoSelectFirst: true,
-            minChars: this.minChars || 1,
-            serviceUrl: this.url,
-            type: this.getType(),
-            params: this.getParams(),
-            paramName: this.getQueryParam(),
-            ajaxSettings: {
-                dataType: 'json'
-            }
-        });
-
-        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
-     */
-    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
-     */
-    applyElement: function (action, params) {
-        var $element = this.$element;
-
-        if ($element) {
-            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
-     */
-    applyPlugin: function (action, params) {
-        var $element = this.$element;
-        var $plugin = $element && $element[this.pluginName]();
-
-        if ($plugin) {
-            return $plugin[action].apply($plugin, params);
-        }
-    },
-
-    /**
-     * 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
-     */
-    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
-     */
-    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
-     */
-    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
-     */
-    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}
-     */
-    getElement: function () {
-        return this.$element;
-    },
-
-    /**
-     * 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}
-     */
-    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
-     */
-    setValue: function (value, label) {
-        this.value = value;
-        if (!_.isUndefined(label)) {
-            this.setLabel(label);
-        }
-        return this;
-    },
-
-    /**
-     * 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
-     */
-    setLabel: function (label) {
-        this.label = label;
-        if (this.$element) {
-            this.$element.val(label);
-        }
-        return this;
-    },
-
-    /**
-     * 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
-     */
-    setOntology: function (ontology) {
-        this.ontology = ontology;
-        return this;
-    },
-
-    /**
-     * 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
-     */
-    setValueField: function (valueField) {
-        this.valueField = valueField;
-        return this;
-    },
-
-    /**
-     * 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
-     */
-    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}
-     */
-    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
-     */
-    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}
-     */
-    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
-     */
-    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}
-     */
-    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
-     */
-    setParamsRoot: function (paramsRoot) {
-        this.paramsRoot = paramsRoot;
-        return this;
-    },
-
-    /**
-     * Gets the list of extra params to be sent with the query.
-     * @returns {Object}
-     */
-    getParams: function () {
-        var params = _.merge({}, this.params || {});
-        var searchParams = params;
-
-        if (this.paramsRoot) {
-            searchParams = params[this.paramsRoot] || {};
-            params[this.paramsRoot] = searchParams;
-        }
-
-        if (this.ontology) {
-            if (!Array.isArray(this.ontologyParam)) {
-                searchParams[this.ontologyParam] = this.ontology;
-            } else {
-                this.ontologyParam.forEach(p => {
-                    searchParams[p] = this.ontology;
-                });
-            }
-        }
-
-        return params;
-    },
-
-    /**
-     * 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}
-     */
-    getQueryParam: function () {
-        return this.adjustParam(this.queryParam);
-    },
-
-    /**
-     * 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}
-     */
-    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
-     */
-    setOntologyParam: function (ontologyParam) {
-        this.ontologyParam = ontologyParam;
-        return this;
-    },
-
-    /**
-     * 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
-     */
-    setUrl: function (url) {
-        this.url = url;
-        return this;
-    },
-
-    /**
-     * 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
-     */
-    setType: function (type) {
-        this.type = type;
-        return this;
-    },
-
-    /**
-     * 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}
-     */
-    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}
-     */
-    getMinChars: function () {
-        return this.minChars;
-    },
-
-    /**
-     * 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
-     */
-    enable: function () {
-        this.applyPlugin('enable');
-        return this;
-    },
-
-    /**
-     * Deactivates the component.
-     * @returns {autocompleter} this
-     */
-    disable: function () {
-        this.applyPlugin('disable');
-        return this;
-    },
-
-    /**
-     * Hides suggestions.
-     * @returns {autocompleter} this
-     */
-    hide: function () {
-        this.applyPlugin('hide');
-        return 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
-     */
-    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
-     */
-    reset: function () {
-        this.setValue(null, '');
-        this.clear();
-        this.applyPlugin('hide');
-        return this;
-    },
-
-    /**
-     * Fired on each keyboard actions
-     * @param {Event} event
-     * @private
-     */
-    _onKeyEvent: function (event) {
-        // prevent auto submit when the option preventSubmit is enabled
-        if (this.preventSubmit && 13 === event.which) {
-            event.preventDefault();
-        }
-    },
-
-    /**
-     * Fired when the user select a suggestion in the list.
-     * @param {Object} suggestion
-     * @private
-     */
-    _onSelect: function (suggestion) {
-        var value = suggestion && suggestion.data;
-        var label = suggestion && suggestion.value;
-
-        if (false !== this.trigger('beforeSelectItem', [value, label, this])) {
-            this.value = value;
-            this.label = label;
-
-            if (this.isProvider) {
-                this.$element.val('');
-                this.clear();
-            }
-
-            this.trigger('selectItem', [value, label, this]);
-        } else {
-            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
-     */
-    _onSearchStart: function (params) {
-        var queryParam = this.getQueryParam();
-        var query;
-
-        if (false !== this.trigger('searchStart', [params, this])) {
-            if (this.addWilcard && params && params[queryParam]) {
-                query = params[queryParam] || '';
-                if (query.substr(-1) !== '*') {
-                    query += '*';
-                }
-                params[queryParam] = query;
-            }
-        } else {
-            return false;
-        }
-    },
-
-    /**
-     * 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 :
-        // this avoids to have to reload the page when the server has a temporary failure
-        if (!suggestions || !suggestions.length) {
-            this.clear();
-        }
-
-        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
-     */
-    _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
-     */
-    _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
-     */
-    _onBeforeRender: function ($container) {
-        this.trigger('beforeRender', [$container, this]);
-    },
-
-    /**
-     * 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
-     */
-    _onBlur: function () {
-        this.hideTooltipTooMany();
-    },
-
-    /**
-     * Adjusts the received data to comply to plugin needs
-     * @param response
-     * @returns {{suggestions: Array}}
-     */
-    _transformResult: function (response) {
-        var self = this;
-        var results = {
-            suggestions: []
-        };
-
-        if (_.isString(response)) {
-            response = JSON.parse(response);
-        }
-        if (response.records) {
-            results.suggestions = _.map(response.data, function (dataItem) {
-                return {
-                    value: dataItem[self.labelField],
-                    data: dataItem[self.valueField]
-                };
-            });
-        }
-
-        // detect when the server has limited the amount of suggestions
-        this.tooManySuggestions = response.total && response.total > 1;
-        if (this.hasTooManySuggestions()) {
-            this.showTooltipTooMany();
-        } else {
-            this.hideTooltipTooMany();
-        }
-
-        return results;
-    },
-
-    /**
-     * 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) {
-            param = this.paramsRoot + '[' + param + ']';
-        }
-        return param;
-    }
-};
-
-/**
- * Adjusts an event name
- * @param {string} eventName
- * @returns {string}
- */
-function adjustEventName(eventName) {
-    var names = _(eventName.split(' ')).map(function (name) {
-        name = name.toLowerCase();
-        if (-1 === name.indexOf('.')) {
-            name += '.' + NS;
-        }
-        return name;
-    });
-    return names.join(' ');
-}
-
-/**
- * Converts a value to boolean
- * @param value
- * @returns {Boolean}
- */
-function toBoolean(value) {
-    if (_.isString(value)) {
-        if ('false' === value.toLowerCase() || '0' === value) {
-            value = false;
-        }
-    }
-    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
- */
-function autocompleteFactory(element, options) {
-    var autocomplete = _.clone(autocompleter, true);
-    _.defaults(autocomplete, defaults);
-    return autocomplete.init(element, options);
-}
-
-export default autocompleteFactory;
+/**
+ * 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 ;
+ */
+/**
+ * Wraps a jQuery autocomplete plugin inside a component.
+ * Source code of the wrapped plugin: https://github.com/devbridge/jQuery-Autocomplete
+ * @author Jean-Sébastien Conan <jean-sebastien.conan@vesperiagroup.com>
+ */
+import $ from 'jquery';
+import _ from 'lodash';
+import __ from 'i18n';
+import capitalize from 'util/capitalize';
+import tooltip from 'ui/tooltip';
+import 'jquery.autocomplete';
+import 'ui/autocomplete/css/autocomplete.css';
+
+/**
+ * Namespace for component
+ * @type {String}
+ */
+var NS = 'autocompleter';
+
+/**
+ * Default config for tooltip displayed when the server returns less records than available
+ * @type {Object}
+ */
+var tooltipConfigTooMany = {
+    container: $('body').get(0),
+    trigger: 'manual'
+};
+var toolTipMessage = __('Too many suggestions match your query. Only a few are listed');
+
+/**
+ * A list of default values for allowed options
+ * @type {Object}
+ */
+var defaults = {
+    /**
+     * The name of the wrapped plugin
+     * @type {String}
+     */
+    pluginName: 'autocomplete',
+
+    /**
+     * Defines the URL to data source
+     * @type {String}
+     */
+    url: null,
+
+    /**
+     * 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}
+     */
+    paramsRoot: null,
+
+    /**
+     * 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}
+     */
+    queryParam: 'query',
+
+    /**
+     * 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}
+     */
+    ontology: null,
+
+    /**
+     * The current value
+     * @type {String}
+     */
+    value: null,
+
+    /**
+     * The current label
+     * @type {String}
+     */
+    label: null,
+
+    /**
+     * 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}
+     */
+    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}
+     */
+    isProvider: false,
+
+    /**
+     * 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}
+     */
+    delay: 250,
+
+    /**
+     * 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}
+     */
+    tooManySuggestions: false,
+
+    /**
+     * 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
+     */
+    init: function (element, options) {
+        // fetch the element to handle, we need an input element
+        this.$element = $(element);
+        if (!this.$element.is(':input')) {
+            this.$element = this.$element.find(':input');
+        }
+
+        // prepare the tooltip displayed when more suggestions are available on the server side for the current query
+        this.tooltip = tooltip.info(this.$element, toolTipMessage, tooltipConfigTooMany);
+
+        // loads some options from HTML5 data-* attributes
+        options = _.assign(
+            _.clone(options || {}),
+            _.pick(this.$element.data(), [
+                'url',
+                'ontology',
+                'paramsRoot',
+                'ontologyParam',
+                'queryParam',
+                'type',
+                'valueField',
+                'labelField',
+                'isProvider',
+                'preventSubmit',
+                'delay',
+                'minChars'
+            ])
+        );
+
+        // install the keyboard listener used to prevent auto submits
+        this.on('keyup keydown keypress', this._onKeyEvent.bind(this));
+
+        // install the events listener used to show/hide tooltip
+        this.on('focus', this._onFocus.bind(this));
+        this.on('blur', this._onBlur.bind(this));
+
+        // apply the nested plugin onto the element
+        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
+     */
+    destroy: function () {
+        this.applyPlugin('dispose');
+        if (this.$element) {
+            this.$element.off('.' + NS);
+            this.tooltip.dispose();
+        }
+        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.
+     */
+    parseOptions: function (options) {
+        var self = this;
+        var pluginOptions = {};
+
+        // filter the options
+        _.forOwn(options, function (value, name) {
+            var setterName = 'set' + capitalize(name);
+            if (self[setterName]) {
+                // a setter exists for this option
+                self[setterName](value);
+            } else if (name.substr(0, 2) === 'on') {
+                // this option is an event handler
+                self.on(name.substr(2), value);
+            } else {
+                // not a component option, forward it to the plugin instance
+                pluginOptions[name] = value;
+            }
+        });
+
+        // adjust options to be forwarded to the plugin instance
+        _.assign(pluginOptions, {
+            onSelect: this._onSelect.bind(this),
+            onSearchStart: this._onSearchStart.bind(this),
+            onSearchComplete: this._onSearchComplete.bind(this),
+            onSearchError: this._onSearchError.bind(this),
+            onInvalidateSelection: this._onInvalidateSelection.bind(this),
+            beforeRender: this._onBeforeRender.bind(this),
+            transformResult: this._transformResult.bind(this),
+            deferRequestBy: this.delay || 0,
+            preventBadQueries: false,
+            triggerSelectOnValidInput: false,
+            autoSelectFirst: true,
+            minChars: this.minChars || 1,
+            serviceUrl: this.url,
+            type: this.getType(),
+            params: this.getParams(),
+            paramName: this.getQueryParam(),
+            ajaxSettings: {
+                dataType: 'json'
+            }
+        });
+
+        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
+     */
+    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
+     */
+    applyElement: function (action, params) {
+        var $element = this.$element;
+
+        if ($element) {
+            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
+     */
+    applyPlugin: function (action, params) {
+        var $element = this.$element;
+        var $plugin = $element && $element[this.pluginName]();
+
+        if ($plugin) {
+            return $plugin[action].apply($plugin, params);
+        }
+    },
+
+    /**
+     * 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
+     */
+    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
+     */
+    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
+     */
+    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
+     */
+    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}
+     */
+    getElement: function () {
+        return this.$element;
+    },
+
+    /**
+     * 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}
+     */
+    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
+     */
+    setValue: function (value, label) {
+        this.value = value;
+        if (!_.isUndefined(label)) {
+            this.setLabel(label);
+        }
+        return this;
+    },
+
+    /**
+     * 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
+     */
+    setLabel: function (label) {
+        this.label = label;
+        if (this.$element) {
+            this.$element.val(label);
+        }
+        return this;
+    },
+
+    /**
+     * 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
+     */
+    setOntology: function (ontology) {
+        this.ontology = ontology;
+        return this;
+    },
+
+    /**
+     * 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
+     */
+    setValueField: function (valueField) {
+        this.valueField = valueField;
+        return this;
+    },
+
+    /**
+     * 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
+     */
+    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}
+     */
+    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
+     */
+    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}
+     */
+    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
+     */
+    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}
+     */
+    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
+     */
+    setParamsRoot: function (paramsRoot) {
+        this.paramsRoot = paramsRoot;
+        return this;
+    },
+
+    /**
+     * Gets the list of extra params to be sent with the query.
+     * @returns {Object}
+     */
+    getParams: function () {
+        var params = _.merge({}, this.params || {});
+        var searchParams = params;
+
+        if (this.paramsRoot) {
+            searchParams = params[this.paramsRoot] || {};
+            params[this.paramsRoot] = searchParams;
+        }
+
+        if (this.ontology) {
+            if (!Array.isArray(this.ontologyParam)) {
+                searchParams[this.ontologyParam] = this.ontology;
+            } else {
+                this.ontologyParam.forEach(p => {
+                    searchParams[p] = this.ontology;
+                });
+            }
+        }
+
+        return params;
+    },
+
+    /**
+     * 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}
+     */
+    getQueryParam: function () {
+        return this.adjustParam(this.queryParam);
+    },
+
+    /**
+     * 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}
+     */
+    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
+     */
+    setOntologyParam: function (ontologyParam) {
+        this.ontologyParam = ontologyParam;
+        return this;
+    },
+
+    /**
+     * 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
+     */
+    setUrl: function (url) {
+        this.url = url;
+        return this;
+    },
+
+    /**
+     * 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
+     */
+    setType: function (type) {
+        this.type = type;
+        return this;
+    },
+
+    /**
+     * 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}
+     */
+    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}
+     */
+    getMinChars: function () {
+        return this.minChars;
+    },
+
+    /**
+     * 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
+     */
+    enable: function () {
+        this.applyPlugin('enable');
+        return this;
+    },
+
+    /**
+     * Deactivates the component.
+     * @returns {autocompleter} this
+     */
+    disable: function () {
+        this.applyPlugin('disable');
+        return this;
+    },
+
+    /**
+     * Hides suggestions.
+     * @returns {autocompleter} this
+     */
+    hide: function () {
+        this.applyPlugin('hide');
+        return 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
+     */
+    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
+     */
+    reset: function () {
+        this.setValue(null, '');
+        this.clear();
+        this.applyPlugin('hide');
+        return this;
+    },
+
+    /**
+     * Fired on each keyboard actions
+     * @param {Event} event
+     * @private
+     */
+    _onKeyEvent: function (event) {
+        // prevent auto submit when the option preventSubmit is enabled
+        if (this.preventSubmit && 13 === event.which) {
+            event.preventDefault();
+        }
+    },
+
+    /**
+     * Fired when the user select a suggestion in the list.
+     * @param {Object} suggestion
+     * @private
+     */
+    _onSelect: function (suggestion) {
+        var value = suggestion && suggestion.data;
+        var label = suggestion && suggestion.value;
+
+        if (false !== this.trigger('beforeSelectItem', [value, label, this])) {
+            this.value = value;
+            this.label = label;
+
+            if (this.isProvider) {
+                this.$element.val('');
+                this.clear();
+            }
+
+            this.trigger('selectItem', [value, label, this]);
+        } else {
+            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
+     */
+    _onSearchStart: function (params) {
+        var queryParam = this.getQueryParam();
+        var query;
+
+        if (false !== this.trigger('searchStart', [params, this])) {
+            if (this.addWilcard && params && params[queryParam]) {
+                query = params[queryParam] || '';
+                if (query.substr(-1) !== '*') {
+                    query += '*';
+                }
+                params[queryParam] = query;
+            }
+        } else {
+            return false;
+        }
+    },
+
+    /**
+     * 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 :
+        // this avoids to have to reload the page when the server has a temporary failure
+        if (!suggestions || !suggestions.length) {
+            this.clear();
+        }
+
+        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
+     */
+    _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
+     */
+    _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
+     */
+    _onBeforeRender: function ($container) {
+        this.trigger('beforeRender', [$container, this]);
+    },
+
+    /**
+     * 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
+     */
+    _onBlur: function () {
+        this.hideTooltipTooMany();
+    },
+
+    /**
+     * Adjusts the received data to comply to plugin needs
+     * @param response
+     * @returns {{suggestions: Array}}
+     */
+    _transformResult: function (response) {
+        var self = this;
+        var results = {
+            suggestions: []
+        };
+
+        if (_.isString(response)) {
+            response = JSON.parse(response);
+        }
+        if (response.records) {
+            results.suggestions = _.map(response.data, function (dataItem) {
+                return {
+                    value: dataItem[self.labelField],
+                    data: dataItem[self.valueField]
+                };
+            });
+        }
+
+        // detect when the server has limited the amount of suggestions
+        this.tooManySuggestions = response.total && response.total > 1;
+        if (this.hasTooManySuggestions()) {
+            this.showTooltipTooMany();
+        } else {
+            this.hideTooltipTooMany();
+        }
+
+        return results;
+    },
+
+    /**
+     * 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) {
+            param = this.paramsRoot + '[' + param + ']';
+        }
+        return param;
+    }
+};
+
+/**
+ * Adjusts an event name
+ * @param {string} eventName
+ * @returns {string}
+ */
+function adjustEventName(eventName) {
+    var names = _(eventName.split(' ')).map(function (name) {
+        name = name.toLowerCase();
+        if (-1 === name.indexOf('.')) {
+            name += '.' + NS;
+        }
+        return name;
+    });
+    return names.join(' ');
+}
+
+/**
+ * Converts a value to boolean
+ * @param value
+ * @returns {Boolean}
+ */
+function toBoolean(value) {
+    if (_.isString(value)) {
+        if ('false' === value.toLowerCase() || '0' === value) {
+            value = false;
+        }
+    }
+    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
+ */
+function autocompleteFactory(element, options) {
+    var autocomplete = _.clone(autocompleter, true);
+    _.defaults(autocomplete, defaults);
+    return autocomplete.init(element, options);
+}
+
+export default autocompleteFactory;