實務專案中經常需要把 Grid 的資料依某個欄位分組呈現。ExtJS 原生支援這個功能,但真正容易出問題的地方不在設定,而在「資料動態變化時分組能否正確重繪」。
一、建立 Store 時必須指定 groupField。
先定義資料模型:
Ext.define('Person', {
extend: 'Ext.data.Model',
fields: ['name', 'sex']
});
接著以性別(sex)作為分組依據:
var PersonStore = Ext.create('Ext.data.Store', {
storeId: 'PersonStore',
model: 'Person',
groupField: 'sex',
data: [
{ name: 'hongmei li', sex: 'female' },
{ name: 'san zhang', sex: 'male' },
{ name: 'Jim Green', sex: 'male' },
{ name: 'Lily', sex: 'female' },
{ name: 'Lucy', sex: 'female' }
]
});
二、定義分組標題的 tpl 並掛到 Grid 的 features。
var groupingFeature = Ext.create('Ext.grid.feature.Grouping', {
groupHeaderTpl: 'sex: {name} ({rows.length} Item{[values.rows.length > 1 ? "s" : ""]})'
});
// 其中 {name} 即為 store 中 sex 欄位對應的值
var grid = Ext.create('Ext.grid.Panel', {
renderTo: Ext.getBody(),
store: PersonStore,
width: 600,
height: 400,
title: 'Person',
features: [groupingFeature],
columns: [
{ text: 'Name', flex: 1, dataIndex: 'name' },
{ text: 'sex', flex: 1, dataIndex: 'sex' }
]
});
效果如下:

分組完成後,Grid 中的 sex 欄位其實就可以隱藏起來了。
如果 Store 的資料在執行期發生變化,分組還能正常運作嗎?實測會發現答案是否定的。以下先加上一個 itemclick 事件做測試:
listeners: {
itemclick: function (thisview, record) {
PersonStore.add([{ name: "li", sex: "male" }, { name: "zhang", sex: "female" }]);
}
}
結果畫面並不是我們期望的樣子:

最初我採用的做法是移除並銷毀整個 Grid 再重新載入,這顯然太笨重。真正的解法是把 Store 的新增方式換掉:
listeners: {
itemclick: function (thisview, record) {
PersonStore.loadData([
{ name: "li", sex: "male" },
{ name: "zhang", sex: "female" }
], true);
}
}
再看結果:

這才是想要的效果——新資料依分組規則歸位,而不是被附加在 Grid 的最後面。
兩段程式碼的差異在於:add(records) 是把新的 Model 實例附加到現有集合的尾端,因此不會重新分組;而 loadData(records, append) 是依 Store 自身的規則重新載入資料,自然會套用 groupField 的分組邏輯。理解這一點,問題就迎刃而解了。
文件中的 first([group]) 方法在這裡很好用。不傳參數時它回傳 Store 中的第一筆資料;傳入 true 時,則回傳一個以組名為 key、該組第一筆資料為 value 的物件集合。因此 PersonStore.first(true).female 取得的就是 female 組的第一筆,取 male 組則換成 .male。
listeners: {
itemclick: function (thisview, record) {
PersonStore.loadData([
{ name: "li", sex: "male" },
{ name: "zhang", sex: "female" }
], true);
alert(PersonStore.first(true).female.get('name'));
console.log(PersonStore.first(true).female);
PersonStore.remove(PersonStore.first(true).female);
}
}
直接 remove 之後,被移除的紀錄會留在 removedRecords 中持續佔用記憶體。為此需要再做一層處理:
listeners: {
itemclick: function (thisview, record) {
PersonStore.loadData([
{ name: "li", sex: "male" },
{ name: "zhang", sex: "female" }
], true);
alert(PersonStore.first(true).female.get('name'));
console.log(PersonStore.first(true));
PersonStore.remove(PersonStore.first(true).female);
var recs = PersonStore.getRange();
console.log(recs);
PersonStore.loadRecords(recs); // 重新載入,被移除的紀錄就不會再被記住
console.log(PersonStore);
alert(PersonStore.getRemovedRecords().length); // 結果為 0
}
}
原理是先把目前範圍內的資料取出來,再用 loadRecords 重新灌回去,相當於重建一次集合,讓 removedRecords 歸零。功能可實現,但這個做法確實略顯迂回,若有更好的方式也歡迎交流。
ExtJS 的分組功能本身設定簡單,真正的知識點在於 Store 的資料操作語意:add 是追加、loadData 是依規則重載。分清楚這兩者,大多數「分組跑掉」的問題都能立刻定位。