Ext.form.ComboBox 是 ExtJS 中最常用的下拉選單元件,其 store 設定彈性極高,支援陣列、內建 Store 類別、甚至動態載入。本文系統整理三種主流資料格式與最佳實務。
[ [value, text], ... ]var combo = new Ext.form.ComboBox({
fieldLabel: '統計年份',
store: [['11', '2011年'], ['12', '2012年'], ['13', '2013年']],
// 內部自動轉換為 ArrayStore,fields: ['field1', 'field2']
valueField: 'field1', // 提交值
displayField: 'field2', // 顯示文字
mode: 'local',
triggerAction: 'all',
forceSelection: true,
editable: false
});
[value1, value2, ...]var combo = new Ext.form.ComboBox({
store: [2011, 2012, 2013, 2014, 2015],
// 內部自動轉換,valueField 與 displayField 均為 'field1'
// 提交值 = 顯示值 = 年份數字
mode: 'local',
triggerAction: 'all',
forceSelection: true,
editable: false
});
// 1. 定義 JsonStore
var projMainStore = new Ext.data.JsonStore({
url: '/api/dict/items', // 後端 API
fields: ['TEXT', 'VALUE'], // 對應後端 JSON 欄位
root: 'objs', // JSON 根節點:{ objs: [...] }
baseParams: {
'obj/dicttypeid': 'BM_IMPORTANT_PROJ' // 固定查詢參數
},
autoLoad: true // 自動載入
});
// 2. 載入完成後插入「全部」選項
projMainStore.on('load', function(store) {
store.insert(0, new Ext.data.Record({
TEXT: '全部',
VALUE: '' // 空值代表不篩選
}));
});
// 3. 綁定 ComboBox
var projMainType = new Ext.form.ComboBox({
fieldLabel: '重點工程',
store: projMainStore,
valueField: 'VALUE', // 表單提交值
displayField: 'TEXT', // 使用者看到的文字
mode: 'remote', // 遠端模式(雖然 store 已 autoLoad)
triggerAction: 'all',
selectOnFocus: true,
forceSelection: true,
editable: false,
anchor: '95%'
});
var store = new Ext.data.ArrayStore({
fields: ['value', 'text'],
data: [
['A', '選項 A'],
['B', '選項 B'],
['C', '選項 C']
]
});
var combo = new Ext.form.ComboBox({
store: store,
valueField: 'value',
displayField: 'text',
mode: 'local',
triggerAction: 'all'
});
| 屬性 | 說明 | 陣列模式預設 | JsonStore 模式 |
|---|---|---|---|
| valueField | 表單提交時的值 | field1 | 需對應 fields 定義 |
| displayField | 下拉顯示的文字 | field1(一維)或 field2(二維) | 需對應 fields 定義 |
| mode | 'local' 客戶端過濾 / 'remote' 伺服器端過濾 | local | remote |
| triggerAction | 'all' 點擊展開顯示全部 / 'query' 依輸入過濾 | all | all |
| forceSelection | true 強制只能選清單內選項 | true | true |
| editable | false 禁止手動輸入,純選單 | false | false |
VALUE: '',後端接收時視為「不篩選此欄位」。mode: 'remote' 搭配 pageSize,ComboBox 會自動在下拉清單底部顯示分頁工具列。tpl 配置自訂下拉項目外觀(如加圖標、多欄顯示)。autoLoad: true 會在 Store 建立時立即請求,若 ComboBox 尚未渲染可改用 listeners: { beforerender: function(){ this.getStore().load(); } }。Ext.data.Store + Ext.field.Select,API 略有不同但核心概念相同。ComboBox Store 格式選擇原則:靜態少量用陣列、動態遠端用 JsonStore、前端組裝用 ArrayStore。關鍵在於正確設定 valueField/displayField 對應資料結構,並善用 load 事件注入「全部」等特殊選項。