ExtJS 的 Grid 常需要在儲存格裡顯示狀態圖示,或放一顆可點擊的圖片按鈕。以下整理三種實作方式。
在 columns 設定中加上 renderer,依數值回傳不同的 img 標籤,就能把 0/1 這類狀態值換算成對應的圖示:
renderer: function (value) {
if (value == 0) { return "<img src='images/icons/cancel.png'>"; }
else if (value == 1) { return "<img src='images/icons/accept.png'>"; }
return value;
}
在 renderer 輸出的 img 上寫入 onclick,把需要的資料一起帶進去:
<img style="cursor:pointer;"
onclick="updateRecord(''+sn+"@"+ss+"@"+record.get("standardId")+'')"
src='${ctx}/img/edit.png' alt='明細維護' title='明細維護'>
這種寫法最直接,缺點是行內事件不易維護,資料要用分隔字串拼接也顯得脆弱。另一個變體是監聽 Grid 的 cellClick 事件,在回呼中取出被點擊的元素資訊再處理:
listeners: { cellClick: viewDoc }
function viewDoc(grid, rowIdx, colIdx, e) {
var action = e.getTarget().value;
}
ExtJS 4 之後提供了專門的 actioncolumn,語意清楚且內建 tooltip 與圖示切換:
{
header: '合格證', sortable: false, width: 80, align: 'center', scope: this,
xtype: 'actioncolumn',
items: [{
icon: '${ctx}/img/details.png',
tooltip: '顯示合格證',
handler: function (grid, rowIndex, colIndex) {
var record = grid.getStore().getAt(rowIndex);
// 後續處理
}
}]
}
純顯示狀態用 renderer 最省事;需要互動時,actioncolumn 是語意最清楚且最容易擴充的選擇,也能透過 getClass 依資料狀態替換圖示。行內 onclick 雖然快速,但不建議用在有較多互動或需要國際化的專案裡。