|
|
- /*!
- * # Semantic UI 2.0.0 - Dropdown
- * http://github.com/semantic-org/semantic-ui/
- *
- *
- * Copyright 2015 Contributors
- * Released under the MIT license
- * http://opensource.org/licenses/MIT
- *
- */
-
- ;(function ( $, window, document, undefined ) {
-
- "use strict";
-
- $.fn.dropdown = function(parameters) {
- var
- $allModules = $(this),
- $document = $(document),
-
- moduleSelector = $allModules.selector || '',
-
- hasTouch = ('ontouchstart' in document.documentElement),
- time = new Date().getTime(),
- performance = [],
-
- query = arguments[0],
- methodInvoked = (typeof query == 'string'),
- queryArguments = [].slice.call(arguments, 1),
- returnedValue
- ;
-
- $allModules
- .each(function(elementIndex) {
- var
- settings = ( $.isPlainObject(parameters) )
- ? $.extend(true, {}, $.fn.dropdown.settings, parameters)
- : $.extend({}, $.fn.dropdown.settings),
-
- className = settings.className,
- message = settings.message,
- metadata = settings.metadata,
- namespace = settings.namespace,
- regExp = settings.regExp,
- selector = settings.selector,
- error = settings.error,
- templates = settings.templates,
-
- eventNamespace = '.' + namespace,
- moduleNamespace = 'module-' + namespace,
-
- $module = $(this),
- $context = $(settings.context),
- $text = $module.find(selector.text),
- $search = $module.find(selector.search),
- $input = $module.find(selector.input),
- $icon = $module.find(selector.icon),
-
- $combo = ($module.prev().find(selector.text).length > 0)
- ? $module.prev().find(selector.text)
- : $module.prev(),
-
- $menu = $module.children(selector.menu),
- $item = $menu.find(selector.item),
-
- activated = false,
- itemActivated = false,
- element = this,
- instance = $module.data(moduleNamespace),
-
- initialLoad,
- pageLostFocus,
- elementNamespace,
- id,
- selectObserver,
- menuObserver,
- module
- ;
-
- module = {
-
- initialize: function() {
- module.debug('Initializing dropdown', settings);
-
- if( module.is.alreadySetup() ) {
- module.setup.reference();
- }
- else {
- module.setup.layout();
- module.refreshData();
-
- module.save.defaults();
- module.restore.selected();
-
- module.create.id();
- if(hasTouch) {
- module.bind.touchEvents();
- }
- module.bind.mouseEvents();
- module.bind.keyboardEvents();
-
- module.observeChanges();
- module.instantiate();
- }
-
- },
-
- instantiate: function() {
- module.verbose('Storing instance of dropdown', module);
- instance = module;
- $module
- .data(moduleNamespace, module)
- ;
- },
-
- destroy: function() {
- module.verbose('Destroying previous dropdown', $module);
- module.remove.tabbable();
- $module
- .off(eventNamespace)
- .removeData(moduleNamespace)
- ;
- $menu
- .off(eventNamespace)
- ;
- $document
- .off(elementNamespace)
- ;
- if(selectObserver) {
- selectObserver.disconnect();
- }
- if(menuObserver) {
- menuObserver.disconnect();
- }
- },
-
- observeChanges: function() {
- if('MutationObserver' in window) {
- selectObserver = new MutationObserver(function(mutations) {
- module.debug('<select> modified, recreating menu');
- module.setup.select();
- });
- menuObserver = new MutationObserver(function(mutations) {
- module.debug('Menu modified, updating selector cache');
- module.refresh();
- });
- if(module.has.input()) {
- selectObserver.observe($input[0], {
- childList : true,
- subtree : true
- });
- }
- if(module.has.menu()) {
- menuObserver.observe($menu[0], {
- childList : true,
- subtree : true
- });
- }
- module.debug('Setting up mutation observer', selectObserver, menuObserver);
- }
- },
-
- create: {
- id: function() {
- id = (Math.random().toString(16) + '000000000').substr(2, 8);
- elementNamespace = '.' + id;
- module.verbose('Creating unique id for element', id);
- },
- userChoice: function(values) {
- var
- $userChoices,
- $userChoice,
- isUserValue,
- html
- ;
- values = values || module.get.userValues();
- if(!values) {
- return false;
- }
- values = $.isArray(values)
- ? values
- : [values]
- ;
- $.each(values, function(index, value) {
- if(module.get.item(value) === false) {
- html = settings.templates.addition(value);
- $userChoice = $('<div />')
- .html(html)
- .data(metadata.value, value)
- .addClass(className.addition)
- .addClass(className.item)
- ;
- $userChoices = ($userChoices === undefined)
- ? $userChoice
- : $userChoices.add($userChoice)
- ;
- module.verbose('Creating user choices for value', value, $userChoice);
- }
- });
- return $userChoices;
- },
- userLabels: function(value) {
- var
- userValues = module.get.userValues()
- ;
- if(userValues) {
- module.debug('Adding user labels', userValues);
- $.each(userValues, function(index, value) {
- module.verbose('Adding custom user value');
- module.add.label(value, value);
- });
- }
- },
- },
-
- search: function(query) {
- query = (query !== undefined)
- ? query
- : module.get.query()
- ;
- module.verbose('Searching for query', query);
- module.filter(query);
- },
-
- select: {
- firstUnfiltered: function() {
- module.verbose('Selecting first non-filtered element');
- module.remove.selectedItem();
- $item
- .not(selector.unselectable)
- .eq(0)
- .addClass(className.selected)
- ;
- },
- nextAvailable: function($selected) {
- $selected = $selected.eq(0);
- var
- $nextAvailable = $selected.nextAll(selector.item).not(selector.unselectable).eq(0),
- $prevAvailable = $selected.prevAll(selector.item).not(selector.unselectable).eq(0),
- hasNext = ($nextAvailable.length > 0)
- ;
- if(hasNext) {
- module.verbose('Moving selection to', $nextAvailable);
- $nextAvailable.addClass(className.selected);
- }
- else {
- module.verbose('Moving selection to', $prevAvailable);
- $prevAvailable.addClass(className.selected);
- }
- }
- },
-
- setup: {
- api: function() {
- var
- apiSettings = {
- debug : settings.debug,
- on : false
- }
- ;
- module.verbose('First request, initializing API');
- $module
- .api(apiSettings)
- ;
- },
- layout: function() {
- if( $module.is('select') ) {
- module.setup.select();
- module.setup.returnedObject();
- console.log($module);
- }
- if( module.is.search() && !module.has.search() ) {
- module.verbose('Adding search input');
- $search = $('<input />')
- .addClass(className.search)
- .insertBefore($text)
- ;
- }
- if(settings.allowTab) {
- module.set.tabbable();
- }
- if($menu.length === 0) {
- $menu = $('<div />')
- .addClass(className.menu)
- .appendTo($module)
- ;
- }
- },
- select: function() {
- var
- selectValues = module.get.selectValues()
- ;
- module.debug('Dropdown initialized on a select', selectValues);
- if( $module.is('select') ) {
- $input = $module;
- }
- // see if select is placed correctly already
- if($input.parent(selector.dropdown).length > 0) {
- module.debug('UI dropdown already exists. Creating dropdown menu only');
- $module = $input.closest(selector.dropdown);
- $menu = $module.children(selector.menu);
- module.setup.menu(selectValues);
- }
- else {
- module.debug('Creating entire dropdown from select');
- $module = $('<div />')
- .attr('class', $input.attr('class') )
- .addClass(className.selection)
- .addClass(className.dropdown)
- .html( templates.dropdown(selectValues) )
- .insertBefore($input)
- ;
- $input
- .removeAttr('class')
- .detach()
- .prependTo($module)
- ;
- console.log($module);
- }
- if($input.is('[multiple]')) {
- module.set.multiple();
- }
- module.refresh();
- },
- menu: function(values) {
- $menu.html( templates.menu( values ));
- $item = $menu.find(selector.item);
- },
- reference: function() {
- module.debug('Dropdown behavior was called on select, replacing with closest dropdown');
- // replace module reference
- $module = $module.parent(selector.dropdown);
- module.refresh();
- module.setup.returnedObject();
- // invoke method in context of current instance
- if(methodInvoked) {
- instance = module;
- module.invoke(query);
- }
- },
- returnedObject: function() {
- var
- $firstModules = $allModules.slice(0, elementIndex),
- $lastModules = $allModules.slice(elementIndex + 1)
- ;
- // adjust all modules to use correct reference
- $allModules = $firstModules.add($module).add($lastModules);
- }
- },
-
- refresh: function() {
- module.refreshSelectors();
- module.refreshData();
- },
-
- refreshSelectors: function() {
- module.verbose('Refreshing selector cache');
- $text = $module.find(selector.text);
- $search = $module.find(selector.search);
- $input = $module.find(selector.input);
- $icon = $module.find(selector.icon);
- $combo = ($module.prev().find(selector.text).length > 0)
- ? $module.prev().find(selector.text)
- : $module.prev()
- ;
- $menu = $module.children(selector.menu);
- $item = $menu.find(selector.item);
- },
-
- refreshData: function() {
- module.verbose('Refreshing cached metadata');
- $item
- .removeData(metadata.text)
- .removeData(metadata.value)
- ;
- $module
- .removeData(metadata.defaultText)
- .removeData(metadata.defaultValue)
- .removeData(metadata.placeholderText)
- ;
- },
-
-
- toggle: function() {
- module.verbose('Toggling menu visibility');
- if( !module.is.active() ) {
- module.show();
- }
- else {
- module.hide();
- }
- },
-
- show: function(callback) {
- callback = $.isFunction(callback)
- ? callback
- : function(){}
- ;
- if( module.can.show() && !module.is.active() ) {
- module.debug('Showing dropdown');
- if(module.is.multiple()) {
- if(!module.has.search() && module.is.allFiltered()) {
- return true;
- }
- }
- module.animate.show(function() {
- if( module.can.click() ) {
- module.bind.intent();
- }
- module.set.visible();
- callback.call(element);
- });
- settings.onShow.call(element);
- }
- },
-
- hide: function(callback) {
- callback = $.isFunction(callback)
- ? callback
- : function(){}
- ;
- if( module.is.active() ) {
- module.debug('Hiding dropdown');
- module.animate.hide(function() {
- module.remove.visible();
- callback.call(element);
- });
- settings.onHide.call(element);
- }
- },
-
- hideOthers: function() {
- module.verbose('Finding other dropdowns to hide');
- $allModules
- .not($module)
- .has(selector.menu + '.' + className.visible)
- .dropdown('hide')
- ;
- },
-
- hideMenu: function() {
- module.verbose('Hiding menu instantaneously');
- module.remove.active();
- module.remove.visible();
- $menu.transition('hide');
- },
-
- hideSubMenus: function() {
- var
- $subMenus = $menu.children(selector.item).find(selector.menu)
- ;
- module.verbose('Hiding sub menus', $subMenus);
- $subMenus.transition('hide');
- },
-
- bind: {
- keyboardEvents: function() {
- module.debug('Binding keyboard events');
- $module
- .on('keydown' + eventNamespace, module.event.keydown)
- ;
- if( module.has.search() ) {
- $module
- .on(module.get.inputEvent() + eventNamespace, selector.search, module.event.input)
- ;
- }
- if( module.is.multiple() ) {
- $document
- .on('keydown' + elementNamespace, module.event.document.keydown)
- ;
- }
- },
- touchEvents: function() {
- module.debug('Touch device detected binding additional touch events');
- if( module.is.searchSelection() ) {
- // do nothing special yet
- }
- else {
- $module
- .on('touchstart' + eventNamespace, module.event.test.toggle)
- ;
- }
- $menu
- .on('touchstart' + eventNamespace, selector.item, module.event.item.mouseenter)
- ;
- },
- mouseEvents: function() {
- module.debug('Mouse detected binding mouse events');
- if(module.is.multiple()) {
- $module
- .on('click' + eventNamespace, selector.label, module.event.label.click)
- .on('click' + eventNamespace, selector.remove, module.event.remove.click)
- ;
- }
- if( module.is.searchSelection() ) {
- $module
- .on('mousedown' + eventNamespace, selector.menu, module.event.menu.mousedown)
- .on('mouseup' + eventNamespace, selector.menu, module.event.menu.mouseup)
- .on('click' + eventNamespace, selector.search, module.show)
- .on('focus' + eventNamespace, selector.search, module.event.search.focus)
- .on('blur' + eventNamespace, selector.search, module.event.search.blur)
- .on('click' + eventNamespace, selector.text, module.event.text.focus)
- ;
- if(module.is.multiple()) {
- $module
- .on('click' + eventNamespace, module.event.click)
- ;
- }
- }
- else {
- if(settings.on == 'click') {
- $module
- .on('click' + eventNamespace, module.event.test.toggle)
- ;
- }
- else if(settings.on == 'hover') {
- $module
- .on('mouseenter' + eventNamespace, module.delay.show)
- .on('mouseleave' + eventNamespace, module.delay.hide)
- ;
- }
- else {
- $module
- .on(settings.on + eventNamespace, module.toggle)
- ;
- }
- $module
- .on('mousedown' + eventNamespace, module.event.mousedown)
- .on('mouseup' + eventNamespace, module.event.mouseup)
- .on('focus' + eventNamespace, module.event.focus)
- .on('blur' + eventNamespace, module.event.blur)
- ;
- }
- $menu
- .on('mouseenter' + eventNamespace, selector.item, module.event.item.mouseenter)
- .on('mouseleave' + eventNamespace, selector.item, module.event.item.mouseleave)
- .on('click' + eventNamespace, selector.item, module.event.item.click)
- ;
- },
- intent: function() {
- module.verbose('Binding hide intent event to document');
- if(hasTouch) {
- $document
- .on('touchstart' + elementNamespace, module.event.test.touch)
- .on('touchmove' + elementNamespace, module.event.test.touch)
- ;
- }
- $document
- .on('click' + elementNamespace, module.event.test.hide)
- ;
- }
- },
-
- unbind: {
- intent: function() {
- module.verbose('Removing hide intent event from document');
- if(hasTouch) {
- $document
- .off('touchstart' + elementNamespace)
- .off('touchmove' + elementNamespace)
- ;
- }
- $document
- .off('click' + elementNamespace)
- ;
- }
- },
-
- filter: function(query) {
- var
- searchTerm = (query !== undefined)
- ? query
- : module.get.query(),
- afterFiltered = function() {
- if(module.is.multiple()) {
- module.filterActive();
- }
- module.select.firstUnfiltered();
- if( module.has.allResultsFiltered() ) {
- if( settings.onNoResults.call(element, searchTerm) ) {
- if(!settings.allowAdditions) {
- module.verbose('All items filtered, showing message', searchTerm);
- module.add.message(message.noResults);
- }
- }
- else {
- module.verbose('All items filtered, hiding dropdown', searchTerm);
- module.hideMenu();
- }
- }
- else {
- module.remove.message();
- }
- if(settings.allowAdditions) {
- module.add.userSuggestion(query);
- }
- if(module.is.searchSelection() && module.can.show() && module.is.focusedOnSearch() ) {
- module.show();
- }
- }
- ;
- if(module.has.maxSelections()) {
- return;
- }
- if(settings.apiSettings) {
- if( module.can.useAPI() ) {
- module.queryRemote(searchTerm, function() {
- afterFiltered();
- });
- }
- else {
- module.error(error.noAPI);
- }
- }
- else {
- module.filterItems(searchTerm);
- afterFiltered();
- }
- },
-
- queryRemote: function(query, callback) {
- var
- apiSettings = {
- errorDuration : false,
- throttle : settings.throttle,
- cache : 'local',
- urlData : {
- query: query
- },
- onError: function() {
- module.add.message(message.serverError);
- callback();
- },
- onFailure: function() {
- module.add.message(message.serverError);
- callback();
- },
- onSuccess : function(response) {
- module.remove.message();
- module.setup.menu({
- values: response.results
- });
- callback();
- }
- }
- ;
- if( !$module.api('get request') ) {
- module.setup.api();
- }
- apiSettings = $.extend(true, {}, apiSettings, settings.apiSettings);
- $module
- .api('setting', apiSettings)
- .api('query')
- ;
- },
-
- filterItems: function(query) {
- var
- searchTerm = (query !== undefined)
- ? query
- : module.get.query(),
- $results = $(),
- escapedTerm = module.escape.regExp(searchTerm),
- beginsWithRegExp = new RegExp('^' + escapedTerm, 'igm')
- ;
- // avoid loop if we're matching nothing
- if(searchTerm === '') {
- $results = $item;
- }
- else {
- module.verbose('Searching for matching values', searchTerm);
- $item
- .each(function(){
- var
- $choice = $(this),
- text,
- value
- ;
- if(settings.match == 'both' || settings.match == 'text') {
- text = String(module.get.choiceText($choice, false));
- if(text.search(beginsWithRegExp) !== -1) {
- $results = $results.add($choice);
- return true;
- }
- else if(settings.fullTextSearch && module.fuzzySearch(searchTerm, text)) {
- $results = $results.add($choice);
- return true;
- }
- }
- if(settings.match == 'both' || settings.match == 'value') {
- value = String(module.get.choiceValue($choice, text));
-
- if(value.search(beginsWithRegExp) !== -1) {
- $results = $results.add($choice);
- return true;
- }
- else if(settings.fullTextSearch && module.fuzzySearch(searchTerm, value)) {
- $results = $results.add($choice);
- return true;
- }
- }
- })
- ;
- }
-
- module.debug('Showing only matched items', searchTerm);
- module.remove.filteredItem();
- $item
- .not($results)
- .addClass(className.filtered)
- ;
- },
-
- fuzzySearch: function(query, term) {
- var
- termLength = term.length,
- queryLength = query.length
- ;
- query = query.toLowerCase();
- term = term.toLowerCase();
- if(queryLength > termLength) {
- return false;
- }
- if(queryLength === termLength) {
- return (query === term);
- }
- search: for (var characterIndex = 0, nextCharacterIndex = 0; characterIndex < queryLength; characterIndex++) {
- var
- queryCharacter = query.charCodeAt(characterIndex)
- ;
- while(nextCharacterIndex < termLength) {
- if(term.charCodeAt(nextCharacterIndex++) === queryCharacter) {
- continue search;
- }
- }
- return false;
- }
- return true;
- },
-
- filterActive: function() {
- if(settings.useLabels) {
- $item.filter('.' + className.active)
- .addClass(className.filtered)
- ;
- }
- },
-
- focusSearch: function() {
- if( module.is.search() && !module.is.focusedOnSearch() ) {
- $search[0].focus();
- }
- },
-
- forceSelection: function() {
- var
- $currentlySelected = $item.not(className.filtered).filter('.' + className.selected).eq(0),
- $activeItem = $item.not(className.filtered).filter('.' + className.active).eq(0),
- $selectedItem = ($currentlySelected.length > 0)
- ? $currentlySelected
- : $activeItem,
- hasSelected = ($selectedItem.size() > 0)
- ;
- if(hasSelected) {
- module.debug('Forcing partial selection to selected item', $selectedItem);
- module.event.item.click.call($selectedItem);
- }
- else {
- module.hide();
- }
- },
-
- event: {
- focus: function() {
- if(settings.showOnFocus && !activated && module.is.hidden() && !pageLostFocus) {
- module.show();
- }
- },
- click: function(event) {
- var
- $target = $(event.target)
- ;
- // focus search
- if(($target.is($module) || $target.is($icon)) && !module.is.focusedOnSearch()) {
- module.focusSearch();
- }
- },
- blur: function(event) {
- pageLostFocus = (document.activeElement === this);
- if(!activated && !pageLostFocus) {
- module.remove.activeLabel();
- module.hide();
- }
- },
- // prevents focus callback from occuring on mousedown
- mousedown: function() {
- activated = true;
- },
- mouseup: function() {
- activated = false;
- },
- search: {
- focus: function() {
- activated = true;
- if(module.is.multiple()) {
- module.remove.activeLabel();
- }
- if(settings.showOnFocus) {
- module.show();
- }
- },
- blur: function(event) {
- pageLostFocus = (document.activeElement === this);
- if(!itemActivated && !pageLostFocus) {
- if(module.is.multiple()) {
- module.remove.activeLabel();
- module.hide();
- }
- else if(settings.forceSelection) {
- module.forceSelection();
- }
- else {
- module.hide();
- }
- }
- }
- },
- text: {
- focus: function(event) {
- activated = true;
- module.focusSearch();
- }
- },
- input: function(event) {
- if(module.is.multiple() || module.is.searchSelection()) {
- module.set.filtered();
- }
- clearTimeout(module.timer);
- module.timer = setTimeout(module.search, settings.delay.search);
- },
- label: {
- click: function(event) {
- var
- $label = $(this),
- $labels = $module.find(selector.label),
- $activeLabels = $labels.filter('.' + className.active),
- $nextActive = $label.nextAll('.' + className.active),
- $prevActive = $label.prevAll('.' + className.active),
- $range = ($nextActive.length > 0)
- ? $label.nextUntil($nextActive).add($activeLabels).add($label)
- : $label.prevUntil($prevActive).add($activeLabels).add($label)
- ;
- if(event.shiftKey) {
- $activeLabels.removeClass(className.active);
- $range.addClass(className.active);
- }
- else if(event.ctrlKey) {
- $label.toggleClass(className.active);
- }
- else {
- $activeLabels.removeClass(className.active);
- $label.addClass(className.active);
- }
- settings.onLabelSelect.apply(this, $labels.filter('.' + className.active));
- }
- },
- remove: {
- click: function() {
- var
- $label = $(this).parent()
- ;
- if( $label.hasClass(className.active) ) {
- // remove all selected labels
- module.remove.activeLabels();
- }
- else {
- // remove this label only
- module.remove.activeLabels( $label );
- }
- }
- },
- test: {
- toggle: function(event) {
- var
- toggleBehavior = (module.is.multiple())
- ? module.show
- : module.toggle
- ;
- if( module.determine.eventOnElement(event, toggleBehavior) ) {
- event.preventDefault();
- }
- },
- touch: function(event) {
- module.determine.eventOnElement(event, function() {
- if(event.type == 'touchstart') {
- module.timer = setTimeout(module.hide, settings.delay.touch);
- }
- else if(event.type == 'touchmove') {
- clearTimeout(module.timer);
- }
- });
- event.stopPropagation();
- },
- hide: function(event) {
- module.determine.eventInModule(event, module.hide);
- }
- },
- menu: {
- mousedown: function() {
- itemActivated = true;
- },
- mouseup: function() {
- itemActivated = false;
- }
- },
- item: {
- mouseenter: function(event) {
- var
- $subMenu = $(this).children(selector.menu),
- $otherMenus = $(this).siblings(selector.item).children(selector.menu)
- ;
- if( $subMenu.length > 0 ) {
- clearTimeout(module.itemTimer);
- module.itemTimer = setTimeout(function() {
- module.verbose('Showing sub-menu', $subMenu);
- $.each($otherMenus, function() {
- module.animate.hide(false, $(this));
- });
- module.animate.show(false, $subMenu);
- }, settings.delay.show);
- event.preventDefault();
- }
- },
- mouseleave: function(event) {
- var
- $subMenu = $(this).children(selector.menu)
- ;
- if($subMenu.length > 0) {
- clearTimeout(module.itemTimer);
- module.itemTimer = setTimeout(function() {
- module.verbose('Hiding sub-menu', $subMenu);
- module.animate.hide(false, $subMenu);
- }, settings.delay.hide);
- }
- },
- click: function (event) {
- var
- $choice = $(this),
- $target = (event)
- ? $(event.target)
- : $(''),
- $subMenu = $choice.find(selector.menu),
- text = module.get.choiceText($choice),
- value = module.get.choiceValue($choice, text),
- hasSubMenu = ($subMenu.length > 0),
- isBubbledEvent = ($subMenu.find($target).length > 0)
- ;
- if(!isBubbledEvent && (!hasSubMenu || settings.allowCategorySelection)) {
- if(!settings.useLabels) {
- module.remove.searchTerm();
- }
- module.determine.selectAction.call(this, text, value);
- }
- }
- },
-
- document: {
- // label selection should occur even when element has no focus
- keydown: function(event) {
- var
- pressedKey = event.which,
- keys = module.get.shortcutKeys(),
- isShortcutKey = module.is.inObject(pressedKey, keys)
- ;
- if(isShortcutKey) {
- var
- $label = $module.find(selector.label),
- $activeLabel = $label.filter('.' + className.active),
- activeValue = $activeLabel.data('value'),
- labelIndex = $label.index($activeLabel),
- labelCount = $label.length,
- hasActiveLabel = ($activeLabel.length > 0),
- hasMultipleActive = ($activeLabel.length > 1),
- isFirstLabel = (labelIndex === 0),
- isLastLabel = (labelIndex + 1 == labelCount),
- isSearch = module.is.searchSelection(),
- isFocusedOnSearch = module.is.focusedOnSearch(),
- isFocused = module.is.focused(),
- caretAtStart = (isFocusedOnSearch && module.get.caretPosition() === 0),
- $nextLabel
- ;
- if(isSearch && !hasActiveLabel && !isFocusedOnSearch) {
- return;
- }
-
- if(pressedKey == keys.leftArrow) {
- // activate previous label
- if((isFocused || caretAtStart) && !hasActiveLabel) {
- module.verbose('Selecting previous label');
- $label.last().addClass(className.active);
- }
- else if(hasActiveLabel) {
- if(!event.shiftKey) {
- module.verbose('Selecting previous label');
- $label.removeClass(className.active);
- }
- else {
- module.verbose('Adding previous label to selection');
- }
- if(isFirstLabel && !hasMultipleActive) {
- $activeLabel.addClass(className.active);
- }
- else {
- $activeLabel.prev(selector.siblingLabel)
- .addClass(className.active)
- .end()
- ;
- }
- event.preventDefault();
- }
- }
- else if(pressedKey == keys.rightArrow) {
- // activate first label
- if(isFocused && !hasActiveLabel) {
- $label.first().addClass(className.active);
- }
- // activate next label
- if(hasActiveLabel) {
- if(!event.shiftKey) {
- module.verbose('Selecting next label');
- $label.removeClass(className.active);
- }
- else {
- module.verbose('Adding next label to selection');
- }
- if(isLastLabel) {
- if(isSearch) {
- if(!isFocusedOnSearch) {
- module.focusSearch();
- }
- else {
- $label.removeClass(className.active);
- }
- }
- else if(hasMultipleActive) {
- $activeLabel.next(selector.siblingLabel).addClass(className.active);
- }
- else {
- $activeLabel.addClass(className.active);
- }
- }
- else {
- $activeLabel.next(selector.siblingLabel).addClass(className.active);
- }
- event.preventDefault();
- }
- }
- else if(pressedKey == keys.deleteKey || pressedKey == keys.backspace) {
- if(hasActiveLabel) {
- module.verbose('Removing active labels');
- if(isLastLabel) {
- if(isSearch && !isFocusedOnSearch) {
- module.focusSearch();
- }
- }
- $activeLabel.last().next(selector.siblingLabel).addClass(className.active);
- module.remove.activeLabels($activeLabel);
- event.preventDefault();
- }
- else if(caretAtStart && !hasActiveLabel && pressedKey == keys.backspace) {
- module.verbose('Removing last label on input backspace');
- $activeLabel = $label.last().addClass(className.active);
- module.remove.activeLabels($activeLabel);
- }
- }
- else {
- $activeLabel.removeClass(className.active);
- }
- }
- }
- },
-
- keydown: function(event) {
- var
- pressedKey = event.which,
- keys = module.get.shortcutKeys(),
- isShortcutKey = module.is.inObject(pressedKey, keys)
- ;
- if(isShortcutKey) {
- var
- $currentlySelected = $item.not(selector.unselectable).filter('.' + className.selected).eq(0),
- $activeItem = $menu.children('.' + className.active).eq(0),
- $selectedItem = ($currentlySelected.length > 0)
- ? $currentlySelected
- : $activeItem,
- $visibleItems = ($selectedItem.length > 0)
- ? $selectedItem.siblings(':not(.' + className.filtered +')').andSelf()
- : $menu.children(':not(.' + className.filtered +')'),
- $subMenu = $selectedItem.children(selector.menu),
- $parentMenu = $selectedItem.closest(selector.menu),
- inVisibleMenu = ($parentMenu.hasClass(className.visible) || $parentMenu.hasClass(className.animating) || $parentMenu.parent(selector.menu).length > 0),
- hasSubMenu = ($subMenu.length> 0),
- hasSelectedItem = ($selectedItem.length > 0),
- selectedIsVisible = ($selectedItem.not(selector.unselectable).length > 0),
- $nextItem,
- isSubMenuItem,
- newIndex
- ;
-
- // visible menu keyboard shortcuts
- if( module.is.visible() ) {
-
- // enter (select or open sub-menu)
- if(pressedKey == keys.enter || pressedKey == keys.delimiter) {
-
- if(pressedKey == keys.enter && hasSelectedItem && hasSubMenu && !settings.allowCategorySelection) {
- module.verbose('Pressed enter on unselectable category, opening sub menu');
- pressedKey = keys.rightArrow;
- }
- else if(selectedIsVisible) {
- module.verbose('Selecting item from keyboard shortcut', $selectedItem);
- module.event.item.click.call($selectedItem, event);
- if(settings.useLabels && module.is.searchSelection()) {
- module.hideAndClear();
- }
- else {
- module.remove.searchTerm();
- }
- }
- event.preventDefault();
- }
-
- // left arrow (hide sub-menu)
- if(pressedKey == keys.leftArrow) {
-
- isSubMenuItem = ($parentMenu[0] !== $menu[0]);
-
- if(isSubMenuItem) {
- module.verbose('Left key pressed, closing sub-menu');
- module.animate.hide(false, $parentMenu);
- $selectedItem
- .removeClass(className.selected)
- ;
- $parentMenu
- .closest(selector.item)
- .addClass(className.selected)
- ;
- event.preventDefault();
- }
- }
-
- // right arrow (show sub-menu)
- if(pressedKey == keys.rightArrow) {
- if(hasSubMenu) {
- module.verbose('Right key pressed, opening sub-menu');
- module.animate.show(false, $subMenu);
- $selectedItem
- .removeClass(className.selected)
- ;
- $subMenu
- .find(selector.item).eq(0)
- .addClass(className.selected)
- ;
- event.preventDefault();
- }
- }
-
- // up arrow (traverse menu up)
- if(pressedKey == keys.upArrow) {
- $nextItem = (hasSelectedItem && inVisibleMenu)
- ? $selectedItem.prevAll(selector.item + ':not(' + selector.unselectable + ')').eq(0)
- : $item.eq(0)
- ;
- if($visibleItems.index( $nextItem ) < 0) {
- module.verbose('Up key pressed but reached top of current menu');
- event.preventDefault();
- return;
- }
- else {
- module.verbose('Up key pressed, changing active item');
- $selectedItem
- .removeClass(className.selected)
- ;
- $nextItem
- .addClass(className.selected)
- ;
- module.set.scrollPosition($nextItem);
- }
- event.preventDefault();
- }
-
- // down arrow (traverse menu down)
- if(pressedKey == keys.downArrow) {
- $nextItem = (hasSelectedItem && inVisibleMenu)
- ? $nextItem = $selectedItem.nextAll(selector.item + ':not(' + selector.unselectable + ')').eq(0)
- : $item.eq(0)
- ;
- if($nextItem.length === 0) {
- module.verbose('Down key pressed but reached bottom of current menu');
- event.preventDefault();
- return;
- }
- else {
- module.verbose('Down key pressed, changing active item');
- $item
- .removeClass(className.selected)
- ;
- $nextItem
- .addClass(className.selected)
- ;
- module.set.scrollPosition($nextItem);
- }
- event.preventDefault();
- }
-
- // page down (show next page)
- if(pressedKey == keys.pageUp) {
- module.scrollPage('up');
- event.preventDefault();
- }
- if(pressedKey == keys.pageDown) {
- module.scrollPage('down');
- event.preventDefault();
- }
-
- // escape (close menu)
- if(pressedKey == keys.escape) {
- module.verbose('Escape key pressed, closing dropdown');
- module.hide();
- }
-
- }
- else {
- // delimiter key
- if(pressedKey == keys.delimiter) {
- event.preventDefault();
- }
- // down arrow (open menu)
- if(pressedKey == keys.downArrow) {
- module.verbose('Down key pressed, showing dropdown');
- module.show();
- event.preventDefault();
- }
- }
- }
- else {
- if( module.is.selection() && !module.is.search() ) {
- module.set.selectedLetter( String.fromCharCode(pressedKey) );
- }
- }
- }
- },
-
- determine: {
- selectAction: function(text, value) {
- module.verbose('Determining action', settings.action);
- if( $.isFunction( module.action[settings.action] ) ) {
- module.verbose('Triggering preset action', settings.action, text, value);
- module.action[ settings.action ].call(this, text, value);
- }
- else if( $.isFunction(settings.action) ) {
- module.verbose('Triggering user action', settings.action, text, value);
- settings.action.call(this, text, value);
- }
- else {
- module.error(error.action, settings.action);
- }
- },
- eventInModule: function(event, callback) {
- callback = $.isFunction(callback)
- ? callback
- : function(){}
- ;
- if( $(event.target).closest($module).length === 0 ) {
- module.verbose('Triggering event', callback);
- callback();
- return true;
- }
- else {
- module.verbose('Event occurred in dropdown, canceling callback');
- return false;
- }
- },
- eventOnElement: function(event, callback) {
- var
- $target = $(event.target)
- ;
- callback = $.isFunction(callback)
- ? callback
- : function(){}
- ;
- if($target.closest($menu).length === 0) {
- module.verbose('Triggering event', callback);
- callback();
- return true;
- }
- else {
- module.verbose('Event occurred in dropdown menu, canceling callback');
- return false;
- }
- }
- },
-
- action: {
-
- nothing: function() {},
-
- activate: function(text, value) {
- value = (value !== undefined)
- ? value
- : text
- ;
- module.set.selected(value, $(this));
- if(module.is.multiple() && !module.is.allFiltered()) {
- return;
- }
- else {
- module.hideAndClear();
- }
- },
-
- select: function(text, value) {
- // mimics action.activate but does not select text
- module.action.activate.call(this);
- },
-
- combo: function(text, value) {
- value = (value !== undefined)
- ? value
- : text
- ;
- module.set.selected(value, $(this));
- module.hideAndClear();
- },
-
- hide: function() {
- module.hideAndClear();
- }
-
- },
-
- get: {
- id: function() {
- return id;
- },
- text: function() {
- return $text.text();
- },
- query: function() {
- return $.trim($search.val());
- },
- searchWidth: function(characterCount) {
- return (characterCount * settings.glyphWidth) + 'em';
- },
- selectionCount: function() {
- var
- values = module.get.values()
- ;
- return ( module.is.multiple() )
- ? $.isArray(values)
- ? values.length
- : 0
- : (module.get.value() !== '')
- ? 1
- : 0
- ;
- },
- transition: function($subMenu) {
- return (settings.transition == 'auto')
- ? module.is.upward($subMenu)
- ? 'slide up'
- : 'slide down'
- : settings.transition
- ;
- },
- userValues: function() {
- var
- values = module.get.values()
- ;
- if(!values) {
- return false;
- }
- values = $.isArray(values)
- ? values
- : [values]
- ;
- return $.grep(values, function(value) {
- return (module.get.item(value) === false);
- });
- },
- uniqueArray: function(array) {
- return $.grep(array, function (value, index) {
- return $.inArray(value, array) === index;
- });
- },
- caretPosition: function() {
- var
- input = $search.get(0),
- range,
- rangeLength
- ;
- if('selectionStart' in input) {
- return input.selectionStart;
- }
- else if (document.selection) {
- input.focus();
- range = document.selection.createRange();
- rangeLength = range.text.length;
- range.moveStart('character', -input.value.length);
- return range.text.length - rangeLength;
- }
- },
- shortcutKeys: function() {
- return {
- backspace : 8,
- delimiter : 188, // comma
- deleteKey : 46,
- enter : 13,
- escape : 27,
- pageUp : 33,
- pageDown : 34,
- leftArrow : 37,
- upArrow : 38,
- rightArrow : 39,
- downArrow : 40
- };
- },
- value: function() {
- return ($input.length > 0)
- ? $input.val()
- : $module.data(metadata.value)
- ;
- },
- values: function() {
- var
- value = module.get.value()
- ;
- if(value === '') {
- return '';
- }
- return (!$input.is('select') && module.is.multiple())
- ? typeof value == 'string'
- ? value.split(settings.delimiter)
- : ''
- : value
- ;
- },
- remoteValues: function() {
- var
- values = module.get.values(),
- remoteValues = false
- ;
- if(values) {
- if(typeof values == 'string') {
- values = [values];
- }
- remoteValues = {};
- $.each(values, function(index, value) {
- var
- name = module.read.remoteData(value)
- ;
- module.verbose('Restoring value from session data', name, value);
- remoteValues[value] = (name)
- ? name
- : value
- ;
- });
- }
- return remoteValues;
- },
- choiceText: function($choice, preserveHTML) {
- preserveHTML = (preserveHTML !== undefined)
- ? preserveHTML
- : settings.preserveHTML
- ;
- if($choice) {
- if($choice.find(selector.menu).length > 0) {
- module.verbose('Retreiving text of element with sub-menu');
- $choice = $choice.clone();
- $choice.find(selector.menu).remove();
- $choice.find(selector.menuIcon).remove();
- }
- return ($choice.data(metadata.text) !== undefined)
- ? $choice.data(metadata.text)
- : (preserveHTML)
- ? $choice.html().trim()
- : $choice.text().trim()
- ;
- }
- },
- choiceValue: function($choice, choiceText) {
- choiceText = choiceText || module.get.choiceText($choice);
- if(!$choice) {
- return false;
- }
- return ($choice.data(metadata.value) !== undefined)
- ? $choice.data(metadata.value)
- : (typeof choiceText === 'string')
- ? choiceText.toLowerCase().trim()
- : choiceText
- ;
- },
- inputEvent: function() {
- var
- input = $search[0]
- ;
- if(input) {
- return (input.oninput !== undefined)
- ? 'input'
- : (input.onpropertychange !== undefined)
- ? 'propertychange'
- : 'keyup'
- ;
- }
- return false;
- },
- selectValues: function() {
- var
- select = {}
- ;
- select.values = [];
- $module
- .find('option')
- .each(function() {
- var
- $option = $(this),
- name = $option.html(),
- disabled = $option.attr('disabled'),
- value = ( $option.attr('value') !== undefined )
- ? $option.attr('value')
- : name
- ;
- if(settings.placeholder === 'auto' && value === '') {
- select.placeholder = name;
- }
- else {
- select.values.push({
- name : name,
- value : value,
- disabled : disabled
- });
- }
- })
- ;
- if(settings.placeholder && settings.placeholder !== 'auto') {
- module.debug('Setting placeholder value to', settings.placeholder);
- select.placeholder = settings.placeholder;
- }
- if(settings.sortSelect) {
- select.values.sort(function(a, b) {
- return (a.name > b.name)
- ? 1
- : -1
- ;
- });
- module.debug('Retrieved and sorted values from select', select);
- }
- else {
- module.debug('Retreived values from select', select);
- }
- return select;
- },
- activeItem: function() {
- return $item.filter('.' + className.active);
- },
- selectedItem: function() {
- var
- $selectedItem = $item.not(selector.unselectable).filter('.' + className.selected)
- ;
- return ($selectedItem.length > 0)
- ? $selectedItem
- : $item.eq(0)
- ;
- },
- itemWithAdditions: function(value) {
- var
- $items = module.get.item(value),
- $userItems = module.create.userChoice(value),
- hasUserItems = ($userItems && $userItems.length > 0)
- ;
- if(hasUserItems) {
- $items = ($items.length > 0)
- ? $items.add($userItems)
- : $userItems
- ;
- }
- return $items;
- },
- item: function(value, strict) {
- var
- $selectedItem = false,
- shouldSearch,
- isMultiple
- ;
- value = (value !== undefined)
- ? value
- : ( module.get.values() !== undefined)
- ? module.get.values()
- : module.get.text()
- ;
- shouldSearch = (isMultiple)
- ? (value.length > 0)
- : (value !== undefined && value !== '' && value !== null)
- ;
- isMultiple = (module.is.multiple() && $.isArray(value));
- strict = (value === '' || value === 0)
- ? true
- : strict || false
- ;
- if(shouldSearch) {
- $item
- .each(function() {
- var
- $choice = $(this),
- optionText = module.get.choiceText($choice),
- optionValue = module.get.choiceValue($choice, optionText)
- ;
- // safe early exit
- if(optionValue === null || optionValue === undefined) {
- return;
- }
- if(isMultiple) {
- if($.inArray(optionValue.toString(), value) !== -1 || $.inArray(optionText, value) !== -1) {
- $selectedItem = ($selectedItem)
- ? $selectedItem.add($choice)
- : $choice
- ;
- }
- }
- else if(strict) {
- module.verbose('Ambiguous dropdown value using strict type check', $choice, value);
- if( optionValue === value || optionText === value) {
- $selectedItem = $choice;
- return true;
- }
- }
- else {
- if( optionValue.toString() == value.toString() || optionText == value) {
- module.verbose('Found select item by value', optionValue, value);
- $selectedItem = $choice;
- return true;
- }
- }
- })
- ;
- }
- return $selectedItem;
- }
- },
-
- check: {
- maxSelections: function(selectionCount) {
- if(settings.maxSelections) {
- selectionCount = (selectionCount !== undefined)
- ? selectionCount
- : module.get.selectionCount()
- ;
- if(selectionCount >= settings.maxSelections) {
- module.debug('Maximum selection count reached');
- $item.addClass(className.filtered);
- module.add.message(message.maxSelections);
- return true;
- }
- else {
- module.verbose('No longer at maximum selection count');
- module.remove.message();
- module.remove.filteredItem();
- if(module.is.searchSelection()) {
- module.filterItems();
- }
- return false;
- }
- }
- return true;
- }
- },
-
- restore: {
- defaults: function() {
- module.restore.defaultText();
- module.restore.defaultValue();
- },
- defaultText: function() {
- var
- defaultText = $module.data(metadata.defaultText)
- ;
- module.debug('Restoring default text', defaultText);
- module.set.text(defaultText);
- $text.addClass(className.placeholder);
- },
- defaultValue: function() {
- var
- defaultValue = $module.data(metadata.defaultValue)
- ;
- if(defaultValue !== undefined) {
- module.debug('Restoring default value', defaultValue);
- if(defaultValue !== '') {
- module.set.value(defaultValue);
- module.set.selected();
- }
- else {
- module.remove.activeItem();
- module.remove.selectedItem();
- }
- }
- },
- labels: function() {
- if(settings.allowAdditions) {
- if(!settings.useLabels) {
- module.error(error.labels);
- settings.useLabels = true;
- }
- module.debug('Restoring selected values');
- module.create.userLabels();
- }
- module.check.maxSelections();
- },
- selected: function() {
- module.restore.values();
- if(module.is.multiple()) {
- module.debug('Restoring previously selected values and labels');
- module.restore.labels();
- }
- else {
- module.debug('Restoring previously selected values');
- }
- },
- values: function() {
- // prevents callbacks from occuring on initial load
- module.set.initialLoad();
- if(settings.apiSettings) {
- if(settings.saveRemoteData) {
- module.restore.remoteValues();
- }
- else {
- module.clearValue();
- }
- }
- else {
- module.set.selected();
- }
- module.remove.initialLoad();
- },
- remoteValues: function() {
- var
- values = module.get.remoteValues()
- ;
- module.debug('Recreating selected from session data', values);
- if(values) {
- if( module.is.single() ) {
- $.each(values, function(value, name) {
- module.set.text(name);
- });
- }
- else {
- $.each(values, function(value, name) {
- module.add.label(value, name);
- });
- }
- }
- }
- },
-
- read: {
- remoteData: function(value) {
- var
- name
- ;
- if(window.Storage === undefined) {
- module.error(error.noStorage);
- return;
- }
- name = sessionStorage.getItem(value);
- return (name !== undefined)
- ? name
- : false
- ;
- }
- },
-
- save: {
- defaults: function() {
- module.save.defaultText();
- module.save.placeholderText();
- module.save.defaultValue();
- },
- defaultValue: function() {
- var
- value = module.get.value()
- ;
- module.verbose('Saving default value as', value);
- $module.data(metadata.defaultValue, value);
- },
- defaultText: function() {
- var
- text = module.get.text()
- ;
- module.verbose('Saving default text as', text);
- $module.data(metadata.defaultText, text);
- },
- placeholderText: function() {
- var
- text
- ;
- if($text.hasClass(className.placeholder)) {
- text = module.get.text();
- module.verbose('Saving placeholder text as', text);
- $module.data(metadata.placeholderText, text);
- }
- },
- remoteData: function(name, value) {
- if(window.Storage === undefined) {
- module.error(error.noStorage);
- return;
- }
- module.verbose('Saving remote data to session storage', value, name);
- sessionStorage.setItem(value, name);
- }
- },
-
- clear: function() {
- if(module.is.multiple()) {
- module.remove.labels();
- }
- else {
- module.remove.activeItem();
- module.remove.selectedItem();
- }
- module.set.placeholderText();
- module.clearValue();
- },
-
- clearValue: function() {
- module.set.value('');
- },
-
- scrollPage: function(direction, $selectedItem) {
- var
- $selectedItem = $selectedItem || module.get.selectedItem(),
- $menu = $selectedItem.closest(selector.menu),
- menuHeight = $menu.outerHeight(),
- currentScroll = $menu.scrollTop(),
- itemHeight = $item.eq(0).outerHeight(),
- itemsPerPage = Math.floor(menuHeight / itemHeight),
- maxScroll = $menu.prop('scrollHeight'),
- newScroll = (direction == 'up')
- ? currentScroll - (itemHeight * itemsPerPage)
- : currentScroll + (itemHeight * itemsPerPage),
- $selectableItem = $item.not(selector.unselectable),
- isWithinRange,
- $nextSelectedItem,
- elementIndex
- ;
- elementIndex = (direction == 'up')
- ? $selectableItem.index($selectedItem) - itemsPerPage
- : $selectableItem.index($selectedItem) + itemsPerPage
- ;
- isWithinRange = (direction == 'up')
- ? (elementIndex >= 0)
- : (elementIndex < $selectableItem.length)
- ;
- $nextSelectedItem = (isWithinRange)
- ? $selectableItem.eq(elementIndex)
- : (direction == 'up')
- ? $selectableItem.first()
- : $selectableItem.last()
- ;
- if($nextSelectedItem.length > 0) {
- module.debug('Scrolling page', direction, $nextSelectedItem);
- $selectedItem
- .removeClass(className.selected)
- ;
- $nextSelectedItem
- .addClass(className.selected)
- ;
- $menu
- .scrollTop(newScroll)
- ;
- }
- },
-
- set: {
- filtered: function() {
- var
- isMultiple = module.is.multiple(),
- isSearch = module.is.searchSelection(),
- isSearchMultiple = (isMultiple && isSearch),
- searchValue = (isSearch)
- ? module.get.query()
- : '',
- hasSearchValue = (typeof searchValue === 'string' && searchValue.length > 0),
- searchWidth = module.get.searchWidth(searchValue.length),
- valueIsSet = searchValue !== ''
- ;
- if(isMultiple && hasSearchValue) {
- module.verbose('Adjusting input width', searchWidth, settings.glyphWidth);
- $search.css('width', searchWidth);
- }
- if(hasSearchValue || (isSearchMultiple && valueIsSet)) {
- module.verbose('Hiding placeholder text');
- $text.addClass(className.filtered);
- }
- else if(!isMultiple || (isSearchMultiple && !valueIsSet)) {
- module.verbose('Showing placeholder text');
- $text.removeClass(className.filtered);
- }
- },
- loading: function() {
- $module.addClass(className.loading);
- },
- placeholderText: function(text) {
- text = text || $module.data(metadata.placeholderText);
- if(text) {
- module.debug('Restoring placeholder text');
- module.set.text(text);
- $text.addClass(className.placeholder);
- }
- },
- tabbable: function() {
- if( module.has.search() ) {
- module.debug('Added tabindex to searchable dropdown');
- $search
- .val('')
- .attr('tabindex', 0)
- ;
- $menu
- .attr('tabindex', -1)
- ;
- }
- else {
- module.debug('Added tabindex to dropdown');
- if(!$module.attr('tabindex') ) {
- $module
- .attr('tabindex', 0)
- ;
- $menu
- .attr('tabindex', -1)
- ;
- }
- }
- },
- initialLoad: function() {
- module.verbose('Setting initial load');
- initialLoad = true;
- },
- scrollPosition: function($item, forceScroll) {
- var
- edgeTolerance = 5,
- $menu,
- hasActive,
- offset,
- itemHeight,
- itemOffset,
- menuOffset,
- menuScroll,
- menuHeight,
- abovePage,
- belowPage
- ;
-
- $item = $item || module.get.selectedItem();
- $menu = $item.closest(selector.menu);
- hasActive = ($item && $item.length > 0);
- forceScroll = (forceScroll !== undefined)
- ? forceScroll
- : false
- ;
- if($item && $menu.length > 0 && hasActive) {
- itemOffset = $item.position().top;
-
- $menu.addClass(className.loading);
- menuScroll = $menu.scrollTop();
- menuOffset = $menu.offset().top;
- itemOffset = $item.offset().top;
- offset = menuScroll - menuOffset + itemOffset;
- if(!forceScroll) {
- menuHeight = $menu.height();
- belowPage = menuScroll + menuHeight < (offset + edgeTolerance);
- abovePage = ((offset - edgeTolerance) < menuScroll);
- }
- module.debug('Scrolling to active item', offset);
- if(forceScroll || abovePage || belowPage) {
- $menu.scrollTop(offset);
- }
- $menu.removeClass(className.loading);
- }
- },
- text: function(text) {
- if(settings.action !== 'select') {
- if(settings.action == 'combo') {
- module.debug('Changing combo button text', text, $combo);
- if(settings.preserveHTML) {
- $combo.html(text);
- }
- else {
- $combo.text(text);
- }
- }
- else {
- module.debug('Changing text', text, $text);
- $text
- .removeClass(className.filtered)
- .removeClass(className.placeholder)
- ;
- if(settings.preserveHTML) {
- $text.html(text);
- }
- else {
- $text.text(text);
- }
- }
- }
- },
- selectedLetter: function(letter) {
- var
- $selectedItem = $item.filter('.' + className.selected),
- $nextValue = false
- ;
- $item
- .each(function(){
- var
- $choice = $(this),
- text = module.get.choiceText($choice, false),
- firstLetter = String(text).charAt(0).toLowerCase(),
- matchedLetter = letter.toLowerCase()
- ;
- if(firstLetter == matchedLetter) {
- $nextValue = $choice;
- return false;
- }
- })
- ;
- if($nextValue) {
- module.verbose('Scrolling to next value with letter', letter);
- module.set.scrollPosition($nextValue);
- $selectedItem.removeClass(className.selected);
- $nextValue.addClass(className.selected);
- }
- },
- direction: function($menu) {
- if(settings.direction == 'auto') {
- if(module.is.onScreen($menu)) {
- module.remove.upward($menu);
- }
- else {
- module.set.upward($menu);
- }
- }
- else if(settings.direction == 'upward') {
- module.set.upward($menu);
- }
- },
- upward: function($menu) {
- var $element = $menu || $module;
- $element.addClass(className.upward);
- },
- value: function(value, text, $selected) {
- var
- hasInput = ($input.length > 0),
- isAddition = !module.has.value(value),
- currentValue = module.get.values(),
- stringValue = (typeof value == 'number')
- ? value.toString()
- : value,
- newValue
- ;
- if(hasInput) {
- if(stringValue == currentValue) {
- module.verbose('Skipping value update already same value', value, currentValue);
- if(!module.is.initialLoad()) {
- return;
- }
- }
- module.debug('Updating input value', value, currentValue);
- $input
- .val(value)
- .trigger('change')
- ;
- }
- else {
- module.verbose('Storing value in metadata', value, $input);
- if(value !== currentValue) {
- $module.data(metadata.value, value);
- }
- }
- if(settings.fireOnInit === false && module.is.initialLoad()) {
- module.verbose('No callback on initial load', settings.onChange);
- }
- else {
- settings.onChange.call(element, value, text, $selected);
- }
- },
- active: function() {
- $module
- .addClass(className.active)
- ;
- },
- multiple: function() {
- $module.addClass(className.multiple);
- },
- visible: function() {
- $module.addClass(className.visible);
- },
- selected: function(value, $selectedItem) {
- var
- isMultiple = module.is.multiple(),
- $userSelectedItem
- ;
- $selectedItem = (settings.allowAdditions)
- ? $selectedItem || module.get.itemWithAdditions(value)
- : $selectedItem || module.get.item(value)
- ;
- if(!$selectedItem) {
- return;
- }
- module.debug('Setting selected menu item to', $selectedItem);
- if(module.is.single()) {
- module.remove.activeItem();
- module.remove.selectedItem();
- }
- else if(settings.useLabels) {
- module.remove.selectedItem();
- }
- // select each item
- $selectedItem
- .each(function() {
- var
- $selected = $(this),
- selectedText = module.get.choiceText($selected),
- selectedValue = module.get.choiceValue($selected, selectedText),
-
- isFiltered = $selected.hasClass(className.filtered),
- isActive = $selected.hasClass(className.active),
- isUserValue = $selected.hasClass(className.addition),
- shouldAnimate = (isMultiple && $selectedItem.length == 1)
- ;
- if(isMultiple) {
- if(!isActive || isUserValue) {
- if(settings.apiSettings && settings.saveRemoteData) {
- module.save.remoteData(selectedText, selectedValue);
- }
- if(settings.useLabels) {
- module.add.value(selectedValue, selectedText, $selected);
- module.add.label(selectedValue, selectedText, shouldAnimate);
- $selected.addClass(className.active);
- module.filterActive();
- module.select.nextAvailable($selectedItem);
- }
- else {
- module.add.value(selectedValue, selectedText, $selected);
- module.set.text(module.add.variables(message.count));
- $selected.addClass(className.active);
- }
- }
- else if(!isFiltered) {
- module.debug('Selected active value, removing label');
- module.remove.selected(selectedValue);
- }
- }
- else {
- if(settings.apiSettings && settings.saveRemoteData) {
- module.save.remoteData(selectedText, selectedValue);
- }
- module.set.value(selectedValue, selectedText, $selected);
- module.set.text(selectedText);
- $selected
- .addClass(className.active)
- .addClass(className.selected)
- ;
- }
- })
- ;
- }
- },
-
- add: {
- label: function(value, text, shouldAnimate) {
- var
- $next = module.is.searchSelection()
- ? $search
- : $text,
- $label
- ;
- $label = $('<a />')
- .addClass(className.label)
- .attr('data-value', value)
- .html(templates.label(value, text))
- ;
- $label = settings.onLabelCreate.call($label, value, text);
-
- if(module.has.label(value)) {
- module.debug('Label already exists, skipping', value);
- return;
- }
- if(settings.label.variation) {
- $label.addClass(settings.label.variation);
- }
- if(shouldAnimate === true) {
- module.debug('Animating in label', $label);
- $label
- .addClass(className.hidden)
- .insertBefore($next)
- .transition(settings.label.transition, settings.label.duration)
- ;
- }
- else {
- module.debug('Adding selection label', $label);
- $label
- .insertBefore($next)
- ;
- }
- },
- message: function(message) {
- var
- $message = $menu.children(selector.message),
- html = settings.templates.message(module.add.variables(message))
- ;
- if($message.length > 0) {
- $message
- .html(html)
- ;
- }
- else {
- $message = $('<div/>')
- .html(html)
- .addClass(className.message)
- .appendTo($menu)
- ;
- }
- },
- optionValue: function(value) {
- var
- $option = $input.find('option[value="' + value + '"]'),
- hasOption = ($option.length > 0)
- ;
- if(hasOption) {
- return;
- }
- // temporarily disconnect observer
- if(selectObserver) {
- selectObserver.disconnect();
- module.verbose('Temporarily disconnecting mutation observer', value);
- }
- $('<option/>')
- .prop('value', value)
- .html(value)
- .appendTo($input)
- ;
- module.verbose('Adding user addition as an <option>', value);
- if(selectObserver) {
- selectObserver.observe($input[0], {
- childList : true,
- subtree : true
- });
- }
- },
- userSuggestion: function(value) {
- var
- $addition = $menu.children(selector.addition),
- alreadyHasValue = module.get.item(value),
- hasUserSuggestion = $addition.length > 0,
- html
- ;
- if(module.has.maxSelections()) {
- return;
- }
- if(value === '' || alreadyHasValue) {
- $addition.remove();
- return;
- }
- $item
- .removeClass(className.selected)
- ;
- if(hasUserSuggestion) {
- html = settings.templates.addition(value);
- $addition
- .html(html)
- .data(metadata.value, value)
- .removeClass(className.filtered)
- .addClass(className.selected)
- ;
- module.verbose('Replacing user suggestion with new value', $addition);
- }
- else {
- $addition = module.create.userChoice(value);
- $addition
- .prependTo($menu)
- .addClass(className.selected)
- ;
- module.verbose('Adding item choice to menu corresponding with user choice addition', $addition);
- }
- },
- variables: function(message) {
- var
- hasCount = (message.search('{count}') !== -1),
- hasMaxCount = (message.search('{maxCount}') !== -1),
- hasTerm = (message.search('{term}') !== -1),
- values,
- count,
- query
- ;
- module.verbose('Adding templated variables to message', message);
- if(hasCount) {
- count = module.get.selectionCount();
- message = message.replace('{count}', count);
- }
- if(hasMaxCount) {
- count = module.get.selectionCount();
- message = message.replace('{maxCount}', settings.maxSelections);
- }
- if(hasTerm) {
- query = module.get.query();
- message = message.replace('{term}', query);
- }
- return message;
- },
- value: function(addedValue, addedText, $selectedItem) {
- var
- currentValue = module.get.values(),
- newValue
- ;
- if(addedValue === '') {
- module.debug('Cannot select blank values from multiselect');
- return;
- }
- // extend currently array
- if($.isArray(currentValue)) {
- newValue = currentValue.concat([addedValue]);
- newValue = module.get.uniqueArray(newValue);
- }
- else {
- newValue = [addedValue];
- }
- // add values
- if( $input.is('select')) {
- if(settings.allowAdditions) {
- module.add.optionValue(addedValue);
- module.debug('Adding value to select', addedValue, newValue, $input);
- }
- }
- else {
- newValue = newValue.join(settings.delimiter);
- module.debug('Setting hidden input to delimited value', newValue, $input);
- }
-
- if(settings.fireOnInit === false && module.is.initialLoad()) {
- module.verbose('No callback on initial load', settings.onAdd);
- }
- else {
- settings.onAdd.call(element, addedValue, addedText, $selectedItem);
- }
- module.set.value(newValue, addedValue, addedText, $selectedItem);
- module.check.maxSelections();
- }
- },
-
- remove: {
- active: function() {
- $module.removeClass(className.active);
- },
- activeLabel: function() {
- $module.find(selector.label).removeClass(className.active);
- },
- loading: function() {
- $module.removeClass(className.loading);
- },
- initialLoad: function() {
- initialLoad = false;
- },
- upward: function($menu) {
- var $element = $menu || $module;
- $element.removeClass(className.upward);
- },
- visible: function() {
- $module.removeClass(className.visible);
- },
- activeItem: function() {
- $item.removeClass(className.active);
- },
- filteredItem: function() {
- if( module.has.maxSelections() ) {
- return;
- }
- if(settings.useLabels) {
- $item.not('.' + className.active).removeClass(className.filtered);
- }
- else {
- $item.removeClass(className.filtered);
- }
- },
- message: function() {
- $menu.children(selector.message).remove();
- },
- searchTerm: function() {
- module.verbose('Cleared search term');
- $search.val('');
- module.set.filtered();
- },
- selected: function(value, $selectedItem) {
- $selectedItem = (settings.allowAdditions)
- ? $selectedItem || module.get.itemWithAdditions(value)
- : $selectedItem || module.get.item(value)
- ;
-
- if(!$selectedItem) {
- return false;
- }
-
- $selectedItem
- .each(function() {
- var
- $selected = $(this),
- selectedText = module.get.choiceText($selected),
- selectedValue = module.get.choiceValue($selected, selectedText)
- ;
- if(module.is.multiple()) {
- if(settings.useLabels) {
- module.remove.value(selectedValue, selectedText, $selected);
- module.remove.label(selectedValue);
- }
- else {
- module.remove.value(selectedValue, selectedText, $selected);
- module.set.text(module.add.variables(message.count));
- }
- }
- else {
- module.remove.value(selectedValue, selectedText, $selected);
- }
- $selected
- .removeClass(className.filtered)
- .removeClass(className.active)
- ;
- if(settings.useLabels) {
- $selected.removeClass(className.selected);
- }
- })
- ;
- },
- selectedItem: function() {
- $item.removeClass(className.selected);
- },
- value: function(removedValue, removedText, $removedItem) {
- var
- values = $input.val(),
- newValue
- ;
- if( $input.is('select') ) {
- module.verbose('Input is <select> removing selected option', removedValue);
- newValue = module.remove.arrayValue(removedValue, values);
- }
- else {
- module.verbose('Removing from delimited values', removedValue);
- values = values.split(settings.delimiter);
- newValue = module.remove.arrayValue(removedValue, values);
- newValue = newValue.join(settings.delimiter);
- }
- if(settings.fireOnInit === false && module.is.initialLoad()) {
- module.verbose('No callback on initial load', settings.onRemove);
- }
- else {
- settings.onRemove.call(element, removedValue, removedText, $removedItem);
- }
- module.set.value(newValue, removedText, $removedItem);
- module.check.maxSelections();
- },
- arrayValue: function(removedValue, values) {
- values = $.grep(values, function(value){
- return (removedValue != value);
- });
- module.verbose('Removed value from delimited string', removedValue, values);
- return values;
- },
- label: function(value) {
- var
- $labels = $module.find(selector.label),
- $removedLabel = $labels.filter('[data-value="' + value +'"]'),
- labelCount = $labels.length,
- isLastLabel = ($labels.index($removedLabel) + 1 == labelCount),
- shouldAnimate = ( (!module.is.searchSelection() || !module.is.focusedOnSearch()) && isLastLabel)
- ;
- if(shouldAnimate) {
- module.verbose('Animating and removing label', $removedLabel);
- $removedLabel
- .transition(settings.label.transition, settings.label.duration, function() {
- $removedLabel.remove();
- })
- ;
- }
- else {
- module.verbose('Removing label', $removedLabel);
- $removedLabel.remove();
- }
- },
- activeLabels: function($activeLabels) {
- $activeLabels = $activeLabels || $module.find(selector.label).filter('.' + className.active);
- module.verbose('Removing active label selections', $activeLabels);
- module.remove.labels($activeLabels);
- },
- labels: function($labels) {
- $labels = $labels || $module.find(selector.label);
- module.verbose('Removing labels', $labels);
- $labels
- .each(function(){
- var
- value = $(this).data('value'),
- isUserValue = module.is.userValue(value)
- ;
- if(isUserValue) {
- module.remove.value(value);
- module.remove.label(value);
- }
- else {
- // selected will also remove label
- module.remove.selected(value);
- }
- })
- ;
- },
- tabbable: function() {
- if( module.has.search() ) {
- module.debug('Searchable dropdown initialized');
- $search
- .attr('tabindex', '-1')
- ;
- $menu
- .attr('tabindex', '-1')
- ;
- }
- else {
- module.debug('Simple selection dropdown initialized');
- $module
- .attr('tabindex', '-1')
- ;
- $menu
- .attr('tabindex', '-1')
- ;
- }
- }
- },
-
- has: {
- search: function() {
- return ($search.length > 0);
- },
- input: function() {
- return ($input.length > 0);
- },
- menu: function() {
- return ($menu.length > 0);
- },
- message: function() {
- return ($menu.children(selector.message).length !== 0);
- },
- label: function(value) {
- var
- $labels = $module.find(selector.label)
- ;
- return ($labels.filter('[data-value="' + value +'"]').length > 0);
- },
- maxSelections: function() {
- return (settings.maxSelections && module.get.selectionCount() >= settings.maxSelections);
- },
- allResultsFiltered: function() {
- return ($item.filter(selector.unselectable).length === $item.length);
- },
- value: function(value) {
- var
- values = module.get.values(),
- hasValue = $.isArray(values)
- ? values && ($.inArray(value, values) !== -1)
- : (values == value)
- ;
- return (hasValue)
- ? true
- : false
- ;
- }
- },
-
- is: {
- active: function() {
- return $module.hasClass(className.active);
- },
- alreadySetup: function() {
- return ($module.is('select') && $module.parent(selector.dropdown).length > 0 && $module.prev().length === 0);
- },
- animating: function($subMenu) {
- return ($subMenu)
- ? $subMenu.transition && $subMenu.transition('is animating')
- : $menu.transition && $menu.transition('is animating')
- ;
- },
- focused: function() {
- return (document.activeElement === $module[0]);
- },
- focusedOnSearch: function() {
- return (document.activeElement === $search[0]);
- },
- allFiltered: function() {
- return( (module.is.multiple() || module.has.search()) && !module.has.message() && module.has.allResultsFiltered() );
- },
- hidden: function($subMenu) {
- return !module.is.visible($subMenu);
- },
- initialLoad: function() {
- return initialLoad;
- },
- onScreen: function($subMenu) {
- var
- $currentMenu = $subMenu || $menu,
- canOpenDownward = true,
- onScreen = {},
- calculations
- ;
- $currentMenu.addClass(className.loading);
- calculations = {
- context: {
- scrollTop : $context.scrollTop(),
- height : $context.outerHeight()
- },
- menu : {
- offset: $currentMenu.offset(),
- height: $currentMenu.outerHeight()
- }
- };
- onScreen = {
- above : (calculations.context.scrollTop) <= calculations.menu.offset.top - calculations.menu.height,
- below : (calculations.context.scrollTop + calculations.context.height) >= calculations.menu.offset.top + calculations.menu.height
- };
- if(onScreen.below) {
- module.verbose('Dropdown can fit in context downward', onScreen);
- canOpenDownward = true;
- }
- else if(!onScreen.below && !onScreen.above) {
- module.verbose('Dropdown cannot fit in either direction, favoring downward', onScreen);
- canOpenDownward = true;
- }
- else {
- module.verbose('Dropdown cannot fit below, opening upward', onScreen);
- canOpenDownward = false;
- }
- $currentMenu.removeClass(className.loading);
- return canOpenDownward;
- },
- inObject: function(needle, object) {
- var
- found = false
- ;
- $.each(object, function(index, property) {
- if(property == needle) {
- found = true;
- return true;
- }
- });
- return found;
- },
- multiple: function() {
- return $module.hasClass(className.multiple);
- },
- single: function() {
- return !module.is.multiple();
- },
- selectMutation: function(mutations) {
- var
- selectChanged = false
- ;
- $.each(mutations, function(index, mutation) {
- if(mutation.target && $(mutation.target).is('select')) {
- selectChanged = true;
- return true;
- }
- });
- return selectChanged;
- },
- search: function() {
- return $module.hasClass(className.search);
- },
- searchSelection: function() {
- return ( module.has.search() && $search.closest(selector.menu).length === 0 );
- },
- selection: function() {
- return $module.hasClass(className.selection);
- },
- userValue: function(value) {
- return ($.inArray(value, module.get.userValues()) !== -1);
- },
- upward: function($menu) {
- var $element = $menu || $module;
- return $element.hasClass(className.upward);
- },
- visible: function($subMenu) {
- return ($subMenu)
- ? $subMenu.hasClass(className.visible)
- : $menu.hasClass(className.visible)
- ;
- }
- },
-
- can: {
- click: function() {
- return (hasTouch || settings.on == 'click');
- },
- show: function() {
- return !$module.hasClass(className.disabled) && $item.length > 0;
- },
- useAPI: function() {
- return $.fn.api !== undefined;
- }
- },
-
- animate: {
- show: function(callback, $subMenu) {
- var
- $currentMenu = $subMenu || $menu,
- start = ($subMenu)
- ? function() {}
- : function() {
- module.hideSubMenus();
- module.hideOthers();
- module.set.active();
- },
- transition
- ;
- callback = $.isFunction(callback)
- ? callback
- : function(){}
- ;
- module.verbose('Doing menu show animation', $currentMenu);
- module.set.direction($subMenu);
- transition = module.get.transition($subMenu);
- if( module.is.selection() ) {
- module.set.scrollPosition(module.get.selectedItem(), true);
- }
- if( module.is.hidden($currentMenu) || module.is.animating($currentMenu) ) {
- if(transition == 'none') {
- start();
- $currentMenu.transition('show');
- callback.call(element);
- }
- else if($.fn.transition !== undefined && $module.transition('is supported')) {
- $currentMenu
- .transition({
- animation : transition + ' in',
- debug : settings.debug,
- verbose : settings.verbose,
- duration : settings.duration,
- queue : true,
- onStart : start,
- onComplete : function() {
- callback.call(element);
- }
- })
- ;
- }
- else {
- module.error(error.noTransition, transition);
- }
- }
- },
- hide: function(callback, $subMenu) {
- var
- $currentMenu = $subMenu || $menu,
- duration = ($subMenu)
- ? (settings.duration * 0.9)
- : settings.duration,
- start = ($subMenu)
- ? function() {}
- : function() {
- if( module.can.click() ) {
- module.unbind.intent();
- }
- module.remove.active();
- },
- transition = module.get.transition($subMenu)
- ;
- callback = $.isFunction(callback)
- ? callback
- : function(){}
- ;
- if( module.is.visible($currentMenu) || module.is.animating($currentMenu) ) {
- module.verbose('Doing menu hide animation', $currentMenu);
-
- if(transition == 'none') {
- start();
- $currentMenu.transition('hide');
- callback.call(element);
- }
- else if($.fn.transition !== undefined && $module.transition('is supported')) {
- $currentMenu
- .transition({
- animation : transition + ' out',
- duration : settings.duration,
- debug : settings.debug,
- verbose : settings.verbose,
- queue : true,
- onStart : start,
- onComplete : function() {
- if(settings.direction == 'auto') {
- module.remove.upward($subMenu);
- }
- callback.call(element);
- }
- })
- ;
- }
- else {
- module.error(error.transition);
- }
- }
- }
- },
-
- hideAndClear: function() {
- if(module.has.search()) {
- module.remove.searchTerm();
- module.hide(function() {
- module.remove.filteredItem();
- });
- }
- else {
- module.hide();
- }
- },
-
- delay: {
- show: function() {
- module.verbose('Delaying show event to ensure user intent');
- clearTimeout(module.timer);
- module.timer = setTimeout(module.show, settings.delay.show);
- },
- hide: function() {
- module.verbose('Delaying hide event to ensure user intent');
- clearTimeout(module.timer);
- module.timer = setTimeout(module.hide, settings.delay.hide);
- }
- },
-
- escape: {
- regExp: function(text) {
- text = String(text);
- return text.replace(regExp.escape, '\\$&');
- }
- },
-
- setting: function(name, value) {
- module.debug('Changing setting', name, value);
- if( $.isPlainObject(name) ) {
- $.extend(true, settings, name);
- }
- else if(value !== undefined) {
- settings[name] = value;
- }
- else {
- return settings[name];
- }
- },
- internal: function(name, value) {
- if( $.isPlainObject(name) ) {
- $.extend(true, module, name);
- }
- else if(value !== undefined) {
- module[name] = value;
- }
- else {
- return module[name];
- }
- },
- debug: function() {
- if(settings.debug) {
- if(settings.performance) {
- module.performance.log(arguments);
- }
- else {
- module.debug = Function.prototype.bind.call(console.info, console, settings.name + ':');
- module.debug.apply(console, arguments);
- }
- }
- },
- verbose: function() {
- if(settings.verbose && settings.debug) {
- if(settings.performance) {
- module.performance.log(arguments);
- }
- else {
- module.verbose = Function.prototype.bind.call(console.info, console, settings.name + ':');
- module.verbose.apply(console, arguments);
- }
- }
- },
- error: function() {
- module.error = Function.prototype.bind.call(console.error, console, settings.name + ':');
- module.error.apply(console, arguments);
- },
- performance: {
- log: function(message) {
- var
- currentTime,
- executionTime,
- previousTime
- ;
- if(settings.performance) {
- currentTime = new Date().getTime();
- previousTime = time || currentTime;
- executionTime = currentTime - previousTime;
- time = currentTime;
- performance.push({
- 'Name' : message[0],
- 'Arguments' : [].slice.call(message, 1) || '',
- 'Element' : element,
- 'Execution Time' : executionTime
- });
- }
- clearTimeout(module.performance.timer);
- module.performance.timer = setTimeout(module.performance.display, 500);
- },
- display: function() {
- var
- title = settings.name + ':',
- totalTime = 0
- ;
- time = false;
- clearTimeout(module.performance.timer);
- $.each(performance, function(index, data) {
- totalTime += data['Execution Time'];
- });
- title += ' ' + totalTime + 'ms';
- if(moduleSelector) {
- title += ' \'' + moduleSelector + '\'';
- }
- if( (console.group !== undefined || console.table !== undefined) && performance.length > 0) {
- console.groupCollapsed(title);
- if(console.table) {
- console.table(performance);
- }
- else {
- $.each(performance, function(index, data) {
- console.log(data['Name'] + ': ' + data['Execution Time']+'ms');
- });
- }
- console.groupEnd();
- }
- performance = [];
- }
- },
- invoke: function(query, passedArguments, context) {
- var
- object = instance,
- maxDepth,
- found,
- response
- ;
- passedArguments = passedArguments || queryArguments;
- context = element || context;
- if(typeof query == 'string' && object !== undefined) {
- query = query.split(/[\. ]/);
- maxDepth = query.length - 1;
- $.each(query, function(depth, value) {
- var camelCaseValue = (depth != maxDepth)
- ? value + query[depth + 1].charAt(0).toUpperCase() + query[depth + 1].slice(1)
- : query
- ;
- if( $.isPlainObject( object[camelCaseValue] ) && (depth != maxDepth) ) {
- object = object[camelCaseValue];
- }
- else if( object[camelCaseValue] !== undefined ) {
- found = object[camelCaseValue];
- return false;
- }
- else if( $.isPlainObject( object[value] ) && (depth != maxDepth) ) {
- object = object[value];
- }
- else if( object[value] !== undefined ) {
- found = object[value];
- return false;
- }
- else {
- module.error(error.method, query);
- return false;
- }
- });
- }
- if ( $.isFunction( found ) ) {
- response = found.apply(context, passedArguments);
- }
- else if(found !== undefined) {
- response = found;
- }
- if($.isArray(returnedValue)) {
- returnedValue.push(response);
- }
- else if(returnedValue !== undefined) {
- returnedValue = [returnedValue, response];
- }
- else if(response !== undefined) {
- returnedValue = response;
- }
- return found;
- }
- };
-
- if(methodInvoked) {
- if(instance === undefined) {
- module.initialize();
- }
- module.invoke(query);
- }
- else {
- if(instance !== undefined) {
- instance.invoke('destroy');
- }
- module.initialize();
- }
- })
- ;
- return (returnedValue !== undefined)
- ? returnedValue
- : $allModules
- ;
- };
-
- $.fn.dropdown.settings = {
-
- debug : false,
- verbose : false,
- performance : true,
-
- on : 'click', // what event should show menu action on item selection
- action : 'activate', // action on item selection (nothing, activate, select, combo, hide, function(){})
-
-
- apiSettings : false,
- saveRemoteData : true, // Whether remote name/value pairs should be stored in sessionStorage to allow remote data to be restored on page refresh
- throttle : 200, // How long to wait after last user input to search remotely
-
- context : window, // Context to use when determining if on screen
- direction : 'auto', // Whether dropdown should always open in one direction
- keepOnScreen : true, // Whether dropdown should check whether it is on screen before showing
-
- match : 'both', // what to match against with search selection (both, text, or label)
- fullTextSearch : false, // search anywhere in value
-
- placeholder : 'auto', // whether to convert blank <select> values to placeholder text
- preserveHTML : true, // preserve html when selecting value
- sortSelect : false, // sort selection on init
-
- forceSelection : true, // force a choice on blur with search selection
- allowAdditions : false, // whether multiple select should allow user added values
-
- maxSelections : false, // When set to a number limits the number of selections to this count
- useLabels : true, // whether multiple select should filter currently active selections from choices
- delimiter : ',', // when multiselect uses normal <input> the values will be delmited with this character
-
- showOnFocus : true, // show menu on focus
- allowTab : true, // add tabindex to element
- allowCategorySelection : false, // allow elements with sub-menus to be selected
-
- fireOnInit : false, // Whether callbacks should fire when initializing dropdown values
-
- transition : 'auto', // auto transition will slide down or up based on direction
- duration : 200, // duration of transition
-
- glyphWidth : 1.0714, // widest glyph width in em (W is 1.0714 em) used to calculate multiselect input width
-
- // label settings on multi-select
- label: {
- transition : 'scale',
- duration : 200,
- variation : false
- },
-
- // delay before event
- delay : {
- hide : 300,
- show : 200,
- search : 20,
- touch : 50
- },
-
- /* Callbacks */
- onChange : function(value, text, $selected){},
- onAdd : function(value, text, $selected){},
- onRemove : function(value, text, $selected){},
-
- onLabelSelect : function($selectedLabels){},
- onLabelCreate : function(value, text) { return $(this); },
- onNoResults : function(searchTerm) { return true; },
- onShow : function(){},
- onHide : function(){},
-
- /* Component */
- name : 'Dropdown',
- namespace : 'dropdown',
-
- message: {
- addResult : 'Add <b>{term}</b>',
- count : '{count} selected',
- maxSelections : 'Max {maxCount} selections',
- noResults : 'No results found.',
- serverError : 'There was an error contacting the server'
- },
-
- error : {
- action : 'You called a dropdown action that was not defined',
- alreadySetup : 'Once a select has been initialized behaviors must be called on the created ui dropdown',
- labels : 'Allowing user additions currently requires the use of labels.',
- method : 'The method you called is not defined.',
- noAPI : 'The API module is required to load resources remotely',
- noStorage : 'Saving remote data requires session storage',
- noTransition : 'This module requires ui transitions <https://github.com/Semantic-Org/UI-Transition>'
- },
-
- regExp : {
- escape : /[-[\]{}()*+?.,\\^$|#\s]/g,
- },
-
- metadata : {
- defaultText : 'defaultText',
- defaultValue : 'defaultValue',
- placeholderText : 'placeholder',
- text : 'text',
- value : 'value'
- },
-
- selector : {
- addition : '.addition',
- dropdown : '.ui.dropdown',
- icon : '> .dropdown.icon',
- input : '> input[type="hidden"], > select',
- item : '.item',
- label : '> .label',
- remove : '> .label > .delete.icon',
- siblingLabel : '.label',
- menu : '.menu',
- message : '.message',
- menuIcon : '.dropdown.icon',
- search : 'input.search, .menu > .search > input',
- text : '> .text:not(.icon)',
- unselectable : '.disabled, .filtered'
- },
-
- className : {
- active : 'active',
- addition : 'addition',
- animating : 'animating',
- disabled : 'disabled',
- dropdown : 'ui dropdown',
- filtered : 'filtered',
- hidden : 'hidden transition',
- item : 'item',
- label : 'ui label',
- loading : 'loading',
- menu : 'menu',
- message : 'message',
- multiple : 'multiple',
- placeholder : 'default',
- search : 'search',
- selected : 'selected',
- selection : 'selection',
- upward : 'upward',
- visible : 'visible'
- }
-
- };
-
- /* Templates */
- $.fn.dropdown.settings.templates = {
-
- // generates dropdown from select values
- dropdown: function(select) {
- var
- placeholder = select.placeholder || false,
- values = select.values || {},
- html = ''
- ;
- html += '<i class="dropdown icon"></i>';
- if(select.placeholder) {
- html += '<div class="default text">' + placeholder + '</div>';
- }
- else {
- html += '<div class="text"></div>';
- }
- html += '<div class="menu">';
- $.each(select.values, function(index, option) {
- html += (option.disabled)
- ? '<div class="disabled item" data-value="' + option.value + '">' + option.name + '</div>'
- : '<div class="item" data-value="' + option.value + '">' + option.name + '</div>'
- ;
- });
- html += '</div>';
- return html;
- },
-
- // generates just menu from select
- menu: function(response) {
- var
- values = response.values || {},
- html = ''
- ;
- $.each(response.values, function(index, option) {
- html += '<div class="item" data-value="' + option.value + '">' + option.name + '</div>';
- });
- return html;
- },
-
- // generates label for multiselect
- label: function(value, text) {
- return text + '<i class="delete icon"></i>';
- },
-
-
- // generates messages like "No results"
- message: function(message) {
- return message;
- },
-
- // generates user addition to selection menu
- addition: function(choice) {
- return choice;
- }
-
- };
-
- })( jQuery, window , document );
|