萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

ExtJS Grid 加入圖片狀態、按鈕與事件處理三種方案

場景說明

在 ExtJS Grid 中常需於儲存格顯示狀態圖示(如啟用/停用)、操作按鈕(編輯、刪除),並處理點擊事件。本文整理三種主流做法。

方案一:Renderer 回傳圖片 HTML(最簡單)

在 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;
  }
}]

事件綁定:直接在 img 加 onclick

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 事件統一處理

在 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);
    // 處理業務邏輯
  }
}

方案三:使用 actioncolumn(ExtJS 官方推薦)

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 + imgcellclick 統一處理actioncolumn
程式碼簡潔度高中高
事件處理彈性需自行綁定 onclick集中管理,需自行判斷目標內建 handler,最直觀
多按鈕支援需自行拼 HTML需自行判斷原生支援 items 陣列
樣式控制完全自訂完全自訂受限於 actioncolumn CSS
推薦場景單一狀態圖示、簡單動作複雜邏輯、需統一攔截標準操作欄(編輯/刪除/詳情)

注意事項

  • 後端回傳資料必須包含 id 屬性,否則 getPath('id') 等樹狀操作會失效。
  • Renderer 回傳 HTML 時注意 XSS 風險,值需經過義處理。
  • actioncolumn 的 icon 路徑建議使用相對路徑或配置變數。
copyright © 萬盛學電腦網 all rights reserved