萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

基於 jquery.multiselect 實現可多選下拉框(含完整示例與樣式客製化)

專案需求

標準 HTML <select multiple> 體驗差:需按住 Ctrl/Cmd 多選、無搜尋、樣式難控制。jQuery UI MultiSelect Widget(jquery.multiselect.js)將其轉換為帶檢查框的下拉面板,支援搜尋、全選、分組、主題客製化,是後台管理系統的常用組件。

資源引入

<link rel="stylesheet" href="jquery-ui.css" />
<link rel="stylesheet" href="jquery.multiselect.css" />
<script src="jquery.js"></script>
<script src="jquery-ui.min.js"></script>
<script src="jquery.multiselect.js"></script>

基礎 HTML 與初始化

<select id="company" name="company" multiple="multiple">
  <option value="北方公司" selected>北方公司【總公司】</option>
  <option value="西南公司">西南公司</option>
  <option value="華東公司">華東公司</option>
  <option value="東北公司">東北公司</option>
</select>
<span id="company1" style="color:red"></span>

<script>
$(function () {
  $('#company').multiselect({
    header: '請選擇公司',
    noneSelectedText: '未選擇',
    selectedList: 2,           // 顯示前 2 個選中文字,超出顯示「已選 3 項」
    minWidth: 220,
    height: 200,               // 下拉面板最大高度
    show: ['fade', 200],
    hide: ['fade', 100],
    // 事件回調
    click: function (event, ui) {
      $('#company1').text('當前選中:' + $('#company').val().join(', '));
    },
    checkAll: function () { console.log('全選'); },
    uncheckAll: function () { console.log('取消全選'); }
  });
});
</script>

進階配置選項

選項類型預設說明
multipleBooleantrue是否多選;false 時退化為單選下拉
selectedListInteger0>0 時顯示前 N 個選中標籤,0 顯示計數
filterBooleanfalse啟用搜尋過濾輸入框
filterPlaceholderString'搜尋...'搜尋框佔位文字
optgroupObject{}分組配置,如 {label: '分組名', children: [...]}
positionObject{my:'left top', at:'left bottom'}面板定位,支援 jQuery UI position 工具
classesString''給容器添加自定義 CSS 類

動態操作 API

const $ms = $('#company').multiselect('widget'); // 獲取面板 jQuery 對象

// 程式化開關
$('#company').multiselect('open');
$('#company').multiselect('close');

// 獲取/設定值(返回值陣列)
const vals = $('#company').multiselect('getChecked').map(function(){ return this.value; }).get();
$('#company').multiselect('check', ['北方公司', '華東公司']);
$('#company').multiselect('uncheck', ['西南公司']);

// 刷新(動態修改 option 後必須調用)
$('#company').append('');
$('#company').multiselect('refresh');

// 銷毀
$('#company').multiselect('destroy');

樣式客製化技巧

.ui-multiselect-menu {
  z-index: 9999;              // 避免被模態框遮擋
  max-height: 300px;
  overflow-y: auto;
}
.ui-multiselect-checkboxes label {
  padding: 4px 8px;           // 增加點擊熱區
  font-size: 13px;
}
.ui-multiselect-header a {
  margin-right: 10px;         // 全選/取消全選按鈕間距
}

/* 選中標籤樣式 */
.ui-multiselect-single .ui-multiselect-checkboxes input:checked + label {
  background: #e8f5e9;
  color: #2e7d32;
}

常見問題

  • 面板被截斷:父容器 overflow:hidden 會遮擋下拉面板,解決:將面板 appendTo: 'body' 或調整 z-index。
  • 多選值提交為逗號分隔字串:PHP 等後端需用 name="company[]" 接收陣列,或前端手動 join(',')。
  • IE 兼容:插件依賴 jQuery UI 1.10+,IE9+ 正常;IE8 需引入 jquery-ui-1.10.3.custom.min.js 並補 es5-shim。

結語

jquery.multiselect 以「零侵入式」增強原生 select,保留表單提交語義,同時提供現代化多選體驗。配合 filter 搜尋與 optgroup 分組,可滿足企業級後台複雜的下拉選擇需求。


📦 專案地址:ehynds/jquery-ui-multiselect-widget(注意:原項目已停止維護,新專案建議考慮 Chosen、Select2 或 Slim Select 等現代替代方案)

copyright © 萬盛學電腦網 all rights reserved