首页 > 代码库 > query多选下拉框插件 jquery-multiselect(修改)

query多选下拉框插件 jquery-multiselect(修改)

其实网上关于该控件的使用教程已经很多了,其中

query多选下拉框插件 jquery-multiselect

Jquery多选下拉列表插件jquery multiselect功能介绍及使用

这2个的介绍已经比较详细了,尤其是第二个有扩展MyValues函数,只是扩展有些bug,这里我在提出一些我的扩展,我们应该把multiValues属性定义在options里面,让每个multiselect控件都有自己的multiValues属性。我这里还需要一个获取text的方法。有关Myvalues和Mytexts的函数如下:

   MyValues: function () {
            return this.options.multiValues;
        },
        MyTexts: function () {
            return this.buttonlabel.html();
        },

默认的mytexts会有html编码效果,比如我的text是111&AAAA,我希望返回的呈现的text就是真是的值而不是111&ampAAA;要实现这个功能需要需要修改_setButtonValue函数

     _setButtonValue: function (value) {
            // this.buttonlabel.text(value);
            this.buttonlabel.html(value);
        },

在多选框弹出层关闭的时候我们要实现一些自己ajax请求,于是乎我们需要一个close函数,函数定义在options属性里面     WinClose: null,实现在close方法里面

   if (this.options.WinClose) {
                this.options.WinClose(this);
            }

客户端的控件效果默认是没有固定高度,这里我们需要加一个固定高度给button

<button type="button"  style=" height: 24px; overflow: hidden" >

最后的调用代码是:

 $("select[id*=‘ListBox‘]").multiselect({
                        noneSelectedText: "==请选择==",
                        checkAllText: "全选",
                        uncheckAllText: ‘全不选‘,
                        selectedList: 5,
                        WinClose: function (val) {
                            alert("Values:" + val.MyValues() + " Texts:" + val.MyTexts());

                        }
                    });

实现的效果如下:

当我们关闭弹出层时会调用我们的Winclose函数

修改后的整个js如下:

