萬盛學電腦網

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

ExtJS GridPanel 隱藏表頭全選框:render 事件移除 CSS 類實現

ExtJS GridPanel 默認在表頭顯示全選複選框(CheckboxSelectionModel)。若需隱藏,可在render事件中通過 DOM 操作移除對應 CSS 類。本文提供最小代碼片段與完整配置示例。

核心代碼片段

var grid = new Ext.grid.GridPanel({
    // ... 其他配置
    selModel: new Ext.grid.CheckboxSelectionModel(), // 必須有選擇模型
    listeners: {
        render: function(grid) {
            // 選中表頭全選框的 div
            var hdChecker = grid.getEl().select('div.x-grid3-hd-checker');
            // 移除類名即可隱藏 (ExtJS 3.x/4.x 經典樣式)
            if (hdChecker.hasClass('x-grid3-hd-checker')) {
                hdChecker.removeClass('x-grid3-hd-checker');
            }
        }
    }
});

原理說明

  • x-grid3-hd-checker 是表頭全選框容器的 CSS 類,控制顯示/隱藏
  • grid.getEl() 獲取 Grid 根元素的 Ext.Element 包裹
  • .select() 使用 Ext 內部選擇器引擎 (類似 querySelectorAll)
  • removeClass 移除類後,瀏覽器重繪自動隱藏該元素

完整可運行示例 (ExtJS 3.4 風格)

<html><head>
<link rel="stylesheet" type="text/css" href="ext/resources/css/ext-all.css" />
<script src="ext/adapter/ext/ext-base.js"></script>
<script src="ext/ext-all.js"></script>
<script>
Ext.onReady(function() {
    var store = new Ext.data.JsonStore({
        fields: ['id', 'name', 'email'],
        data: [
            {id:1, name:'張三', email:'zhang@example.com'},
            {id:2, name:'李四', email:'li@example.com'}
        ]
    });
    
    var sm = new Ext.grid.CheckboxSelectionModel();
    
    var grid = new Ext.grid.GridPanel({
        store: store,
        columns: [
            sm, // 第一列自動是複選框
            {header: 'ID', dataIndex: 'id', width: 50},
            {header: '姓名', dataIndex: 'name', width: 100},
            {header: '郵箱', dataIndex: 'email', width: 200}
        ],
        sm: sm,
        width: 400,
        height: 200,
        renderTo: 'gridDiv',
        listeners: {
            render: function(g) {
                var hd = g.getEl().select('div.x-grid3-hd-checker');
                if (hd.hasClass('x-grid3-hd-checker')) {
                    hd.removeClass('x-grid3-hd-checker');
                }
            }
        }
    });
});
</script></head><body>
<div id="gridDiv"></div>
</body></html>

ExtJS 4/5/6/7 現代版本寫法

// ExtJS 5+ (Classic/Modern Toolkit)
listeners: {
    afterrender: function(grid) {
        // 現代版本類名可能不同,用開發者工具檢查
        var hd = grid.el.select('.x-column-header-checkbox'); // 或 .x-grid-hd-checker
        if (hd.getCount()) hd.removeCls('x-column-header-checkbox');
    }
}

// 或配置選擇模型屬性 (ExtJS 6.2+)
selModel: {
    type: 'checkboxmodel',
    showHeaderCheckbox: false // 直接配置隱藏表頭全選
}

替代方案對比

方案優點缺點適用版本
render移除CSS類無俠入侵、不影響選中邏輯依賴具體CSS類名、版本易變3.x/4.x
showHeaderCheckbox: false官方API、語義清晰、穩定需較新版本支援6.2+
CSS隱藏 .x-grid3-hd-checker {display:none}最簡單、無JS邏輯全局生效、可能影響其他Grid所有
不使用CheckboxSelectionModel根源解決失去行選中複選框功能所有

注意事項

  • 移除表頭全選框不影響行級複選框與getSelection()獲取選中行
  • 若需保留「全選」功能,可自定義工具欄按鈕調用sm.selectAll()
  • Modern Toolkit (ExtJS 6.5+) 類名結構大幅變化,必須用檢查器確認
copyright © 萬盛學電腦網 all rights reserved