原生 <select multiple> 的交互體驗實在一般:要用 Ctrl 或 Shift 加選、沒有搜索、選了幾項看不清。jquery-ui-multiselect-widget 插件把這些問題一次性解決,本文記錄接入的四個步驟。
該插件基於 jQuery 與 jQuery UI,因此兩者的基本文件都需要引用。若本地沒有,可到專案倉庫下載。
<link rel="stylesheet" type="text/css" href="~/Scripts/jquerymultiselect/jquery-ui.css" /> <link rel="stylesheet" type="text/css" href="~/Scripts/jquerymultiselect/jquery.multiselect.css" /> <link rel="stylesheet" type="text/css" href="~/Scripts/jquerymultiselect/style.css" /> <link rel="stylesheet" type="text/css" href="~/Scripts/jquerymultiselect/prettify.css" /> <script type="text/javascript" src="~/Scripts/jquery-ui-1.8.24.min.js"></script> <script type="text/javascript" src="~/Scripts/jquerymultiselect/prettify.js"></script> <script type="text/javascript" src="~/Scripts/jquerymultiselect/jquery.multiselect.min.js"></script>
順序要注意:jQuery 核心 → jQuery UI → multiselect 插件,CSS 則無嚴格先後要求,但自定義樣式應放在最後以便覆蓋。
插件的作用對象就是普通的 multiple select,因此結構上不需要任何特殊處理。下面以 ASP.NET MVC 的 Razor 語法為例,並順帶實現了服務端賦值:
<select name="Users" multiple="multiple" id="select_users">
@foreach (DModel.Model.User item in ViewBag.users)
{
if (Model.Users.Contains(item.Name))
{
<option value="@item.Name" selected="selected">@item.Name</option>
}
else
{
<option value="@item.Name">@item.Name</option>
}
}
</select>
<script>
$(function () {
$("#select_users").multiselect({
noneSelectedText: "==請選擇==",
checkAllText: "全選",
uncheckAllText: '全不選',
selectedList: 5
});
});
</script>
幾個常用參數:noneSelectedText 是未選任何項時按鈕上顯示的文字;checkAllText / uncheckAllText 定制全選與取消全選的按鈕文案;selectedList 控制已選項在按鈕上最多列出幾個,超出後收起為「已選 N 項」。

取值:插件並不改變原 select 的行為,直接取值即可,返回的是數組。
var users = $("#select_users").val(); // ["張三", "李四"]
var usersText = $("#select_users").find("option:selected").text();
若使用 Ajax.BeginForm 提交表單,則完全不需要手工取值,表單序列化時會自動帶上。
賦值:如第二步所示,在服務端渲染時給 option 加 selected="selected" 是最直接的方式。若是前端動態賦值,寫法同樣簡單:
$("#select_users").val(["張三", "李四"]); // 設置選中項
$("#select_users").multiselect("refresh"); // 關鍵:刷新插件顯示
最後那句 refresh 是重點。插件初始化後會用自繪的 DOM 覆蓋原生 select,直接改 select 的選中狀態,插件界面不會自動跟著變,必須調用 refresh 同步。這是使用這類「替身型」插件時最常踩的坑。
$("#select_users").multiselect("disable"); // 禁用
$("#select_users").multiselect("enable"); // 啟用
$("#select_users").multiselect("checkAll"); // 全選
$("#select_users").multiselect("uncheckAll"); // 取消全選
$("#select_users").multiselect("getChecked"); // 取得選中項
另外插件自帶搜索框與「全選/反選」勾選,對於用戶列表這類幾十上百條數據的場景,體驗比原生 multiple select 好得多。