/* jshint forin:true, noarg:true, noempty:true, eqeqeq:true, boss:true, undef:true, curly:true, browser:true, jquery:true *//* * jQuery MultiSelect UI Widget 1.14pre * Copyright (c) 2012 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;    var $doc = $(document);    $.widget("ech.multiselect", {        // default options        options: {            multiValues: "",            header: true,            height: 175,            minWidth: 225,            classes: ‘‘,            checkAllText: Check all,            uncheckAllText: Uncheck all,            noneSelectedText: Select options,            selectedText: # selected,            selectedList: 0,            show: null,            hide: null,            autoOpen: false,            multiple: true,            position: {},            WinClose: null,            appendTo: "body"        },        _create: function () {            var el = this.element.hide();            var o = this.options;            this.speed = $.fx.speeds._default; // default speed for effects            this._isOpen = false; // assume no            // create a unique namespace for events that the widget            // factory cannot unbind automatically. Use eventNamespace if on            // jQuery UI 1.9+, and otherwise fallback to a custom string.            this._namespaceID = this.eventNamespace || (multiselect + multiselectID);            var button = (this.button = $(<button type="button"  style=" height: 24px; overflow: hidden" ><span  class="ui-icon ui-icon-triangle-1-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)              .appendTo($(o.appendTo)),            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="http://www.mamicode.com/#"><span class="ui-icon ui-icon-check"></span><span> + o.checkAllText + </span></a></li><li><a class="ui-multiselect-none" href="http://www.mamicode.com/#"><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="http://www.mamicode.com/#" 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);            }            // bump unique ID            multiselectID++;        },        _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;            var o = this.options;            var menu = this.menu;            var checkboxContainer = this.checkboxContainer;            var optgroups = [];            var html = "";            var id = el.attr(id) || multiselectID++; // unique ID for the label & option tags            // build items            el.find(option).each(function (i) {                var $this = $(this);                var parent = this.parentNode;                var description = this.innerHTML;                var title = this.title;                var value = http://www.mamicode.com/this.value;                var inputID = ui-multiselect- + (this.id || id + -option- + i);                var isDisabled = this.disabled;                var isSelected = this.selected;                var labelClasses = [ui-corner-all];                var liClasses = (isDisabled ? ui-multiselect-disabled  :  ) + this.className;                var optLabel;                // is this an optgroup?                if (parent.tagName === OPTGROUP) {                    optLabel = parent.getAttribute(label);                    // has this optgroup been added already?                    if ($.inArray(optLabel, optgroups) === -1) {                        html += <li class="ui-multiselect-optgroup-label  + parent.className + "><a href="http://www.mamicode.com/#"> + 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 += <li class=" + liClasses + ">;                // create the label                html += <label for=" + inputID + " title=" + title + " class=" + labelClasses.join( ) + ">;                html += <input id=" + inputID + " name="multiselect_ + id + " type=" + (o.multiple ? "checkbox" : "radio") + " value="http://www.mamicode.com/ + value + " title=" + title + ";                // pre-selected?                if (isSelected) {                    html +=  checked="checked";                    html +=  aria-selected="true";                }                // disabled?                if (isDisabled) {                    html +=  disabled="disabled";                    html +=  aria-disabled="true";                }                // add the title and close everything off                html +=  /><span> + description + </span></label></li>;            });            // insert into the DOM            checkboxContainer.html(html);            // cache some moar useful elements            this.labels = menu.find(label);            this.inputs = this.labels.children(input);            // set widths            this._setButtonWidth();            this._setMenuWidth();            // remember default value            this.button[0].defaultValue = http://www.mamicode.com/this.update();            // broadcast refresh event; useful for widgets            if (!init) {                this._trigger(refresh);            }        },        MyValues: function () {            return this.options.multiValues;        },        MyTexts: function () {            return this.buttonlabel.html();        },        // updates the button text. call refresh() to rebuild        update: function () {            var o = this.options;            var $inputs = this.inputs;            var $checked = $inputs.filter(:checked);            var numChecked = $checked.length;            var 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).next().html(); }).get().join(, );                } else {                    value = o.selectedText.replace(#, numChecked).replace(#, $inputs.length);                }                this.options.multiValues = $checked.map(function () { return $(this).val(); }).get().join(, );            }            this._setButtonValue(value);            return value;        },        // this exists as a separate method so that the developer         // can easily override it.        _setButtonValue: function (value) {            // this.buttonlabel.text(value);            this.buttonlabel.html(value);        },        // binds events        _bindEvents: function () {            var self = this;            var 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);                var $inputs = $this.parent().nextUntil(li.ui-multiselect-optgroup-label).find(input:visible:not(:disabled));                var nodes = $inputs.get();                var 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);                var val = this.value;                var checked = this.checked;                var 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;                }                // make sure the input has focus. otherwise, the esc key                // won‘t close the menu after clicking an item.                $this.focus();                // toggle aria state                $this.attr(aria-selected, checked);                // change state on the original option tags                tags.each(function () {                    if (this.value =http://www.mamicode.com/== 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            $doc.bind(mousedown. + this._namespaceID, function (event) {                var target = event.target;                if (self._isOpen                    && target !== self.button[0]                    && target !== self.menu[0]                    && !$.contains(self.menu[0], target)                    && !$.contains(self.button[0], target)                  ) {                    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($.proxy(self.refresh, self), 10);            });        },        // set button width        _setButtonWidth: function () {            var width = this.element.outerWidth();            var o = this.options;            if (/\d/.test(o.minWidth) && width < o.minWidth) {                width = o.minWidth;            }            // set widths            this.button.outerWidth(width);        },        // set menu width        _setMenuWidth: function () {            var m = this.menu;            m.outerWidth(this.button.outerWidth());        },        // move up or down within the menu        _traverse: function (which, start) {            var $start = $(start);            var moveToLast = which === 38 || which === 37;            // select the first li that isn‘t an optgroup label / disabled            var $next = $start.parent()[moveToLast ? prevAll : nextAll](li:not(.ui-multiselect-disabled, .ui-multiselect-optgroup-label)).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.        _toggleState: function (prop, flag) {            return function () {                if (!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.inputs;            var self = this;            // toggle state on inputs            $inputs.each(this._toggleState(checked, flag));            // give the first input focus            $inputs.eq(0).focus();            // 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._toggleState(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);            var inputs = this.menu.find(input);            var key = "ech-multiselect-disabled";            if (flag) {                // remember which elements this widget disabled (not pre-disabled)                // elements, so that they can be restored if the widget is re-enabled.                inputs = inputs.filter(:enabled).data(key, true)            } else {                inputs = inputs.filter(function () {                    return $.data(this, key) === true;                }).removeData(key);            }            inputs              .attr({ disabled: flag, arial-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;            var button = this.button;            var menu = this.menu;            var speed = this.speed;            var o = this.options;            var args = [];            // 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();            var effect = o.show;            // figure out opening effects/speeds            if ($.isArray(o.show)) {                effect = o.show[0];                speed = o.show[1] || self.speed;            }            // if there‘s an effect, assume jQuery UI is in use            // build the arguments to pass to show()            if (effect) {                args = [effect, speed];            }            // set the scroll of the checkbox container            $container.scrollTop(0).height(o.height);            // positon            this.position();            // show the menu, maybe with a speed/effect combo            $.fn.show.apply(menu, args);            // select the first not disabled 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.filter(:not(.ui-state-disabled)).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;            var effect = o.hide;            var speed = this.speed;            var args = [];            // figure out opening effects/speeds            if ($.isArray(o.hide)) {                effect = o.hide[0];                speed = o.hide[1] || this.speed;            }            if (effect) {                args = [effect, speed];            }            $.fn.hide.apply(this.menu, args);            this.button.removeClass(ui-state-active).trigger(blur).trigger(mouseleave);            this._isOpen = false;            this._trigger(close);            if (this.options.WinClose) {                this.options.WinClose(this);            }        },        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);            // unbind events            $doc.unbind(this._namespaceID);            this.button.remove();            this.menu.remove();            this.element.show();            return this;        },        isOpen: function () {            return this._isOpen;        },        widget: function () {            return this.menu;        },        getButton: function () {            return this.button;        },        position: function () {            var o = this.options;            // use the position utility if it exists and options are specifified            if ($.ui.position && !$.isEmptyObject(o.position)) {                o.position.of = o.position.of || this.button;                this.menu                  .show()                  .position(o.position)                  .hide();                // otherwise fallback to custom positioning            } else {                var pos = this.button.offset();                this.menu.css({                    top: pos.top + this.button.outerHeight(),                    left: pos.left                });            }        },        // 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;                case multiple:                    menu.toggleClass(ui-multiselect-single, !value);                    this.options.multiple = value;                    this.element[0].multiple = value;                    this.refresh();                    break;                case position:                    this.position();            }            $.Widget.prototype._setOption.apply(this, arguments);        }    });})(jQuery);
View Code

完整的demo下载地址