|
|
/* * # Semantic - Dropdown * http://github.com/semantic-org/semantic-ui/
* * * Copyright 2014 Contributor * 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() { var settings = ( $.isPlainObject(parameters) ) ? $.extend(true, {}, $.fn.dropdown.settings, parameters) : $.extend({}, $.fn.dropdown.settings),
className = settings.className, metadata = settings.metadata, namespace = settings.namespace, selector = settings.selector, error = settings.error,
eventNamespace = '.' + namespace, moduleNamespace = 'module-' + namespace,
$module = $(this), $text = $module.find(selector.text), $search = $module.find(selector.search), $input = $module.find(selector.input),
$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),
elementNamespace, id, observer, module ;
module = {
initialize: function() { module.debug('Initializing dropdown', settings);
if( module.is.alreadySetup() ) { module.error(error.alreadySetup); } else { module.setup.layout(); }
module.save.defaults(); module.set.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 for', $module); module.remove.tabbable(); $module .off(eventNamespace) .removeData(moduleNamespace) ; $menu .off(eventNamespace) ; $document .off(elementNamespace) ; },
observeChanges: function() { if('MutationObserver' in window) { observer = new MutationObserver(function(mutations) { if( module.is.selectMutation(mutations) ) { module.debug('<select> modified, recreating menu'); module.setup.select(); } else { module.debug('DOM tree modified, updating selector cache'); module.refresh(); } }); observer.observe(element, { childList : true, subtree : true }); module.debug('Setting up mutation observer', observer); } },
create: { id: function() { module.verbose('Creating unique id for element'); id = module.get.uniqueID(); elementNamespace = '.' + id; } },
search: function() { var query ; query = $search.val();
module.verbose('Searching for query', query); module.filter(query); if(module.is.searchSelection() && module.can.show() ) { module.show(); } },
setup: {
layout: function() { if( $module.is('select') ) { module.setup.select(); } if( module.is.search() && !module.is.searchable() ) { $search = $('<input />') .addClass(className.search) .insertBefore($text) ; } if(settings.allowTab) { module.set.tabbable(); } }, 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); if($menu.length === 0) { $menu = $('<div />') .addClass(className.menu) .appendTo($module) ; } $menu.html( settings.templates.menu( selectValues )); } else { module.debug('Creating entire dropdown from select'); $module = $('<div />') .attr('class', $input.attr('class') ) .addClass(className.selection) .addClass(className.dropdown) .html( settings.templates.dropdown(selectValues) ) .insertBefore($input) ; $input .removeAttr('class') .prependTo($module) ; } module.refresh(); } },
refresh: function() { module.verbose('Refreshing selector cache'); $text = $module.find(selector.text); $search = $module.find(selector.search); $input = $module.find(selector.input); $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); },
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.is.searchSelection() && module.is.allFiltered() ) { return; } if( module.can.show() && !module.is.active() ) { module.debug('Showing dropdown'); 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 + ':visible:not(.' + className.animating + ')') .dropdown('hide') ; },
hideSubMenus: function() { var $subMenus = $menu.find(selector.menu) ; $subMenus.transition('hide'); },
bind: { keyboardEvents: function() { module.debug('Binding keyboard events'); $module .on('keydown' + eventNamespace, module.event.keydown) ; if( module.is.searchable() ) { $module .on(module.get.inputEvent(), selector.search, module.event.input) ; } }, 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.verbose('Mouse detected binding mouse events'); if( module.is.searchSelection() ) { $module .on('mousedown' + eventNamespace, selector.menu, module.event.menu.activate) .on('mouseup' + eventNamespace, selector.menu, module.event.menu.deactivate) .on('click' + eventNamespace, selector.search, module.show) .on('focus' + eventNamespace, selector.search, module.event.searchFocus) .on('blur' + eventNamespace, selector.search, module.event.searchBlur) .on('click' + eventNamespace, selector.text, module.event.searchTextFocus) ; } 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(searchTerm) { var $results = $(), escapedTerm = module.escape.regExp(searchTerm), exactRegExp = new RegExp('^' + escapedTerm, 'igm'), fullTextRegExp = new RegExp(escapedTerm, 'ig'), allItemsFiltered ; module.verbose('Searching for matching values'); $item .each(function(){ var $choice = $(this), text = String(module.get.choiceText($choice, false)), value = String(module.get.choiceValue($choice, text)) ; if( text.match(exactRegExp) || value.match(exactRegExp) ) { $results = $results.add($choice); } else if(settings.fullTextSearch) { if( text.match(fullTextRegExp) || value.match(fullTextRegExp) ) { $results = $results.add($choice); } } }) ;
module.debug('Setting filter', searchTerm); module.remove.filteredItem(); $item .not($results) .addClass(className.filtered) ;
module.verbose('Selecting first non-filtered element'); module.remove.selectedItem(); $item .not('.' + className.filtered) .eq(0) .addClass(className.selected) ; if( module.is.allFiltered() ) { module.debug('All items filtered, hiding dropdown', searchTerm); if(module.is.searchSelection()) { module.hide(); } settings.onNoResults.call(element, searchTerm); } },
focusSearch: function() { if( module.is.search() ) { $search .focus() ; } },
event: { // prevents focus callback from occuring on mousedown
mousedown: function() { activated = true; }, mouseup: function() { activated = false; }, focus: function() { if(!activated && module.is.hidden()) { module.show(); } }, blur: function(event) { var pageLostFocus = (document.activeElement === this) ; if(!activated && !pageLostFocus) { module.hide(); } }, searchFocus: function() { activated = true; module.show(); }, searchBlur: function(event) { var pageLostFocus = (document.activeElement === this) ; if(!itemActivated && !pageLostFocus) { module.hide(); } }, searchTextFocus: function(event) { activated = true; $search.focus(); }, input: function(event) { if(module.is.searchSelection()) { module.set.filtered(); } clearTimeout(module.timer); module.timer = setTimeout(module.search, settings.delay.search); }, keydown: function(event) { var $currentlySelected = $item.not(className.filtered).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), isSubMenuItem = $parentMenu[0] !== $menu[0], inVisibleMenu = $parentMenu.is(':visible'), pressedKey = event.which, keys = { enter : 13, escape : 27, leftArrow : 37, upArrow : 38, rightArrow : 39, downArrow : 40 }, hasSubMenu = ($subMenu.length> 0), hasSelectedItem = ($selectedItem.length > 0), lastVisibleIndex = ($visibleItems.size() - 1), $nextItem, newIndex ; // visible menu keyboard shortcuts
if(module.is.visible()) { // enter (select or sub-menu)
if(pressedKey == keys.enter && hasSelectedItem) { if(hasSubMenu && !settings.allowCategorySelection) { module.verbose('Pressed enter on unselectable category, opening sub menu'); pressedKey = keys.rightArrow; } else { module.verbose('Enter key pressed, choosing selected item'); module.event.item.click.call($selectedItem, event); } } // left arrow (hide sub-menu)
if(pressedKey == keys.leftArrow) { 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(.' + className.filtered + ')').eq(0) : $item.eq(0) ; if($visibleItems.index( $nextItem ) < 0) { module.verbose('Up key pressed but reached top of current menu'); 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(.' + className.filtered + ')').eq(0) : $item.eq(0) ; if($nextItem.length === 0) { module.verbose('Down key pressed but reached bottom of current menu'); return; } else { module.verbose('Down key pressed, changing active item'); $item .removeClass(className.selected) ; $nextItem .addClass(className.selected) ; module.set.scrollPosition($nextItem); } event.preventDefault(); } } else { // enter (open menu)
if(pressedKey == keys.enter) { module.verbose('Enter key pressed, showing dropdown'); module.show(); } // escape (close menu)
if(pressedKey == keys.escape) { module.verbose('Escape key pressed, closing dropdown'); module.hide(); } // down arrow (open menu)
if(pressedKey == keys.downArrow) { module.verbose('Down key pressed, showing dropdown'); module.show(); } } }, test: { toggle: function(event) { if( module.determine.eventInMenu(event, module.toggle) ) { event.preventDefault(); } }, touch: function(event) { module.determine.eventInMenu(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: { activate: function() { itemActivated = true; }, deactivate: 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.target), $subMenu = $choice.find(selector.menu), text = module.get.choiceText($choice), value = module.get.choiceValue($choice, text), callback = function() { module.remove.searchTerm(); module.determine.selectAction(text, value); }, hasSubMenu = ($subMenu.length > 0), isBubbledEvent = ($subMenu.find($target).length > 0) ; if(!isBubbledEvent && (!hasSubMenu || settings.allowCategorySelection)) { callback(); } } }, resetStyle: function() { $(this).removeAttr('style'); } },
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 ](text, value); } else if( $.isFunction(settings.action) ) { module.verbose('Triggering user action', settings.action, text, value); settings.action(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; } }, eventInMenu: function(event, callback) { callback = $.isFunction(callback) ? callback : function(){} ; if( $(event.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); module.hide(function() { module.remove.filteredItem(); }); },
select: function(text, value) { value = (value !== undefined) ? value : text ; module.set.selected(value); module.hide(function() { module.remove.filteredItem(); }); },
combo: function(text, value) { value = (value !== undefined) ? value : text ; module.set.selected(value); module.hide(function() { module.remove.filteredItem(); }); },
hide: function() { module.hide(function() { module.remove.filteredItem(); }); }
},
get: { text: function() { return $text.text(); }, value: function() { return ($input.length > 0) ? $input.val() : $module.data(metadata.value) ; }, choiceText: function($choice, preserveHTML) { preserveHTML = (preserveHTML !== undefined) ? preserveHTML : settings.preserveHTML ; if($choice !== undefined) { 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); return ($choice.data(metadata.value) !== undefined) ? $choice.data(metadata.value) : (typeof choiceText === 'string') ? choiceText.toLowerCase().trim() : choiceText.trim() ; }, 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 = (settings.sortSelect) ? {} // properties will be sorted in object when re-accessed
: [] // properties will keep original order in array
; $module .find('option') .each(function() { var name = $(this).html(), value = ( $(this).attr('value') !== undefined ) ? $(this).attr('value') : name ; if(value === '') { select.placeholder = name; } else { if(settings.sortSelect) { select.values[value] = { name : name, value : value }; } else { select.values.push({ name: name, value: value }); } } }) ; if(settings.sortSelect) { 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); }, item: function(value, strict) { var $selectedItem = false ; value = (value !== undefined) ? value : ( module.get.value() !== undefined) ? module.get.value() : module.get.text() ; strict = (value === '' || value === 0) ? true : strict || false ; if(value !== undefined) { $item .each(function() { var $choice = $(this), optionText = module.get.choiceText($choice), optionValue = module.get.choiceValue($choice, optionText) ; if(strict) { module.verbose('Ambiguous dropdown value using strict type check', $choice, value); if( optionValue === value ) { $selectedItem = $(this); } else if( !$selectedItem && optionText === value ) { $selectedItem = $(this); } } else { if( optionValue == value ) { module.verbose('Found select item by value', optionValue, value); $selectedItem = $(this); } else if( !$selectedItem && optionText == value ) { module.verbose('Found select item by text', optionText, value); $selectedItem = $(this); } } }) ; } else { value = module.get.text(); } return $selectedItem || false; }, uniqueID: function() { return (Math.random().toString(16) + '000000000').substr(2,8); } },
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.length) { module.set.selected(defaultValue); } else { module.remove.activeItem(); module.remove.selectedItem(); } } } },
save: { defaults: function() { module.save.defaultText(); module.save.placeholderText(); module.save.defaultValue(); }, defaultValue: function() { $module.data(metadata.defaultValue, module.get.value() ); }, defaultText: function() { $module.data(metadata.defaultText, $text.text() ); }, placeholderText: function() { if($text.hasClass(className.placeholder)) { $module.data(metadata.placeholderText, $text.text()); } } },
clear: function() { var placeholderText = $module.data(metadata.placeholderText) ; module.set.text(placeholderText); module.set.value(''); module.remove.activeItem(); module.remove.selectedItem(); $text.addClass(className.placeholder); },
set: { filtered: function() { var searchValue = $search.val(), hasSearchValue = (typeof searchValue === 'string' && searchValue.length > 0) ; if(hasSearchValue) { $text.addClass(className.filtered); } else { $text.removeClass(className.filtered); } }, tabbable: function() { if( module.is.searchable() ) { module.debug('Searchable dropdown initialized'); $search .val('') .attr('tabindex', 0) ; $menu .attr('tabindex', '-1') ; } else { module.debug('Simple selection dropdown initialized'); if(!$module.attr('tabindex') ) { $module .attr('tabindex', 0) ; $menu .attr('tabindex', '-1') ; } } }, scrollPosition: function($item, forceScroll) { var edgeTolerance = 5, hasActive, offset, itemHeight, itemOffset, menuOffset, menuScroll, menuHeight, abovePage, belowPage ;
$item = $item || module.get.activeItem(); hasActive = ($item && $item.length > 0); forceScroll = (forceScroll !== undefined) ? forceScroll : false ;
if($item && hasActive) {
if(!$menu.hasClass(className.visible)) { $menu.addClass(className.loading); }
menuHeight = $menu.height(); itemHeight = $item.height(); menuScroll = $menu.scrollTop(); menuOffset = $menu.offset().top; itemOffset = $item.offset().top; offset = menuScroll - menuOffset + itemOffset; belowPage = menuScroll + menuHeight < (offset + edgeTolerance); abovePage = ((offset - edgeTolerance) < menuScroll); module.debug('Scrolling to active item', offset); if(abovePage || belowPage || forceScroll) { $menu .scrollTop(offset) .removeClass(className.loading) ; } } }, text: function(text) { if(settings.action == 'combo') { module.debug('Changing combo button text', text, $combo); if(settings.preserveHTML) { $combo.html(text); } else { $combo.text(text); } } else if(settings.action !== 'select') { module.debug('Changing text', text, $text); $text .removeClass(className.filtered) .removeClass(className.placeholder) ; if(settings.preserveHTML) { $text.html(text); } else { $text.text(text); } } }, value: function(value) { module.debug('Adding selected value to hidden input', value, $input); if($input.length > 0) { $input .val(value) .trigger('change') ; } else { $module.data(metadata.value, value); } }, active: function() { $module .addClass(className.active) ; }, visible: function() { $module.addClass(className.visible); }, selected: function(value) { var $selectedItem = module.get.item(value), selectedText, selectedValue ; if($selectedItem) { module.debug('Setting selected menu item to', $selectedItem); module.remove.activeItem(); module.remove.selectedItem(); $selectedItem .addClass(className.active) .addClass(className.selected) ; selectedText = module.get.choiceText($selectedItem); selectedValue = module.get.choiceValue($selectedItem, selectedText); module.set.text(selectedText); module.set.value(selectedValue); settings.onChange.call(element, value, selectedText, $selectedItem); } } },
remove: { active: function() { $module.removeClass(className.active); }, visible: function() { $module.removeClass(className.visible); }, activeItem: function() { $item.removeClass(className.active); }, filteredItem: function() { $item.removeClass(className.filtered); }, searchTerm: function() { $search.val(''); }, selectedItem: function() { $item.removeClass(className.selected); }, tabbable: function() { if( module.is.searchable() ) { 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') ; } } },
is: { active: function() { return $module.hasClass(className.active); }, alreadySetup: function() { return ($module.is('select') && $module.parent(selector.dropdown).length > 0); }, animating: function($subMenu) { return ($subMenu) ? $subMenu.is(':animated') || $subMenu.transition && $subMenu.transition('is animating') : $menu.is(':animated') || $menu.transition && $menu.transition('is animating') ; }, allFiltered: function() { return ($item.filter('.' + className.filtered).length === $item.length); }, hidden: function($subMenu) { return ($subMenu) ? $subMenu.is(':hidden') : $menu.is(':hidden') ; }, 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); }, searchable: function() { return ($search.length > 0); }, searchSelection: function() { return ( module.is.searchable() && $search.parent().is($module) ); }, selection: function() { return $module.hasClass(className.selection); }, upward: function() { return $module.hasClass(className.upward); }, visible: function($subMenu) { return ($subMenu) ? $subMenu.is(':visible') : $menu.is(':visible') ; } },
can: { click: function() { return (hasTouch || settings.on == 'click'); }, show: function() { return !$module.hasClass(className.disabled); } },
animate: { show: function(callback, $subMenu) { var $currentMenu = $subMenu || $menu, start = ($subMenu) ? function() {} : function() { module.hideSubMenus(); module.hideOthers(); module.set.active(); } ; callback = $.isFunction(callback) ? callback : function(){} ; module.set.scrollPosition(module.get.activeItem(), true); module.verbose('Doing menu show animation', $currentMenu); if( module.is.hidden($currentMenu) || module.is.animating($currentMenu) ) {
if(settings.transition == 'auto') { settings.transition = module.is.upward() ? 'slide up' : 'slide down' ; module.verbose('Automatically determining animation based on animation direction', settings.transition); } if(settings.transition == 'none') { callback.call(element); } else if($.fn.transition !== undefined && $module.transition('is supported')) { $currentMenu .transition({ animation : settings.transition + ' in', debug : settings.debug, verbose : settings.verbose, duration : settings.duration, queue : true, onStart : start, onComplete : function() { callback.call(element); } }) ; } else if(settings.transition == 'slide down') { start(); $currentMenu .hide() .clearQueue() .children() .clearQueue() .css('opacity', 0) .delay(50) .animate({ opacity : 1 }, settings.duration, 'easeOutQuad', module.event.resetStyle) .end() .slideDown(100, 'easeOutQuad', function() { module.event.resetStyle.call(this); callback.call(element); }) ; } else if(settings.transition == 'fade') { start(); $currentMenu .hide() .clearQueue() .fadeIn(settings.duration, function() { module.event.resetStyle.call(this); callback.call(element); }) ; } else { module.error(error.transition, settings.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.focusSearch(); module.remove.active(); } ; callback = $.isFunction(callback) ? callback : function(){} ; if( module.is.visible($currentMenu) || module.is.animating($currentMenu) ) { module.verbose('Doing menu hide animation', $currentMenu);
if(settings.transition == 'auto') { settings.transition = module.is.upward() ? 'slide up' : 'slide down' ; }
if(settings.transition == 'none') { callback.call(element); } else if($.fn.transition !== undefined && $module.transition('is supported')) { $currentMenu .transition({ animation : settings.transition + ' out', duration : settings.duration, debug : settings.debug, verbose : settings.verbose, queue : true, onStart : start, onComplete : function() { callback.call(element); } }) ; } else if(settings.transition == 'slide down') { start(); $currentMenu .show() .clearQueue() .children() .clearQueue() .css('opacity', 1) .animate({ opacity : 0 }, 100, 'easeOutQuad', module.event.resetStyle) .end() .delay(50) .slideUp(100, 'easeOutQuad', function() { module.event.resetStyle.call(this); callback.call(element); }) ; } else if(settings.transition == 'fade') { start(); $currentMenu .show() .clearQueue() .fadeOut(150, function() { module.event.resetStyle.call(this); callback.call(element); }) ; } else { module.error(error.transition); } } } },
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(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&'); } },
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, 100); }, 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) { module.destroy(); } module.initialize(); } }) ;
return (returnedValue !== undefined) ? returnedValue : this ; };
$.fn.dropdown.settings = {
debug : false, verbose : true, performance : true,
on : 'click', action : 'activate',
allowTab : true, fullTextSearch : false, preserveHTML : true, sortSelect : false,
allowCategorySelection : false,
delay : { hide : 300, show : 200, search : 50, touch : 50 },
transition : 'auto', duration : 250,
/* Callbacks */ onNoResults : function(searchTerm){}, onChange : function(value, text){}, onShow : function(){}, onHide : function(){},
/* Component */
name : 'Dropdown', namespace : 'dropdown',
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', method : 'The method you called is not defined.', transition : 'The requested transition was not found' },
metadata: { defaultText : 'defaultText', defaultValue : 'defaultValue', placeholderText : 'placeholderText', text : 'text', value : 'value' },
selector : { dropdown : '.ui.dropdown', input : '> input[type="hidden"], > select', item : '.item', menu : '.menu', menuIcon : '.dropdown.icon', search : '> input.search, .menu > .search > input, .menu > input.search', text : '> .text:not(.icon)' },
className : { active : 'active', animating : 'animating', disabled : 'disabled', dropdown : 'ui dropdown', filtered : 'filtered', loading : 'loading', menu : 'menu', placeholder : 'default', search : 'search', selected : 'selected', selection : 'selection', upward : 'upward', visible : 'visible' }
};
/* Templates */ $.fn.dropdown.settings.templates = { menu: function(select) { var placeholder = select.placeholder || false, values = select.values || {}, html = '' ; $.each(select.values, function(index, option) { html += '<div class="item" data-value="' + option.value + '">' + option.name + '</div>'; }); return html; }, 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 += '<div class="item" data-value="' + option.value + '">' + option.name + '</div>'; }); html += '</div>'; return html; } };
/* Dependencies */ $.extend( $.easing, { easeOutQuad: function (x, t, b, c, d) { return -c *(t/=d)*(t-2) + b; }, });
})( jQuery, window , document );
|