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 移除類後,瀏覽器重繪自動隱藏該元素<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 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()