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

標記可以用 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}
]]
});
其餘特性沿用 combo 與 datagrid,以下為 ComboGrid 新增者:
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| loadMsg | string | datagrid 正在載入遠端資料時顯示的提示文字。 | null |
| idField | string | 作為識別用的 id 欄位名稱。 | null |
| textField | string | 要顯示在文字框中的 text 欄位名稱。 | null |
| mode | string | 定義文字變動時如何載入表格資料。若從伺服器端載入,設為 'remote'。 | local |
| filter | function(q, row) | 定義當 mode 為 'local' 時如何篩選本地資料,回傳 true 即選中該列。 | — |
繼承自 combo 與 datagrid,例如 onSelect、onChange 等。
| 名稱 | 參數 | 說明 |
|---|---|---|
| options | none | 回傳 options 物件。 |
| grid | none | 回傳內部的 datagrid 物件。 |
| setValues | values | 以陣列設定元件的值。 |
| setValue | value | 設定元件的單一值。 |
| clear | none | 清除元件的值。 |
實務提醒:資料量大時,把 mode 設為 remote 並搭配 filter 做伺服器端查詢,能顯著降低前端負擔;若資料量小且固定,local 模式配合自訂 filter 反應更快。