DIV CSS 佈局教程網

Sencha ExtJS GridPanel 單元格編輯與內容著色實戰
編輯:關於JavaScript     

ExtJS 的表格組件 GridPanel 一向以功能強大著稱:排序、緩存、拖動、列隱藏、自動行號、列匯總、單元格編輯,幾乎把數據表格需要的東西都備齊了。本文聚焦兩個實戰問題:如何讓單元格可編輯,以及如何根據內容給單元格上色。

先理清 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 中集中處理校驗,避免把業務判斷散落在多個監聽器裡。

關於著色:顏色承載語義時,務必兼顧色盲使用者——僅靠紅綠區分並不可靠,搭配文字或圖標會更穩妥。這既是無障礙設計的要求,也是實際可用性的保障。

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