/* Tagator jQuery Plugin A plugin to make input elements, tag holders version 1.0, Jan 13th, 2014 by Ingi P. Jacobsen The MIT License (MIT) Copyright (c) 2014 Faroe Media Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ (function($) { $.tagator = function (element, options) { var defaults = { prefix: 'tagator_', height: 'auto', useDimmer: false, showAllOptionsOnFocus: false, autocomplete: [] }; var plugin = this; var selected_index = -1; var box_element = null; var tags_element = null; var input_element = null; var textlength_element = null; var options_element = null; var key = { backspace: 8, enter: 13, escape: 27, left: 37, up: 38, right: 39, down: 40, comma: 188 }; plugin.settings = {}; // INITIALIZE PLUGIN plugin.init = function () { plugin.settings = $.extend({}, defaults, options); //// ================== CREATE ELEMENTS ================== //// // dimmer if (plugin.settings.useDimmer) { if ($('#' + plugin.settings.prefix + 'dimmer').length === 0) { var dimmer_element = document.createElement('div'); $(dimmer_element).attr('id', plugin.settings.prefix + 'dimmer'); $(dimmer_element).hide(); $(document.body).prepend(dimmer_element); } } // box element box_element = document.createElement('div'); if (element.id !== undefined) { $(box_element).attr('id', plugin.settings.prefix + element.id); } $(box_element).addClass('tagator options-hidden'); $(box_element).css({ width: $(element).css('width'), padding: $(element).css('padding'), position: 'relative' }); if (plugin.settings.height === 'element') { $(box_element).css({ height: $(element).outerHeight() + 'px' }); } $(element).after(box_element); $(element).hide(); // textlength element textlength_element = document.createElement('span'); $(textlength_element).addClass(plugin.settings.prefix + 'textlength'); $(textlength_element).css({ position: 'absolute', visibility: 'hidden' }); $(box_element).append(textlength_element); // tags element tags_element = document.createElement('div'); $(tags_element).addClass(plugin.settings.prefix + 'tags'); $(box_element).append(tags_element); // input element input_element = document.createElement('input'); $(input_element).addClass(plugin.settings.prefix + 'input'); $(input_element).width(20); $(input_element).attr('autocomplete', 'false'); $(box_element).append(input_element); // options element options_element = document.createElement('ul'); $(options_element).addClass(plugin.settings.prefix + 'options'); $(box_element).append(options_element); //// ================== BIND ELEMENTS EVENTS ================== //// // source element $(element).change(function () { refreshTags(); }); // box element $(box_element).bind('focus', function (e) { e.preventDefault(); e.stopPropagation(); showOptions(); $(input_element).focus(); }); $(box_element).bind('mousedown', function (e) { e.preventDefault(); e.stopPropagation(); input_element.focus(); if (input_element.setSelectionRange) { input_element.focus(); input_element.setSelectionRange(input_element.value.length, input_element.value.length); } else if (input_element.createTextRange) { var range = input_element.createTextRange(); range.collapse(true); range.moveEnd('character', input_element.value.length); range.moveStart('character', input_element.value.length); range.select(); } }); $(box_element).bind('mouseup', function (e) { e.preventDefault(); e.stopPropagation(); }); $(box_element).bind('click', function (e) { e.preventDefault(); e.stopPropagation(); if (plugin.settings.showAllOptionsOnFocus) { //showOptions(); searchOptions(); } input_element.focus(); }); $(box_element).bind('dblclick', function (e) { e.preventDefault(); e.stopPropagation(); input_element.focus(); input_element.select(); }); // input element $(input_element).bind('click', function (e) { e.preventDefault(); e.stopPropagation(); }); $(input_element).bind('dblclick', function (e) { e.preventDefault(); e.stopPropagation(); }); $(input_element).bind('keydown', function (e) { e.stopPropagation(); var keyCode = e.keyCode || e.which; switch (keyCode) { case key.up: e.preventDefault(); if (selected_index > -1) { selected_index = selected_index - 1; } else { selected_index = $(options_element).find('.' + plugin.settings.prefix + 'option').length - 1; } refreshActiveOption(); scrollToActiveOption(); break; case key.down: e.preventDefault(); if (selected_index < $(options_element).find('.' + plugin.settings.prefix + 'option').length - 1) { selected_index = selected_index + 1; } else { selected_index = -1; } refreshActiveOption(); scrollToActiveOption(); break; case key.escape: e.preventDefault(); break; case key.comma: e.preventDefault(); if (selected_index === -1) { if ($(input_element).val() !== '') { addTag($(input_element).val()); } } resizeInput(); break; case key.enter: e.preventDefault(); if (selected_index !== -1) { selectOption(); } else { if ($(input_element).val() !== '') { addTag($(input_element).val()); } } resizeInput(); break; case key.backspace: if (input_element.value === '') { $(element).val($(element).val().substring(0, $(element).val().lastIndexOf(','))); $(element).trigger('change'); searchOptions(); } resizeInput(); break; default: resizeInput(); break; } }); $(input_element).bind('keyup', function (e) { e.preventDefault(); e.stopPropagation(); var keyCode = e.keyCode || e.which; if (keyCode === key.escape || keyCode === key.enter) { hideOptions(); } else if (keyCode < 37 || keyCode > 40) { searchOptions(); } if ($(box_element).hasClass('options-hidden') && (keyCode === key.left || keyCode === key.right || keyCode === key.up || keyCode === key.down)) { searchOptions(); } resizeInput(); }); $(input_element).bind('focus', function (e) { e.preventDefault(); e.stopPropagation(); if (!$(options_element).is(':empty') || plugin.settings.showAllOptionsOnFocus) { searchOptions(); showOptions(); } }); $(input_element).bind('blur', function (e) { e.preventDefault(); e.stopPropagation(); hideOptions(); }); refreshTags(); }; // RESIZE INPUT var resizeInput = function () { textlength_element.innerHTML = input_element.value; $(input_element).css({ width: ($(textlength_element).width() + 20) + 'px' }); }; // SET AUTOCOMPLETE LIST plugin.autocomplete = function (autocomplete) { plugin.settings.autocomplete = autocomplete !== undefined ? autocomplete : []; }; // REFRESH TAGS plugin.refresh = function () { refreshTags(); }; var refreshTags = function () { $(tags_element).empty(); var tags = $(element).val().split(','); $.each(tags, function (key, value) { if (value !== '') { var tag_element = document.createElement('div'); $(tag_element).addClass(plugin.settings.prefix + 'tag'); $(tag_element).html(value); // remove button var button_remove_element = document.createElement('div'); $(button_remove_element).data('text', value); $(button_remove_element).addClass(plugin.settings.prefix + 'tag_remove'); $(button_remove_element).bind('mousedown', function (e) { e.preventDefault(); e.stopPropagation(); }); $(button_remove_element).bind('mouseup', function (e) { e.preventDefault(); e.stopPropagation(); removeTag($(this).data('text')); $(element).trigger('change'); }); $(button_remove_element).html('X'); $(tag_element).append(button_remove_element); // clear var clear_element = document.createElement('div'); clear_element.style.clear = 'both'; $(tag_element).append(clear_element); $(tags_element).append(tag_element); } }); searchOptions(); }; // REMOVE TAG FROM ORIGINAL ELEMENT var removeTag = function (text) { var tagsBefore = $(element).val().split(','); var tagsAfter = []; $.each(tagsBefore, function (key, value) { if (value !== text && value !== '') { tagsAfter.push(value); } }); $(element).val(tagsAfter.join(',')); }; // CHECK IF TAG IS PRESENT var hasTag = function (text) { var tags = $(element).val().split(','); var hasTag = false; $.each(tags, function (key, value) { if ($.trim(value) === $.trim(text)) { hasTag = true; } }); return hasTag; }; // ADD TAG TO ORIGINAL ELEMENT var addTag = function (text) { if (!hasTag(text)) { $(element).val($(element).val() + ($(element).val() !== '' ? ',' : '') + text); $(element).trigger('change'); } $(input_element).val(''); box_element.focus(); hideOptions(); }; // OPTIONS SEARCH METHOD var searchOptions = function () { $(options_element).empty(); if (input_element.value.replace(/\s/g, '') !== '' || plugin.settings.showAllOptionsOnFocus) { var optionsArray = []; $.each(plugin.settings.autocomplete, function (key, value) { if (value.toLowerCase().indexOf(input_element.value.toLowerCase()) !== -1) { if (!hasTag(value)) { optionsArray.push(value); } } }); generateOptions(optionsArray); } if ($(input_element).is(':focus')) { if (!$(options_element).is(':empty')) { showOptions(); } else { hideOptions(); } } else { hideOptions(); } selected_index = -1; }; // GENERATE OPTIONS var generateOptions = function (optionsArray) { var index = -1; $(optionsArray).each(function (key, value) { index++; var option = createOption(value, index); $(options_element).append(option); }); refreshActiveOption(); }; // CREATE RESULT OPTION var createOption = function (text, index) { // holder li var option = document.createElement('li'); $(option).data('index', index); $(option).data('text', text); $(option).html(text); $(option).addClass(plugin.settings.prefix + 'option'); if (this.selected) { $(option).addClass('active'); } // BIND EVENTS $(option).bind('mouseover', function (e) { e.stopPropagation(); e.preventDefault(); selected_index = index; refreshActiveOption(); }); $(option).bind('mousedown', function (e) { e.stopPropagation(); e.preventDefault(); }); $(option).bind('click', function (e) { e.preventDefault(); e.stopPropagation(); selectOption(); }); return option; }; // SHOW OPTIONS AND DIMMER var showOptions = function () { $(box_element).removeClass('options-hidden').addClass('options-visible'); if (plugin.settings.useDimmer) { $('#' + plugin.settings.prefix + 'dimmer').show(); } $(options_element).css('top', ($(box_element).outerHeight()-2) + 'px'); if ($(box_element).hasClass('single')) { selected_index = $(options_element).find('.' + plugin.settings.prefix + 'option').index($(options_element).find('.' + plugin.settings.prefix + 'option.active')); } scrollToActiveOption(); }; // HIDE OPTIONS AND DIMMER var hideOptions = function () { $(box_element).removeClass('options-visible').addClass('options-hidden'); if (plugin.settings.useDimmer) { $('#' + plugin.settings.prefix + 'dimmer').hide(); } }; // REFRESH ACTIVE IN OPTIONS METHOD var refreshActiveOption = function () { $(options_element).find('.active').removeClass('active'); if (selected_index !== -1) { $(options_element).find('.' + plugin.settings.prefix + 'option').eq(selected_index).addClass('active'); } }; // SCROLL TO ACTIVE OPTION IN OPTIONS LIST var scrollToActiveOption = function () { var $active_element = $(options_element).find('.' + plugin.settings.prefix + 'option.active'); if ($active_element.length > 0) { $(options_element).scrollTop($(options_element).scrollTop() + $active_element.position().top - $(options_element).height()/2 + $active_element.height()/2); } }; // SELECT ACTIVE OPTION var selectOption = function () { addTag($(options_element).find('.' + plugin.settings.prefix + 'option').eq(selected_index).data('text')); }; // REMOVE PLUGIN AND REVERT INPUT ELEMENT TO ORIGINAL STATE plugin.destroy = function () { $(box_element).remove(); $.removeData(element, 'tagator'); $(element).show(); if ($('.tagator').length === 0) { $('#' + plugin.settings.prefix + 'dimmer').remove(); } }; // Initialize plugin plugin.init(); }; $.fn.tagator = function() { var parameters = arguments[0] !== undefined ? arguments : [{}]; return this.each(function () { if (typeof(parameters[0]) === 'object') { if (undefined === $(this).data('tagator')) { var plugin = new $.tagator(this, parameters[0]); $(this).data('tagator', plugin); } } else if ($(this).data('tagator')[parameters[0]]) { $(this).data('tagator')[parameters[0]].apply(this, Array.prototype.slice.call(parameters, 1)); } else { $.error('Method ' + parameters[0] + ' does not exist in $.tagator'); } }); }; }(jQuery));