在 ExtJS Grid 中常需於儲存格顯示狀態圖示(如啟用/停用)、操作按鈕(編輯、刪除),並處理點擊事件。本文整理三種主流做法。
在 Column 定義中使用 renderer 根據值回傳 <img> 標籤。
columns: [{
text: '狀態',
dataIndex: 'status',
renderer: function(value) {
if (value === 0) {
return "<img src='images/icons/cancel.png' alt='停用'>";
} else if (value === 1) {
return "<img src='images/icons/accept.png' alt='啟用'>";
}
return value;
}
}]
renderer: function(value, meta, record) {
var sn = record.get('sn');
var ss = record.get('ss');
var standardId = record.get('standardId');
return "<img style='cursor:pointer;' onclick=\"updateRecord('" + sn + "@" + ss + "@" + standardId + "')\" src='${ctx}/img/edit.png' alt='明細維護' title='明細維護'>";
}
在 Grid 監聽 cellclick,透過事件物件判斷點擊目標。
listeners: {
cellclick: viewDoc
}
function viewDoc(grid, rowIdx, colIdx, e) {
var target = e.getTarget();
// 判斷是否為目標元素(如 img.btn-action)
if (target.tagName === 'IMG' && target.className === 'btn-action') {
var record = grid.getStore().getAt(rowIdx);
// 處理業務邏輯
}
}
xtype: 'actioncolumn' 專為儲存格操作按鈕設計,支援多圖示、工具提示、handler 回呼。
{
header: '合格證',
sortable: false,
width: 80,
align: 'center',
xtype: 'actioncolumn',
items: [{
icon: '${ctx}/img/details.png',
tooltip: '顯示合格證',
handler: function(grid, rowIndex, colIndex) {
var record = grid.getStore().getAt(rowIndex);
// 顯示合格證詳情
}
}]
}
| 維度 | Renderer + img | cellclick 統一處理 | actioncolumn |
|---|---|---|---|
| 程式碼簡潔度 | 高 | 中 | 高 |
| 事件處理彈性 | 需自行綁定 onclick | 集中管理,需自行判斷目標 | 內建 handler,最直觀 |
| 多按鈕支援 | 需自行拼 HTML | 需自行判斷 | 原生支援 items 陣列 |
| 樣式控制 | 完全自訂 | 完全自訂 | 受限於 actioncolumn CSS |
| 推薦場景 | 單一狀態圖示、簡單動作 | 複雜邏輯、需統一攔截 | 標準操作欄(編輯/刪除/詳情) |
id 屬性,否則 getPath('id') 等樹狀操作會失效。icon 路徑建議使用相對路徑或配置變數。