DIV CSS 佈局教程網

jquery.multiselect 多選下拉框的接入步驟與取值賦值
編輯:JQuery入門技巧     

原生 <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 則無嚴格先後要求,但自定義樣式應放在最後以便覆蓋。

第二步:寫 HTML 結構

插件的作用對象就是普通的 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 好得多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved