DIV CSS 佈局教程網

ExtJS Store 分組功能實戰:groupField 設定與動態更新資料的處理
編輯:關於JavaScript     

實務專案中經常需要把 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 與 loadData 的差別

兩段程式碼的差異在於: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);
    }
}

處理 removedRecords 佔用記憶體的問題

直接 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 是依規則重載。分清楚這兩者,大多數「分組跑掉」的問題都能立刻定位。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved