combogrid 在 jquery easyui 中是相當特別的元件,等於 combo 加上 grid 的組合:它結合可編輯文字框與下拉資料表格,讓使用者既能快速瀏覽選擇,也能輸入關鍵字搜尋並即時看到匹配的資料。當資料量龐大時,就必須再加上分頁能力。
$('#mallid').combogrid({
panelWidth:500,
idField:'mallid',
textField:'mallname',
url:"../global/datagrid.aspx?act=malllist",
fitColumns: true,
striped: true,
editable:true,
pagination : true,
rownumbers:true,
collapsible:false,
fit: true,
pageSize: 10,
pageList: [10],
method:'post',
columns:[[
{field:'mallname',title:'商城名稱',width:150,sortable:true},
{field:'url',title:'網址',width:150}
]],
keyHandler: {
up: function() {},
down: function() {},
enter: function() {},
query: function(q) {
// 動態搜尋
$('#mallid').combogrid("grid").datagrid("reload", { 'keyword': q });
$('#mallid').combogrid("setValue", q);
}
}
});
關鍵在 keyHandler.query:使用者每敲一次鍵就觸發,把關鍵字塞進 queryParams 後重新載入 grid,後端只需依 keyword 過濾並回傳對應分頁即可。
loadMsg:載入遠端資料時顯示的訊息。
idField:實際提交的值。
textField:畫面上顯示的文字。
mode:定義資料載入方式,設為 'remote' 時會以參數名 q 向伺服器發出請求取得新資料。
filter:當 mode 設為 'local' 時,用來決定哪些本地資料要被選取,回傳 true 表示選中該列。
options() 回傳設定物件;grid() 回傳內部的 dataGrid 物件;setValues(values) 設定一組值;setValue(value) 設定單一值;clear() 清空元件的值。
官方 demo 相對簡略,許多組合用法都得自己試出來,這裡簡單記錄以備日後查閱。