DIV CSS 佈局教程網

jQuery multiSelect 多選下拉框:參數、方法與預設選中技巧
編輯:JQuery特效代碼     

原生多選下拉框在視覺與互動上都略嫌陽春,multiSelect 這個 jQuery 插件把 multiple select 包裝成一個可顯示勾選狀態、可全選、可自訂提示文字的下拉元件。

基本呼叫方式

$("#id").multiSelect({
  oneOrMoreSelected: '*',
  selectAll: false,
  noneSelected: '默認顯示'
});

使用簽名為 $('#id').multiSelect( options, callback )。

參數一覽

  • selectAll:是否顯示「全選」選項,true/false,預設 true。
  • selectAllText:全選/取消全選時顯示的文字。
  • noneSelected:一項都沒勾選時,標題列顯示的文字。
  • oneOrMoreSelected:勾選一項以上時顯示的文字,可用 % 作為已選數量的預留位置;若想直接列出所有已選項並以逗號分隔,使用 *。預設為 % selected。
  • optGroupSelectable:使用 optgroup 時,分組標題本身是否可選,true/false,預設 false。
  • listHeight:下拉清單的最大高度。

常用方法

// 更新標題上的已選數量,並重新判斷是否處於全選狀態
$("#id").updateSelected()

// 重新整理下拉清單的選項
$("#id").multiSelectOptionsUpdate()

// 收起下拉
$("#id").multiSelectOptionsHide()

// 展開下拉
$("#id").multiSelectOptionsShow()

// 取得以逗號分隔的已選值字串
$("#id").selectedValuesString

用 JavaScript 設定預設勾選項

實務上常見的需求是:頁面載入後依資料內容自動勾選特定項目。下面的寫法先清空既有選取,再把以逗號分隔的清單切成陣列,逐一比對 option 的文字內容後設為 selected。

$("#id").attr("value", "");          // 清空選中項
var ids = '1,3,6';                   // 要勾選的項目
var id_Object = (ids).split(",");    // 切成陣列
var count = $("#id option").length;   // 下拉框總長度

for (var c = 0; c < id_Object.length; c++) {
  for (var c_i = 0; c_i < count; c_i++) {
    if ($("#id").get(0).options[c_i].text == id_Object[c]) {
      $("#id").get(0).options[c_i].selected = true;   // 設為選中
    }
  }
}

這段邏輯用雙層迴圈做「清單 × 選項」的交叉比對,適合項目數量不大的情境。若資料量龐大,建議先把 option 文字整理成索引物件再查,可省下不少迴圈。

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