ComboBox 的數據來源由 store 決定,而 store 支持幾種不同的數據形式。理清它們的差別,才能正確控制「提交值」與「顯示值」。
var p_years = new Ext.form.ComboBox({
fieldLabel: '統計年份',
anchor: anchor_w,
mode: 'remote',
maxHeight: 100,
triggerAction: 'all',
selectOnFocus: true,
forceSelection: true,
editable: false,
// 第一種:二維數組,前者為 value,後者為 text
// store: [['11', '2011'], ['12', '2012'], ['13', '2013']]
// 第二種:一維數組,未指定 value 與 text 時,提交值與顯示值相同
store: [2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018]
});
第一種形式是三 (?) 元組結構 [value, text],提交的是前者,展示的是後者。第二種形式最省事,適合年份、狀態這類值與顯示內容一致的場景。
更正規的用法是異步加載數據字典,用 JsonStore 從後端取數據:
var proj_main_store = new Ext.data.JsonStore({
url: "************",
fields: ['TEXT', 'VALUE'],
root: "objs",
baseParams: {
"obj/dicttypeid": "BM_IMPORTANT_PROJ"
}
});
// 加載完成後在最前面插入一個「全部」選項
proj_main_store.addListener("load", function () {
proj_main_store.insert(0, new Ext.data.Record({
'TEXT': '全部',
'VALUE': ""
}));
});
var proj_main_type = new Ext.form.ComboBox({
fieldLabel: '重點工程',
anchor: anchor_w,
mode: 'remote',
triggerAction: 'all',
selectOnFocus: true,
forceSelection: true,
editable: false,
valueField: 'VALUE', // 實際提交的值對應的字段
displayField: 'TEXT', // 界面上顯示的文本對應的字段
store: proj_main_store
});
要理解 ComboBox 的取值行為,需要區分四個配置:
store:數據來源。fields:JsonStore 中聲明每條記錄包含哪些字段。valueField:選中後表單真正提交的值所對應的字段名。displayField:輸入框裡顯示的文本所對應的字段名。mode: 'remote' 表示數據異步加載,此時 triggerAction: 'all' 很重要——它讓每次展開都查詢全部數據,而不是按輸入內容過濾(那是 'query' 的行為,配合 mode: 'remote' 才能做遠程搜索)。editable: false 禁止手輸,forceSelection: true 則保證必須選中列表項,兩者結合可以避免提交任意值。
root: "objs" 指定 JSON 中記錄數組所在的屬性名,這要求後端返回形如 {"objs": [{"TEXT": "...", "VALUE": "..."}], "total": 10} 的結構。若使用分頁,還需要配置 totalProperty。
在 load 監聽裡 insert 一條「全部」,是常見但略顯笨拙的做法。更清晰的方案是在後端返回數據時就把它拼進去,或者用 emptyText 配合 allowBlank: true 表達「不選」的語義。
字段名建議統一大小寫風格。示例中 TEXT / VALUE 全大寫,是為了對應數據庫列名;若後端返回的是駝峰命名的 DTO,前端也應保持一致的駝峰寫法,避免來回映射。
數據量大時(比如上千條選項),不要一次全量加載。可以改用 mode: 'remote' 加 minChars 實現按需搜索,或引入 Ext.ux.form.SearchField 一類的延遲加載組件,顯著改善首屏性能。
最後,這些 API 均屬 ExtJs 3.x/4.x 風格。ExtJs 5 之後推薦使用 ViewModel 與 Ext.data.Store 的 proxy 配置式聲明,語法差異較大,遷移時需要留意。