DIV CSS 佈局教程網

jQuery 下拉多選框(multiselect)屬性、事件與方法速查
編輯:JavaScript綜合知識     

原生的多選列表在使用體驗上一直不夠友善。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,記得先轉型。

二、常用事件

  • beforeopen / open:下拉面板開啟前與開啟後
  • beforeclose / close:下拉面板關閉前與關閉後
  • checkall:按下全選後觸發
  • uncheckall:按下全不選後觸發
  • click:勾選單一項目時觸發

有 before 與無 before 的成對設計很實用:beforeopen 適合先做資料驗證或載入選項,open 則適合設定初始焦點;beforeclose 可以攔下關閉動作,close 用來同步狀態到畫面其他地方。

三、主要方法

  • refresh:重新整理控件。用程式動態增刪 option 之後,務必呼叫它,否則面板顯示的內容不會更新——這是最容易忽略的一步。
  • checkAll:全選所有項目
  • uncheckAll:取消所有勾選
  • getChecked:回傳一個陣列,內含所有被勾選的項目

把這幾個方法與屬性搭配起來,就能做出「選取後即時顯示已選標籤」「依條件自動勾選」這類進階互動。實作時建議統一透過 getChecked 取狀態,而不是四處查 DOM,程式碼會好維護得多。

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