標準 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>
<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>
| 選項 | 類型 | 預設 | 說明 |
|---|---|---|---|
| multiple | Boolean | true | 是否多選;false 時退化為單選下拉 |
| selectedList | Integer | 0 | >0 時顯示前 N 個選中標籤,0 顯示計數 |
| filter | Boolean | false | 啟用搜尋過濾輸入框 |
| filterPlaceholder | String | '搜尋...' | 搜尋框佔位文字 |
| optgroup | Object | {} | 分組配置,如 {label: '分組名', children: [...]} |
| position | Object | {my:'left top', at:'left bottom'} | 面板定位,支援 jQuery UI position 工具 |
| classes | String | '' | 給容器添加自定義 CSS 類 |
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。name="company[]" 接收陣列,或前端手動 join(',')。jquery-ui-1.10.3.custom.min.js 並補 es5-shim。jquery.multiselect 以「零侵入式」增強原生 select,保留表單提交語義,同時提供現代化多選體驗。配合 filter 搜尋與 optgroup 分組,可滿足企業級後台複雜的下拉選擇需求。
📦 專案地址:ehynds/jquery-ui-multiselect-widget(注意:原項目已停止維護,新專案建議考慮 Chosen、Select2 或 Slim Select 等現代替代方案)