原生的多選列表在使用體驗上一直不夠友善。multiselect 插件把它包裝成一個可折疊的下拉面板,加上全選、勾選計數等便利功能,讓多選變得直覺許多。

1. 全選/全不選的文字(對應上圖第 3 部分)
checkAllText 預設值為 "check all",uncheckAllText 預設值為 "uncheck all",兩者都可自訂:
$("select").multiselect({
checkAllText: "全選",
uncheckAllText: "全不選"
});
2. 已選項目的提示文字(對應上圖第 2 部分)
selectedText 預設為 "# selected",其中的 # 會被替換成實際數量:
$("select").multiselect({
selectedText: '選中【#】項,總共【#】項'
});
3. 取得被選項目的顯示文字(對應上圖第 1 部分)
$("select").find("option:selected").text();
4. 取得被選項目的 value 值
回傳的是逗號串接的字串,例如 1,2,3,6,7:
var keys = $("#depart").val();
這個格式對後端很友善,可以直接 split 之後批次處理;若要傳給以陣列為參數的 API,記得先轉型。
有 before 與無 before 的成對設計很實用:beforeopen 適合先做資料驗證或載入選項,open 則適合設定初始焦點;beforeclose 可以攔下關閉動作,close 用來同步狀態到畫面其他地方。
把這幾個方法與屬性搭配起來,就能做出「選取後即時顯示已選標籤」「依條件自動勾選」這類進階互動。實作時建議統一透過 getChecked 取狀態,而不是四處查 DOM,程式碼會好維護得多。