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

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
 * 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="#"><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');
            // 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 = 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="#">' + 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="' + 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 = 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 === 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下载地址

有一个 多选 的需求,在网上找到了这个 插件 multi select https://github.com/ehynds/ jquery - ui - multi select -widget csdn博客上有这个 插件 的介绍,不少童鞋都问了这么个问题,怎么获取选中的值?真是个好问题,因为我在看demo的时候也发现了这个问题,呵呵! 先简单说说这个 插件 jquery - multi sel... 2010-10-15 jQuery 多选 插件 文章分类:Web前端 下载地址:http://github.com/ehynds/ jquery - multi select 效果: demos 特性 •支持点击label实现checkbox组选择. •头部选项,如全选/ 取消全选 /关闭功能. •支持键盘选择. •支持5种不同的事件回调函数. •以列表方式显示选中项目,并且可以设置最大显示值. •方便改变位置,渐变速度,滚动容器的高度,链接文字,文本框默认内容等. •最小版只有 6.9kb. 兼容性 •Firefox Multi select 是一个采用 jQuery 实现的两边 多选 列表控件。可以将需要选定的项目从左边添加到右边的列表框中。或者将不需要的项目从右边列表框中删除。 multi select 提供了一些属性的设置, select edPosition:选择项的位置,默认为right,即最终获取选择的值是右边的列表框。moveOptions:移动选项,可以用来给选项排序,实际应用意义不大,这里设置为false。labe 一、 multi select 是一个开源 插件 ,官网地址https://github.com/ehynds/ jquery - ui - multi select -widget, 相关文档地址http://www.erichynds.com/blog/ jquery - ui - multi select -widget(打不开) ,看了下代码的提交时间,2年到5年前提交的,最近无更新。项目中有用到下拉选择框 多选 的情况,就... 有一个 多选 的需求,在网上找到了这个 插件 multi select https://github.com/ehynds/ jquery - ui - multi select -widgetcsdn博客上有这个 插件 的介绍,不少童鞋都问了这么个问题,怎么获取选中的值?真是个好问题,因为我在看demo的时候也发现了这个问题,呵呵!先简单说说这个 插件 jquery - multi select 基于 Jquery - ui 的组件体系。... jquery . multi - select .js是一款 jQuery 多选 下拉框 插件 。该 插件 可以将 select 元素转换为带checkbox的 多选 下拉框 ,非常实用。使用方法在页面中引入下面的文件。lt;link rel="stylesheet" type="text/css" href="./src/example-styles.css"gt;lt;script src="js/ jquery .min.js"... Flutter:使用复选框进行下拉 多选 本文向您展示了在 Flutter 中使用复选框实现下拉 多选 的两种不同方法。在第一种方法中,我们将从头开始构建 多选 。在第二种方法中,我们将使用第三方包快速完成工作。 从头开始使用复选框创建 多选 我们将要构建的应用程序有一个专业的、功能齐全的 多选 小部件,可显示选项列表。可以通过选中/取消选中与其关联的复选框来选择或取消选择一个选项。 当按下升高的按钮时,将显示 多选 对话框。它让用户在编程中选择他们最喜欢的主题。所选主题将作为筹码显示在屏幕上。 以下是我们的应用程 引入文件:<link rel="stylesheet" href="css/bootstrap.min.css" type="text/css"/> <link rel="stylesheet" href="css/bootstrap- multi select .css" type="text/css"/> <script type="text/ javascript " src="js/bootstrap