Ext JS 4 引入全新的類系統 (Ext.ClassManager),提供:
requires, uses)config 自動生成 getter/setter)override)Ext.define('MyApp.util.Logger', {
// 類名(必須),用於動態加載與實例化
// 命名規範:命名空間.類名,對應文件路徑 app/util/Logger.js
// 靜態成員
statics: {
LOG_LEVELS: { DEBUG: 1, INFO: 2, WARN: 3, ERROR: 4 },
instanceCount: 0
},
// 配置系統:自動生成 getLevel()/setLevel()、applyLevel()/updateLevel()
config: {
level: 'INFO', // 默認日誌級別
prefix: '[APP]', // 日誌前綴
enabled: true // 是否啟用
},
// 構造函數
constructor: function(config) {
this.initConfig(config); // 處理 config 對象
this.callParent(arguments);
this.self.instanceCount++;
},
// 實例方法
log: function(level, message) {
if (!this.getEnabled()) return;
if (this.self.LOG_LEVELS[level] < this.self.LOG_LEVELS[this.getLevel()]) return;
const args = Array.prototype.slice.call(arguments, 1);
console[level.toLowerCase()](this.getPrefix(), new Date().toISOString(), ...args);
},
// 便捷方法
debug: function() { this.log('DEBUG', ...arguments); },
info: function() { this.log('INFO', ...arguments); },
warn: function() { this.log('WARN', ...arguments); },
error: function() { this.log('ERROR', ...arguments); },
// 私有方法約定:下劃線前綴
_formatMessage: function(args) {
return args.map(a => typeof a === 'object' ? JSON.stringify(a) : a).join(' ');
}
});
// 繼承基礎類
Ext.define('MyApp.util.RemoteLogger', {
extend: 'MyApp.util.Logger', // 單一繼承
// Mixin 混入(多重組合)
mixins: {
observable: 'Ext.util.Observable' // 獲得事件機制
},
requires: [
'Ext.Ajax' // 聲明依賴,構建工具會自動打包
],
config: {
endpoint: '/api/logs', // 新增配置
batchSize: 10 // 批量上傳閾值
},
// 覆寫父類方法
log: function(level, message) {
this.callParent(arguments); // 調用父類實現(控制台輸出)
// 新增:發送到服務端
this._queueLog(level, message);
},
// 私有方法
_queueLog: function(level, message) {
this._buffer = this._buffer || [];
this._buffer.push({ level, message, time: new Date() });
if (this._buffer.length >= this.getBatchSize()) {
this._flush();
}
},
_flush: function() {
if (!this._buffer?.length) return;
Ext.Ajax.request({
url: this.getEndpoint(),
method: 'POST',
jsonData: { logs: this._buffer },
callback: (opts, success, response) => {
if (success) this._buffer = [];
}
});
},
// 覆寫銷毀邏輯
destroy: function() {
this._flush(); // 退出前發送剩餘日誌
this.callParent(arguments);
}
});
Ext JS 提供兩種覆寫方式,適用場景不同:
Ext.override —— 修改現有類(猴子補丁)// 為所有 Grid 添加導出 Excel 功能
Ext.override('Ext.grid.Panel', {
exportToExcel: function(filename) {
// 實現導出邏輯...
console.log('導出:', filename || 'export.xlsx');
}
});
// 現在所有 Grid 實例都有 exportToExcel 方法
var grid = Ext.create('Ext.grid.Panel', { ... });
grid.exportToExcel('report.xlsx');
MyClass.override() —— 類原型鏈覆寫(推薦)// 定義時直接覆寫(Ext JS 4.1+ 推薦寫法)
Ext.define('MyApp.patch.GridExport', {
override: 'Ext.grid.Panel', // 目標類
exportToExcel: function(filename) {
// 實現...
},
// 甚至可以覆寫私有方法
privates: {
_collectData: function() {
// 自定義數據收集邏輯
return this.callParent(arguments); // 仍可調用原方法
}
}
});
requires: ['MyApp.patch.GridExport'] 顯式依賴privates 區塊方法不會被子類繼承,封裝性更好Ext.define('MyApp.view.po.POHeadAddPanel', {
extend: 'Ext.form.Panel',
xtype: 'poheadaddpanel', // 註冊 xtype,便於 layout 配置中使用
// 類級別配置(所有實例共享)
title: '採購單信息',
frame: true,
bodyPadding: 10,
layout: 'anchor',
// 字段默認配置(實例級,每個實例獨立)
defaults: {
labelAlign: 'right',
labelWidth: 80,
anchor: '95%',
msgTarget: 'side', // 驗證提示顯示在側邊
allowBlank: false,
blankText: '此字段不能為空'
},
// 聲明依賴
requires: [
'MyApp.store.TmpAddressStore',
'MyApp.model.POHeadData'
],
items: [{
xtype: 'combobox',
name: 'ToAddress',
fieldLabel: '送貨地址',
labelWidth: 70,
width: 600,
queryMode: 'local',
store: 'TmpAddressStore', // 使用 storeId 或實例
displayField: 'AddrName',
valueField: 'AddrName',
editable: false,
forceSelection: true
}, {
xtype: 'textfield',
name: 'HRemark',
fieldLabel: '備註',
labelWidth: 70,
width: 600
}],
// initComponent:實例化邏輯入口(構造函數之後、渲染之前)
initComponent: function() {
const me = this;
// 實例級私有屬性
me._poType = '';
me._tmpHeadRec = Ext.create('MyApp.model.POHeadData');
// 動態構建按鈕工具欄
Ext.apply(me, {
buttons: [{
text: '保存',
handler: function() {
if (me.getForm().isValid()) {
me.fireEvent('save', me, me.getForm().getValues());
}
}
}, {
text: '取消',
handler: () => me.fireEvent('cancel', me)
}],
// 實例方法:設置表單值
setFormValue: function(record) {
me._tmpHeadRec = record;
me.getForm().setValues({
POType: record.get('POType'),
PONum: record.get('PONum')
});
}
});
me.callParent(arguments); // 必須調用,完成父類初始化
// 組件創建完成後的邏輯
me.on('afterrender', () => {
me.getForm().findField('ToAddress').focus();
});
},
// 靜態方法:工廠模式創建
statics: {
createForEdit: function(record) {
const win = Ext.create('Ext.window.Window', {
title: '編輯採購單',
modal: true,
items: [{ xtype: 'poheadaddpanel' }]
});
win.down('poheadaddpanel').setFormValue(record);
return win;
}
}
});
| 問題 | 原因 | 解決方案 |
|---|---|---|
| config 設置不生效 | 未調用 initConfig() 或屬性名衝突 |
構造函數首行調用 this.initConfig(config);避免與現有屬性同名 |
| override 不生效 | 加載順序錯誤 / 類名拼寫錯誤 | 確保目標類已加載;使用 override: 'Full.Class.Name' 寫法並加入 requires |
| Mixin 方法衝突 | 多個 Mixin 同名方法 | 在類中顯式實現該方法,內部調用 this.mixinName.method() |
| 動態加載失敗 | 路徑映射錯誤 | 配置 Ext.Loader.setPath('MyApp', 'app');檢查文件名大小寫 |
| 內存洩漏 | 未銷毀組件、事件未移除、store 未釋放 | 實現 destroy 調用 callParent;使用 mon 綁定事件 |
ViewModel 雙向綁定 + ViewController 邏輯分離Ext.define 而非 Ext.create:延遲實例化,利用 xtype 配置bind 配置:bind: '{user.name}' 自動響應數據變化Ext JS 類系統是大型企業級應用的基石。掌握 Ext.define、extend、mixins、config、override 五大核心機制,配合 initComponent 生命周期、callParent 父鏈調用、privates 封裝,能構建高內聚、低耦合、可維護的組件體系。現代開發中,結合 MVVM 架構與 Sencha Cmd 工具鏈,能最大化發揮框架效能。