在 Ext 的表單體系裡,ComboBox 幾乎是必不可少的一個元件。很多剛接觸 Ext 的朋友在寫下拉選單時,最容易卡住的地方就是 store 的資料格式——到底該傳二維陣列、一維陣列,還是走 JsonStore?本文就把這幾種常見寫法一次講清楚。
下面的程式碼展示了一個「統計年份」下拉選單,其中註解掉了兩種不同的 store 寫法:
var p_years = new Ext.form.ComboBox({
fieldLabel : '統計年份',
anchor : anchor_w,
mode : 'remote',
maxHeight : 100,
triggerAction : 'all',
selectOnFocus : true,
forceSelection : true,
editable : false,
// 第一種寫法:二維陣列
// store : [['11', '2011'], ['12', '2012'], ['13', '2013']]
// 第二種寫法:一維陣列
store : [2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018]
});
兩者的差別在於:
[['value', 'Text'], ...]:每一筆資料都是一組「值 + 顯示文字」。前者是真正提交到後端的 value,後者是使用者在頁面上看到的文字。[2011, 2012, ...]:當你沒有明確指定 valueField 與 displayField 時,Ext 會把同一個值同時當成提交值與顯示值。也就是說,看到什麼就送出什麼。如果只是幾個固定選項,直接手寫陣列是最省事的做法。
但在真實專案裡,選項通常來自資料表或資料字典,這時候就該改用 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
});
mode: 'remote' 表示資料來自遠端;若資料是本地陣列,應改為 'local'。triggerAction: 'all' 讓點擊時顯示全部選項而不是只篩選符合輸入的項目。editable: false 禁止手動輸入,搭配 forceSelection: true 可以確保使用者只能從清單中挑選,避免送出髒資料。
至於「全部」這一類空值選項,透過監聽 store 的 load 事件再 insert 一筆記錄,是最乾淨的做法——不必改動後端回傳的資料,前端就能靈活補上預設值。