DIV CSS 佈局教程網

EasyUI combobox 下拉框三種寫法:頁面標籤、表單欄位與表格內編輯
編輯:JavaScript綜合知識     

EasyUI 的 combobox 可以出現在三種不同的位置,寫法各有講究:直接放在頁面的 input 上、放在 datagrid 的表頭做篩選、或放在可編輯儲存格中。以下把三種形式並列對照。

寫法一:獨立的 input 元素

最簡單的形式,用 class 標記後由 EasyUI 自動初始化,資料直接寫在 data-options 中:

<input id="cc" class="easyui-combobox" name="name"
  data-options="valueField:'value', textField:'text',
    data:[{'value':'1','text':'java'}, {'value':'2','text':'C#'}]" />

寫法二:datagrid 表頭的篩選器

放在 <th> 的 editor 中,讓該欄具備下拉選單:

<th data-options="field:'lb', editor:{
    type:'combobox',
    options:{
      data:[{'value':'1','text':'java'}, {'value':'2','text':'C#'}],
      valueField:'value',
      textField:'text'
    }
  }">類別</th>

寫法三:寫法二的另一種等價形式

把 editor 獨立成屬性,可讀性更好:

<th field="level" editor="{
  type:'combobox',
  options:{
    data:[
      {'value':'1','text':'java'},
      {'value':'2','text':'C#'}
    ],
    valueField:'id',
    textField:'text'
  }
}">類別</th>

valueField 與 textField 到底在分什麼

這兩個設定是 combobox 的核心觀念,搞錯就會出現「選了 A 卻顯示 B」:

  • valueField:真正被儲存、被送出的值。程式邏輯比對、回填都靠它。
  • textField:使用者眼睛看到的文字。

注意寫法三刻意把 valueField 設為 'id',而資料裡並沒有 id 欄位(只有 value 與 text)。這種不一致會導致回填時永遠比對失敗——這通常不是刻意為之,而是複製貼上時漏改。實際專案中務必確認兩者對得上。

從後端載入資料

實務上選項幾乎都來自資料庫,用 url 搭配欄位對應即可:

$('#cc').combobox({
  url: 'dict/list.do?type=level',
  valueField: 'id',
  textField: 'name',
  editable: false,          // 禁止手打,只能選
  panelHeight: 'auto',      // 選項過多時自動撐開並出現捲軸
  onLoadSuccess: function () {
    // 資料載入後才回填,順序很重要
    $('#cc').combobox('setValue', $('#hiddenId').val());
  }
});

三種寫法怎麼選

頁面篩選或表單欄位用寫法一,最直觀。datagrid 表頭篩選用寫法二或三——兩者功能相同,寫法三把 editor 獨立出來,在有多行屬性時較易讀,也方便日後維護。可編輯儲存格則要在欄位的 editor 中設定,並記得搭配 onBeginEdit 做初始值處理。

兩個實務提醒

型別一致。valueField 的值若在后端是數字,前端回填時傳字串就會比對失敗。這點在 EasyUI 中造成的困擾遠比其他問題多,建議在 loadFilter 中統一轉型。

大量選項要加搜尋。超過數十筆的清單,用 select 式的下拉會讓使用者翻到崩潰。EasyUI 另有 combogrid(帶表格與分頁的版本)或 searchbox,在這種場景體驗更好。

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