123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659 |
- /*
- * jQuery MultiSelect UI Widget 1.11
- * Copyright (c) 2011 Eric Hynds
- *
- * http://www.erichynds.com/jquery/jquery-ui-multiselect-widget/
- *
- * Depends:
- * - jQuery 1.4.2+
- * - jQuery UI 1.8 widget factory
- *
- * Optional:
- * - jQuery UI effects
- * - jQuery UI position utility
- *
- * Dual licensed under the MIT and GPL licenses:
- * http://www.opensource.org/licenses/mit-license.php
- * http://www.gnu.org/licenses/gpl.html
- *
- */
- (function($, undefined){
- var multiselectID = 0;
- $.widget("ech.multiselect", {
- // default options
- options: {
- header: true,
- height: 175,
- minWidth: 225,
- classes: '',
- checkAllText: 'Check all',
- uncheckAllText: 'Uncheck all',
- noneSelectedText: 'Select options',
- selectedText: '# selected',
- selectedList: 0,
- show: '',
- hide: '',
- autoOpen: false,
- multiple: true,
- position: {}
- },
- _create: function(){
- var el = this.element.hide(),
- o = this.options;
- this.speed = $.fx.speeds._default; // default speed for effects
- this._isOpen = false; // assume no
- var
- button = (this.button = $('<button type="button"><span class="ui-icon ui-icon-triangle-2-n-s"></span></button>'))
- .addClass('ui-multiselect ui-widget ui-state-default ui-corner-all')
- .addClass( o.classes )
- .attr({ 'title':el.attr('title'), 'aria-haspopup':true, 'tabIndex':el.attr('tabIndex') })
- .insertAfter( el ),
- buttonlabel = (this.buttonlabel = $('<span />'))
- .html( o.noneSelectedText )
- .appendTo( button ),
- menu = (this.menu = $('<div />'))
- .addClass('ui-multiselect-menu ui-widget ui-widget-content ui-corner-all')
- .addClass( o.classes )
- .insertAfter( button ),
- header = (this.header = $('<div />'))
- .addClass('ui-widget-header ui-corner-all ui-multiselect-header ui-helper-clearfix')
- .appendTo( menu ),
- headerLinkContainer = (this.headerLinkContainer = $('<ul />'))
- .addClass('ui-helper-reset')
- .html(function(){
- if( o.header === true ){
- return '<li><a class="ui-multiselect-all" href="#"><span class="ui-icon ui-icon-check"></span><span>' + o.checkAllText + '</span></a></li><li><a class="ui-multiselect-none" href="#"><span class="ui-icon ui-icon-closethick"></span><span>' + o.uncheckAllText + '</span></a></li>';
- } else if(typeof o.header === "string"){
- return '<li>' + o.header + '</li>';
- } else {
- return '';
- }
- })
- .append('<li class="ui-multiselect-close"><a href="#" class="ui-multiselect-close"><span class="ui-icon ui-icon-circle-close"></span></a></li>')
- .appendTo( header ),
- checkboxContainer = (this.checkboxContainer = $('<ul />'))
- .addClass('ui-multiselect-checkboxes ui-helper-reset')
- .appendTo( menu );
- // perform event bindings
- this._bindEvents();
- // build menu
- this.refresh( true );
- // some addl. logic for single selects
- if( !o.multiple ){
- menu.addClass('ui-multiselect-single');
- }
- },
- _init: function(){
- if( this.options.header === false ){
- this.header.hide();
- }
- if( !this.options.multiple ){
- this.headerLinkContainer.find('.ui-multiselect-all, .ui-multiselect-none').hide();
- }
- if( this.options.autoOpen ){
- this.open();
- }
- if( this.element.is(':disabled') ){
- this.disable();
- }
- },
- refresh: function( init ){
- var el = this.element,
- o = this.options,
- menu = this.menu,
- checkboxContainer = this.checkboxContainer,
- optgroups = [],
- html = [],
- id = el.attr('id') || multiselectID++; // unique ID for the label & option tags
- // build items
- this.element.find('option').each(function( i ){
- var $this = $(this),
- parent = this.parentNode,
- title = this.innerHTML,
- description = this.title,
- value = this.value,
- inputID = this.id || 'ui-multiselect-'+id+'-option-'+i,
- isDisabled = this.disabled,
- isSelected = this.selected,
- labelClasses = ['ui-corner-all'],
- optLabel;
- // is this an optgroup?
- if( parent.tagName.toLowerCase() === 'optgroup' ){
- optLabel = parent.getAttribute('label');
- // has this optgroup been added already?
- if( $.inArray(optLabel, optgroups) === -1 ){
- html.push('<li class="ui-multiselect-optgroup-label"><a href="#">' + optLabel + '</a></li>');
- optgroups.push( optLabel );
- }
- }
- if( isDisabled ){
- labelClasses.push('ui-state-disabled');
- }
- // browsers automatically select the first option
- // by default with single selects
- if( isSelected && !o.multiple ){
- labelClasses.push('ui-state-active');
- }
- html.push('<li class="' + (isDisabled ? 'ui-multiselect-disabled' : '') + '">');
- // create the label
- html.push('<label for="'+inputID+'" title="'+description+'" class="'+labelClasses.join(' ')+ '">');
- html.push('<input id="'+inputID+'" name="multiselect_'+id+'" type="'+(o.multiple ? "checkbox" : "radio")+'" value="'+value+'" title="'+title+'"');
- // pre-selected?
- if( isSelected ){
- html.push(' checked="checked"');
- html.push(' aria-selected="true"');
- }
- // disabled?
- if( isDisabled ){
- html.push(' disabled="disabled"');
- html.push(' aria-disabled="true"');
- }
- // add the title and close everything off
- html.push(' /><span>' + title + '</span></label></li>');
- });
- // insert into the DOM
- checkboxContainer.html( html.join('') );
- // cache some moar useful elements
- this.labels = menu.find('label');
- // set widths
- this._setButtonWidth();
- this._setMenuWidth();
- // remember default value
- this.button[0].defaultValue = this.update();
- // broadcast refresh event; useful for widgets
- if( !init ){
- this._trigger('refresh');
- }
- },
- // updates the button text. call refresh() to rebuild
- update: function(){
- var o = this.options,
- $inputs = this.labels.find('input'),
- $checked = $inputs.filter(':checked'),
- numChecked = $checked.length,
- value;
- if( numChecked === 0 ){
- value = o.noneSelectedText;
- } else {
- if($.isFunction( o.selectedText )){
- value = o.selectedText.call(this, numChecked, $inputs.length, $checked.get());
- } else if( /\d/.test(o.selectedList) && o.selectedList > 0 && numChecked <= o.selectedList){
- value = $checked.map(function(){ return this.title; }).get().join(', ');
- } else {
- value = o.selectedText.replace('#', numChecked).replace('#', $inputs.length);
- }
- }
- this.buttonlabel.html( value );
- return value;
- },
- // binds events
- _bindEvents: function(){
- var self = this, button = this.button;
- function clickHandler(){
- self[ self._isOpen ? 'close' : 'open' ]();
- return false;
- }
- // webkit doesn't like it when you click on the span :(
- button
- .find('span')
- .bind('click.multiselect', clickHandler);
- // button events
- button.bind({
- click: clickHandler,
- keypress: function( e ){
- switch(e.which){
- case 27: // esc
- case 38: // up
- case 37: // left
- self.close();
- break;
- case 39: // right
- case 40: // down
- self.open();
- break;
- }
- },
- mouseenter: function(){
- if( !button.hasClass('ui-state-disabled') ){
- $(this).addClass('ui-state-hover');
- }
- },
- mouseleave: function(){
- $(this).removeClass('ui-state-hover');
- },
- focus: function(){
- if( !button.hasClass('ui-state-disabled') ){
- $(this).addClass('ui-state-focus');
- }
- },
- blur: function(){
- $(this).removeClass('ui-state-focus');
- }
- });
- // header links
- this.header
- .delegate('a', 'click.multiselect', function( e ){
- // close link
- if( $(this).hasClass('ui-multiselect-close') ){
- self.close();
- // check all / uncheck all
- } else {
- self[ $(this).hasClass('ui-multiselect-all') ? 'checkAll' : 'uncheckAll' ]();
- }
- e.preventDefault();
- });
- // optgroup label toggle support
- this.menu
- .delegate('li.ui-multiselect-optgroup-label a', 'click.multiselect', function( e ){
- e.preventDefault();
- var $this = $(this),
- $inputs = $this.parent().nextUntil('li.ui-multiselect-optgroup-label').find('input:visible:not(:disabled)'),
- nodes = $inputs.get(),
- label = $this.parent().text();
- // trigger event and bail if the return is false
- if( self._trigger('beforeoptgrouptoggle', e, { inputs:nodes, label:label }) === false ){
- return;
- }
- // toggle inputs
- self._toggleChecked(
- $inputs.filter(':checked').length !== $inputs.length,
- $inputs
- );
- self._trigger('optgrouptoggle', e, {
- inputs: nodes,
- label: label,
- checked: nodes[0].checked
- });
- })
- .delegate('label', 'mouseenter.multiselect', function(){
- if( !$(this).hasClass('ui-state-disabled') ){
- self.labels.removeClass('ui-state-hover');
- $(this).addClass('ui-state-hover').find('input').focus();
- }
- })
- .delegate('label', 'keydown.multiselect', function( e ){
- e.preventDefault();
- switch(e.which){
- case 9: // tab
- case 27: // esc
- self.close();
- break;
- case 38: // up
- case 40: // down
- case 37: // left
- case 39: // right
- self._traverse(e.which, this);
- break;
- case 13: // enter
- $(this).find('input')[0].click();
- break;
- }
- })
- .delegate('input[type="checkbox"], input[type="radio"]', 'click.multiselect', function( e ){
- var $this = $(this),
- val = this.value,
- checked = this.checked,
- tags = self.element.find('option');
- // bail if this input is disabled or the event is cancelled
- if( this.disabled || self._trigger('click', e, { value:val, text:this.title, checked:checked }) === false ){
- e.preventDefault();
- return;
- }
- // toggle aria state
- $this.attr('aria-selected', checked);
- // change state on the original option tags
- tags.each(function(){
- if( this.value === val ){
- this.selected = checked;
- } else if( !self.options.multiple ){
- this.selected = false;
- }
- });
- // some additional single select-specific logic
- if( !self.options.multiple ){
- self.labels.removeClass('ui-state-active');
- $this.closest('label').toggleClass('ui-state-active', checked );
- // close menu
- self.close();
- }
- // fire change on the select box
- self.element.trigger("change");
- // setTimeout is to fix multiselect issue #14 and #47. caused by jQuery issue #3827
- // http://bugs.jquery.com/ticket/3827
- setTimeout($.proxy(self.update, self), 10);
- });
- // close each widget when clicking on any other element/anywhere else on the page
- $(document).bind('mousedown.multiselect', function( e ){
- if(self._isOpen && !$.contains(self.menu[0], e.target) && !$.contains(self.button[0], e.target) && e.target !== self.button[0]){
- self.close();
- }
- });
- // deal with form resets. the problem here is that buttons aren't
- // restored to their defaultValue prop on form reset, and the reset
- // handler fires before the form is actually reset. delaying it a bit
- // gives the form inputs time to clear.
- $(this.element[0].form).bind('reset.multiselect', function(){
- setTimeout(function(){ self.update(); }, 10);
- });
- },
- // set button width
- _setButtonWidth: function(){
- var width = this.element.outerWidth(),
- o = this.options;
- if( /\d/.test(o.minWidth) && width < o.minWidth){
- width = o.minWidth;
- }
- // set widths
- this.button.width( width );
- },
- // set menu width
- _setMenuWidth: function(){
- var m = this.menu,
- width = this.button.outerWidth()-
- parseInt(m.css('padding-left'),10)-
- parseInt(m.css('padding-right'),10)-
- parseInt(m.css('border-right-width'),10)-
- parseInt(m.css('border-left-width'),10);
- m.width( width || this.button.outerWidth() );
- },
- // move up or down within the menu
- _traverse: function( which, start ){
- var $start = $(start),
- moveToLast = which === 38 || which === 37,
- // select the first li that isn't an optgroup label / disabled
- $next = $start.parent()[moveToLast ? 'prevAll' : 'nextAll']('li:not(.ui-multiselect-disabled, .ui-multiselect-optgroup-label)')[ moveToLast ? 'last' : 'first']();
- // if at the first/last element
- if( !$next.length ){
- var $container = this.menu.find('ul:last');
- // move to the first/last
- this.menu.find('label')[ moveToLast ? 'last' : 'first' ]().trigger('mouseover');
- // set scroll position
- $container.scrollTop( moveToLast ? $container.height() : 0 );
- } else {
- $next.find('label').trigger('mouseover');
- }
- },
- // This is an internal function to toggle the checked property and
- // other related attributes of a checkbox.
- //
- // The context of this function should be a checkbox; do not proxy it.
- _toggleCheckbox: function( prop, flag ){
- return function(){
- !this.disabled && (this[ prop ] = flag);
- if( flag ){
- this.setAttribute('aria-selected', true);
- } else {
- this.removeAttribute('aria-selected');
- }
- }
- },
- _toggleChecked: function( flag, group ){
- var $inputs = (group && group.length) ?
- group :
- this.labels.find('input'),
- self = this;
- // toggle state on inputs
- $inputs.each(this._toggleCheckbox('checked', flag));
- // update button text
- this.update();
- // gather an array of the values that actually changed
- var values = $inputs.map(function(){
- return this.value;
- }).get();
- // toggle state on original option tags
- this.element
- .find('option')
- .each(function(){
- if( !this.disabled && $.inArray(this.value, values) > -1 ){
- self._toggleCheckbox('selected', flag).call( this );
- }
- });
- // trigger the change event on the select
- if( $inputs.length ) {
- this.element.trigger("change");
- }
- },
- _toggleDisabled: function( flag ){
- this.button
- .attr({ 'disabled':flag, 'aria-disabled':flag })[ flag ? 'addClass' : 'removeClass' ]('ui-state-disabled');
- this.menu
- .find('input')
- .attr({ 'disabled':flag, 'aria-disabled':flag })
- .parent()[ flag ? 'addClass' : 'removeClass' ]('ui-state-disabled');
- this.element
- .attr({ 'disabled':flag, 'aria-disabled':flag });
- },
- // open the menu
- open: function( e ){
- var self = this,
- button = this.button,
- menu = this.menu,
- speed = this.speed,
- o = this.options;
- // bail if the multiselectopen event returns false, this widget is disabled, or is already open
- if( this._trigger('beforeopen') === false || button.hasClass('ui-state-disabled') || this._isOpen ){
- return;
- }
- var $container = menu.find('ul:last'),
- effect = o.show,
- pos = button.position();
- // figure out opening effects/speeds
- if( $.isArray(o.show) ){
- effect = o.show[0];
- speed = o.show[1] || self.speed;
- }
- // set the scroll of the checkbox container
- $container.scrollTop(0).height(o.height);
- // position and show menu
- if( $.ui.position && !$.isEmptyObject(o.position) ){
- o.position.of = o.position.of || button;
- menu
- .show()
- .position( o.position )
- .hide()
- .show( effect, speed );
- // if position utility is not available...
- } else {
- menu.css({
- top: pos.top+button.outerHeight(),
- left: pos.left
- }).show( effect, speed );
- }
- // select the first option
- // triggering both mouseover and mouseover because 1.4.2+ has a bug where triggering mouseover
- // will actually trigger mouseenter. the mouseenter trigger is there for when it's eventually fixed
- this.labels.eq(0).trigger('mouseover').trigger('mouseenter').find('input').trigger('focus');
- button.addClass('ui-state-active');
- this._isOpen = true;
- this._trigger('open');
- },
- // close the menu
- close: function(){
- if(this._trigger('beforeclose') === false){
- return;
- }
- var o = this.options, effect = o.hide, speed = this.speed;
- // figure out opening effects/speeds
- if( $.isArray(o.hide) ){
- effect = o.hide[0];
- speed = o.hide[1] || this.speed;
- }
- this.menu.hide(effect, speed);
- this.button.removeClass('ui-state-active').trigger('blur').trigger('mouseleave');
- this._isOpen = false;
- this._trigger('close');
- },
- enable: function(){
- this._toggleDisabled(false);
- },
- disable: function(){
- this._toggleDisabled(true);
- },
- checkAll: function( e ){
- this._toggleChecked(true);
- this._trigger('checkAll');
- },
- uncheckAll: function(){
- this._toggleChecked(false);
- this._trigger('uncheckAll');
- },
- getChecked: function(){
- return this.menu.find('input').filter(':checked');
- },
- destroy: function(){
- // remove classes + data
- $.Widget.prototype.destroy.call( this );
- this.button.remove();
- this.menu.remove();
- this.element.show();
- return this;
- },
- isOpen: function(){
- return this._isOpen;
- },
- widget: function(){
- return this.menu;
- },
- // react to option changes after initialization
- _setOption: function( key, value ){
- var menu = this.menu;
- switch(key){
- case 'header':
- menu.find('div.ui-multiselect-header')[ value ? 'show' : 'hide' ]();
- break;
- case 'checkAllText':
- menu.find('a.ui-multiselect-all span').eq(-1).text(value);
- break;
- case 'uncheckAllText':
- menu.find('a.ui-multiselect-none span').eq(-1).text(value);
- break;
- case 'height':
- menu.find('ul:last').height( parseInt(value,10) );
- break;
- case 'minWidth':
- this.options[ key ] = parseInt(value,10);
- this._setButtonWidth();
- this._setMenuWidth();
- break;
- case 'selectedText':
- case 'selectedList':
- case 'noneSelectedText':
- this.options[key] = value; // these all needs to update immediately for the update() call
- this.update();
- break;
- case 'classes':
- menu.add(this.button).removeClass(this.options.classes).addClass(value);
- break;
- }
- $.Widget.prototype._setOption.apply( this, arguments );
- }
- });
- })(jQuery);
|