DIV CSS 佈局教程網

jQuery EasyUI 中文文件:ComboGrid 組合表格用法與屬性
編輯:JQuery特效代碼     

ComboGrid 是 combo 與 datagrid 的混血:外層是下拉輸入框,展開後呈現的卻是一張可排序、可分頁的表格。當選項欄位多、需要一次比較好幾個屬性才能決定選哪一筆時,它比 ComboBox 或 ComboTree 都合適。元件以 $.fn.combogrid.defaults 覆寫了 defaults。

依賴

  • combo
  • datagrid

用法

標記可以用 select 或 input:

<select id="cc" name="dept" style="width:250px;"></select>
<input id="cc" name="dept" value="01">

初始化時需要指定 idField、textField 與 columns,這三項決定了「存什麼值、顯示什麼字、表格長什麼樣」:

$('#cc').combogrid({
  panelWidth:450,
  value:'006',
  idField:'code',
  textField:'name',
  url:'datagrid_data.json',
  columns:[[
    {field:'code',title:'Code',width:60},
    {field:'name',title:'Name',width:100},
    {field:'addr',title:'Address',width:120},
    {field:'col4',title:'Col41',width:100}
  ]]
});

特性(Properties)

其餘特性沿用 combo 與 datagrid,以下為 ComboGrid 新增者:

名稱類型說明預設值
loadMsgstringdatagrid 正在載入遠端資料時顯示的提示文字。null
idFieldstring作為識別用的 id 欄位名稱。null
textFieldstring要顯示在文字框中的 text 欄位名稱。null
modestring定義文字變動時如何載入表格資料。若從伺服器端載入,設為 'remote'。local
filterfunction(q, row)定義當 mode 為 'local' 時如何篩選本地資料,回傳 true 即選中該列。—

事件(Events)

繼承自 combo 與 datagrid,例如 onSelect、onChange 等。

方法(Methods)

名稱參數說明
optionsnone回傳 options 物件。
gridnone回傳內部的 datagrid 物件。
setValuesvalues以陣列設定元件的值。
setValuevalue設定元件的單一值。
clearnone清除元件的值。

實務提醒:資料量大時,把 mode 設為 remote 並搭配 filter 做伺服器端查詢,能顯著降低前端負擔;若資料量小且固定,local 模式配合自訂 filter 反應更快。

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