ExtJS 的表格組件 GridPanel 一向以功能強大著稱:排序、緩存、拖動、列隱藏、自動行號、列匯總、單元格編輯,幾乎把數據表格需要的東西都備齊了。本文聚焦兩個實戰問題:如何讓單元格可編輯,以及如何根據內容給單元格上色。
表格由 Ext.grid.GridPanel 定義,它繼承自 Panel,xtype 為 grid。一個 Grid 必須具備兩樣東西:列定義信息,以及數據存儲器 Store。
列信息由 Ext.grid.Column 定義(早期版本由 Ext.grid.ColumnModel 承擔);數據存儲器由 Ext.data.Store 定義,並依解析的數據格式細分為 JsonStore、SimpleStore、GroupingStore 等。理解這個「列定義 + Store」的二元結構,後面的配置就都好讀了。
{
xtype: 'gridpanel',
region: 'north',
height: 150,
title: 'My Grid Panel',
store: 'A_Test_Store',
columns: [
{
xtype: 'gridcolumn',
dataIndex: 'Name',
text: 'Name',
editor: { xtype: 'textfield' }
},
{
xtype: 'gridcolumn',
dataIndex: 'Content',
text: 'Content'
},
{
xtype: 'gridcolumn',
dataIndex: 'Time',
text: 'Time'
}
],
plugins: [
Ext.create('Ext.grid.plugin.CellEditing', {
clicksToEdit: 1, // 點擊單元格即可編輯
listeners: {
beforeedit: {
fn: me.onCellEditingBeforeEdit,
scope: me
},
validateedit: {
fn: me.onCellEditingValidateedit,
scope: me
}
}
})
]
}
onCellEditingBeforeEdit: function(editor, e, eOpts) {
// 動態賦值用,正常情況下不需要該事件
e.record.data[e.field] = "my test";
e.value = "my test";
e.record.commit(); // 提交,不提交無效
}
onCellEditingValidateedit: function(editor, e, eOpts) {
if (e.row == 1) { // 驗證邏輯
e.cancel = true; // 取消本次編輯
e.record.data[e.field] = e.value;
}
e.record.commit();
}
啟用編輯需要兩處配置:在列定義上給可編輯列加上 editor(這裡用 textfield),並在 plugins 中掛入 Ext.grid.plugin.CellEditing。clicksToEdit: 1 表示單擊即進入編輯態,改為 2 則需要雙擊。
兩個監聽器的分工值得留意:
beforeedit 在進入編輯前觸發,適合用於動態填充初始值。示例中直接改寫 e.record.data[e.field] 與 e.value,並調用 e.record.commit() 讓改動落地——註意最後那句注釋:不提交是無效的。
validateedit 在校驗階段觸發,可以用來攔截非法輸入。示例中把 e.cancel 置為 true 就取消了本次編輯,同時把值寫回 record.data。
需求是:標題列中,包含「審核通過」的顯示綠色,包含「拒絕」的顯示紅色。這類場景在後台審核列表裡非常常見——讓使用者一眼分辨狀態,比讓他去讀文字快得多。
{
xtype: 'gridcolumn',
renderer: function(value, metaData, record, rowIndex, colIndex, store, view) {
metaData.tdAttr = 'data-qtip="' + record.data.Content + '"';
if (record.data.Content.indexOf('審核通過') != -1) {
metaData.style = "color:green";
} else if (record.data.Content.indexOf('拒絕') != -1) {
metaData.style = "color:red";
}
return value;
},
width: '*',
dataIndex: 'Title',
text: '標題'
}
著色的關鍵是 renderer 函數。它接收七個參數,其中兩個最有用:
value 是當前單元格的顯示值,也是函數最終要返回的內容;
metaData 是元數據載體,通過它可以直接影響渲染出的 td 標籤。
示例中做了兩件事:一是用 metaData.tdAttr 掛上 data-qtip 屬性,把完整的 Content 內容掛成懸浮提示(標題被截斷時特別有用);二是用 metaData.style 寫入 color 聲明,完成文字著色。
如果想給整個單元格加底色而不僅是文字顏色,可以改用 metaData.css 追加一個自定義類名,把顏色規則寫在 CSS 裡。這種做法比內聯樣式更易維護,也方便日後換主題。
關於編輯:批量編輯場景應考慮 RowEditing 插件而非 CellEditing,前者按行提交,交互更接近傳統表單;同時建議在 validateedit 中集中處理校驗,避免把業務判斷散落在多個監聽器裡。
關於著色:顏色承載語義時,務必兼顧色盲使用者——僅靠紅綠區分並不可靠,搭配文字或圖標會更穩妥。這既是無障礙設計的要求,也是實際可用性的保障。