萬盛學電腦網

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

Ext JS 佈局系統核心誤區:為什麼 Grid 不隨容器自適應?

現象複現

開發者將 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)
  • 佈局管理器負責計算並設置**子組件**的尺寸、位置
  • 直接渲染到 DOM 節點(renderTo 或 el.append())的組件,**不在容器的 items 集合中**,佈局管理器「看不見」它
  • 因此容器 resize 時,不會調用該組件的 setSize/setPosition

正確做法:兩種標準模式

模式一:容器 items 配置(聲明式,推薦)


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();
                }
            }
        }
    }
});

為什麼開發者容易犯錯?

  1. jQuery 思維慣性:習慣 $('#id').append(html) 或 $(el).html(...),認為「放進 div 就是放進容器」
  2. 動態創建困惑:「Grid 配置是後端返回的,怎麼放進容器?」→ 答案:container.add(config)
  3. 不熟悉組件生命周期:以為 render() 就等於「加入佈局」

MVC/MVVM 架構下的最佳實踐


// 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 佈局就不再神秘。

copyright © 萬盛學電腦網 all rights reserved