萬盛學電腦網

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

ExtJS GridPanel 表格文字垂直置中完整解決方案

需求背景

ExtJS GridPanel 預設儲存格文字僅支援水平對齊(align: 'center'),垂直置中需透過 CSS 或 DOM 操作實現。本文提供兩種方案:純 CSS 全域生效與精準 DOM 操作兩種方式。

方案一:CSS 全域覆蓋(推薦,簡潔高效)

在專案樣式檔中加入:

.x-grid3-cell-inner,
.x-grid-cell-inner {
    vertical-align: middle !important;
    line-height: normal !important; /* 避免固定行高干擾 */
    padding-top: 4px !important;
    padding-bottom: 4px !important;
}

/* 若使用行高固定的主題,需同時調整 row 高度 */
.x-grid3-row,
.x-grid-row {
    height: 32px !important; /* 依設計調整 */
}

優點:零 JS 干擾、效能最佳、自動套用動態新增行。
缺點:可能影響其他 Grid,需視專案範圍限定 CSS 選擇器(如加上父容器 ID)。

方案二:Store load 事件精準操作 DOM(原文方案重構)

適用於需針對特定 Grid、特定欄位、或行高不固定的情境。

Grid 設定(保留 id 供查詢)

{
    xtype: 'grid',
    id: 'grid_jglb',
    frame: true,
    region: 'center',
    title: '列表詳細資訊',
    columnLines: true,
    loadMask: true,
    store: 'test_store',
    viewConfig: {
        forceFit: true,
        scrollOffset: 0
    },
    columns: [
        { xtype: 'gridcolumn', id: 'gridcolumn_id', align: 'center', dataIndex: 'COLUMN1', header: '列名1', width: 100 },
        { xtype: 'gridcolumn', align: 'center', dataIndex: 'COLUMN2', header: '列名2', width: 100 },
        { xtype: 'gridcolumn', align: 'center', dataIndex: 'COLUMN3', header: '列名3', width: 100 },
        { xtype: 'gridcolumn', align: 'center', dataIndex: 'COLUMN4', id: 'colidx1', header: '列名4', width: 100 },
        { xtype: 'gridcolumn', align: 'center', dataIndex: 'COLUMN5', hidden: true }
    ],
    bbar: { xtype: 'paging', store: 'test_store', pageSize: 10, displayInfo: true },
    tbar: [
        { text: '新增', iconCls: 'icon-add', id: 'btn_mxxz' },
        '-',
        { text: '修改', iconCls: 'icon-edit', id: 'btn_mxxg' },
        '-',
        { text: '刪除', iconCls: 'icon-delete', id: 'btn_mxsc' }
    ]
}

掛載 load 事件處理器

Ext.getCmp('grid_jglb').getStore().on('load', setTdVerticalAlign);

function setTdVerticalAlign() {
    var gridEl = Ext.getCmp('grid_jglb').getEl();
    if (!gridEl) return;

    // 使用 Ext 查詢替代原生 DOM,相容性更好
    var rows = gridEl.query('.x-grid3-row, .x-grid-row'); // 相容 ExtJS 3/4/5/6 classic

    rows.forEach(function(row) {
        var cells = row.querySelectorAll('td.x-grid3-cell, td.x-grid-cell');
        cells.forEach(function(td) {
            // 跳過第一欄(通常為 RowNumberer 或 CheckboxSelectionModel)
            if (td.cellIndex === 0) return;

            var inner = td.querySelector('.x-grid3-cell-inner, .x-grid-cell-inner');
            if (inner) {
                inner.style.verticalAlign = 'middle';
                inner.style.lineHeight = 'normal';
                inner.style.paddingTop = '4px';
                inner.style.paddingBottom = '4px';
            }
        });
    });
}

方案比較與選擇建議

維度CSS 全域DOM 精準操作
實作複雜度低中
效能極佳(瀏覽器原生渲染)較差(每次 load 遍歷 DOM)
動態資料支援自動生效需確保 load 事件正確綁定
範圍控制需靠選擇器限定精確控制至單一 Grid
主題相容性可能衝突可針對特定主題微調

常見坑點提醒

  • 行高不固定:若資料內容高度不一,單純 vertical-align: middle 可能無效,需搭配 display: flex; align-items: center(現代瀏覽器)或固定行高。
  • ExtJS 版本差異:Classic 工具組類名為 .x-grid-cell,Modern 工具組為 .x-gridcell,選擇器需依版本調整。
  • Buffered Rendering:啟用緩衝渲染時,DOM 節點會回收重用,load 事件可能不觸發,改用 viewrefresh 或 refresh 事件。
  • 編輯模式:編輯器啟用時會插入 input 元素,CSS 方案需額外處理 .x-form-field 垂直置中。

總結

優先採用 方案一(CSS 全域),僅在極特殊需求(單一 Grid、特定欄位、非標準行高)下採用方案二。現代 ExtJS 專案建議透過 SASS 變數($grid-cell-vertical-align: middle)在編譯階段解決,最為乾淨可維護。

copyright © 萬盛學電腦網 all rights reserved