開發者將 Grid 渲染到容器內一個 <div> 中:
// 錯誤示範
const grid = Ext.create('Ext.grid.Panel', { ... });
grid.render('container-div'); // 渲染到某個 div
// 或
$('#container-div').append(grid.getEl()); // jQuery 方式塞入
結果:調整窗口大小,Grid 尺寸不變,出現滾動條或截斷。
Ext JS 佈局系統只管理「容器的直接子組件」。
Ext.container.Container 及其子類:Panel、Window、Viewport 等)擁有 layout(如 fit、border、vbox、hbox)renderTo 或 el.append())的組件,**不在容器的 items 集合中**,佈局管理器「看不見」它setSize/setPositionitems 配置(聲明式,推薦)
Ext.create('Ext.panel.Panel', {
renderTo: Ext.getBody(),
title: '容器',
layout: 'fit', // 關鍵:fit 佈局讓唯一子組件填滿容器
width: 600,
height: 400,
items: [{
xtype: 'gridpanel', // 直接作為子組件
title: '數據表格',
store: myStore,
columns: [ ... ]
}]
});
container.add()(程式化)
// 1. 獲取容器引用
const container = Ext.getCmp('main-container'); // 或 this.lookupReference('mainContainer')
// 2. 異步獲取配置後創建組件
Ext.Ajax.request({
url: '/api/grid-config',
success: function(response) {
const gridConfig = Ext.decode(response.responseText);
// 3. 通過 add() 添加為子組件(觸發佈局)
const grid = container.add(gridConfig); // 返回創建的組件實例
// 4. 如需立即操作
grid.getStore().load();
}
});
// 或者預先創建好組件再添加
const grid = Ext.create('Ext.grid.Panel', { ... });
container.add(grid); // 關鍵:add() 會自動觸發 doLayout()
loader 自動加載(Ext JS 內建)
Ext.create('Ext.panel.Panel', {
layout: 'fit',
loader: {
url: '/api/grid-config',
autoLoad: true,
scripts: true, // 執行返回腳本
renderer: 'component', // 期望返回組件配置對象
listeners: {
load: function(loader, response, success) {
if (success) {
const grid = loader.getTarget().items.first(); // 獲取加載的子組件
grid.getStore().load();
}
}
}
}
});
$('#id').append(html) 或 $(el).html(...),認為「放進 div 就是放進容器」container.add(config)render() 就等於「加入佈局」
// View 定義
Ext.define('MyApp.view.main.MainContainer', {
extend: 'Ext.container.Container',
xtype: 'maincontainer',
layout: 'fit',
items: [{
xtype: 'gridpanel',
reference: 'dataGrid', // 便於 Controller 獲取
bind: '{gridData}' // MVVM 數據綁定
}]
});
// Controller
Ext.define('MyApp.view.main.MainController', {
extend: 'Ext.app.ViewController',
alias: 'controller.main',
onLoadGrid: function() {
const grid = this.lookupReference('dataGrid');
// grid 已經是容器的子組件,佈局自動管理
grid.getStore().load();
},
onAddDynamicGrid: function(config) {
const container = this.getView();
// 動態添加:移除舊的,添加新的
container.removeAll(true); // true = destroy
container.add(Ext.apply({ xtype: 'gridpanel' }, config));
}
});
| Layout | 用途 | 典型場景 |
|---|---|---|
fit | 單一子組件填滿 | Grid/Tree/Chart 獨佔面板 |
border | 上下左右中五區域 | 經典管理後台:北(頂部)、西(菜單)、中(內容) |
vbox | 垂直排列 | 表單字段堆疊、工具欄垂直 |
hbox | 水平排列 | 按鈕組、卡片橫向排列 |
card | 卡片切換(Tab/向導) | 多步驟表單、Tab 面板內容 |
anchor | 錨點百分比 | 表單字段寬度自適應 |
table | 表格狀排列 | 複雜表單多列對齊 |
// 控制台檢查組件是否在佈局管理中
const container = Ext.getCmp('container-id');
console.log('子組件:', container.items.items); // 應包含你的 Grid
console.log('佈局類:', container.getLayout().$className); // 應為 'Ext.layout.container.Fit' 等
// 強制重新佈局(極少需要)
container.updateLayout();
// 或
Ext.resumeLayouts(true); // 批量操作後恢復佈局
Ext JS 佈局 = 容器管理直接子組件。
只要記住:想要自適應,就要讓組件成為容器的 items 一員(通過配置、add()、loader、MVVM 綁定)。
拒絕 renderTo: 'div-id'、$('#div').append(grid.el)、grid.render('div') 等「繞過佈局系統」的寫法。這是從 jQuery 時代遺留的最大誤區,改掉它,Ext JS 佈局就不再神秘。