Ext JS 4 引入了統一的類別系統,Ext.define 負責定義、Ext.override 負責擴充。搞懂這兩個方法,後面的元件開發、權限控制、表單面板都有共通套路。
Ext.define('Simple.Class', {
welcome: function () {
alert('Welcome to the app');
}
});
注意:在 define 的設定物件裡,方法要寫成 名稱: function(){},不能寫成 function 名稱(){}。
Ext.override(Simple.Class, {
goodBye: function () {
alert('Goodbye');
},
funAll: function () {
this.welcome();
this.goodBye();
}
});
擴充後即可實例化並呼叫新方法:
var app = new Simple.Class();
app.funAll(); // Welcome to the app → Goodbye
另一種等價寫法是把 override 掛在類別上:
Simple.Class.override({
// 新的成員
});
補充一點:Ext JS 4 之後官方建議改用 Ext.define 搭配 override 設定項,Ext.override() 這個全域方法已屬舊寫法:
Ext.define('Simple.Class', {
welcome: function () { alert('Welcome to the app'); }
}, function () {
// 第三個參數是 callback,類別建立完成後執行
});
Ext.define('Simple.Class.override', {
override: 'Simple.Class',
goodBye: function () { alert('Goodbye'); }
});
Ext.define('MyButton', {
extend: 'Ext.Action',
initComponent: function () {
var me = this;
var initEnable = true; // 初始權限
}
});
Ext.override(MyButton, {
mysetenable: function (b) { // 自定義函式:依權限決定啟用或停用
if (this.initEnable) {
if (b) { this.enable(); }
else { this.disable(); }
} else {
this.disable();
}
}
});
這個模式很實用:把「能不能按」的判斷邏輯集中在一個方法裡,各頁面只要呼叫 btn.mysetenable(hasPermission),不必在每個地方重寫 if 判斷。
Ext.define('PO_Head_Add_Panel', {
extend: 'Ext.form.Panel',
alias: 'widget.PO_Head_Add_Panel',
frame: true,
layout: 'anchor',
bodyPadding: 5,
defaults: { // 統一設定所有欄位的預設屬性
labelSeparator: ':',
labelWidth: 60,
allowBlank: false,
labelAlign: 'right',
msgTarget: 'qtip' // 以浮動提示顯示錯誤
},
items: [{
xtype: 'combobox',
name: 'ToAddress',
labelWidth: 70,
width: 600,
queryMode: 'local',
store: TmpAddressStore,
displayField: 'AddrName',
valueField: 'AddrName',
editable: false, // 不允許手動輸入
forceSelection: true, // 必須從清單中選擇
msgTarget: 'side',
allowBlank: false,
fieldLabel: '送貨地址'
}, {
xtype: 'textfield',
name: 'HRemark',
labelWidth: 70,
width: 600,
msgTarget: 'side',
allowBlank: false,
fieldLabel: '備注'
}],
initComponent: function () {
var me = this;
var PoType = ''; // 可定義屬性,以 obj.PoType 取用
var TmpHeadRec = Ext.create('PO_HeadData');
Ext.apply(this, {
buttons: [{
text: '保存',
handler: function () {
if (me.getForm().isValid()) { // 驗證是否通過
// 保存功能
}
}
}, {
text: '取消',
handler: function () {
me.ownerCt.hide();
}
}],
SetFormValue: function () { // 自定義方法,以 obj.SetFormValue() 呼叫
me.TmpHeadRec = HeadStore.getAt(0);
me.getForm().findField('POType').setValue(me.TmpHeadRec.get('POType'));
me.getForm().findField('PONum').setValue(me.TmpHeadRec.get('PONum'));
}
});
this.callParent(arguments); // 記得呼叫父類別的 initComponent
}
});
alias: 'widget.xxx' 讓這個類能用 xtype 懶加载方式引用。defaults 統一管理子欄位外觀,不必每個欄位重複寫。msgTarget 的常見值:qtip(浮動提示)、title(瀏覽器原生提示)、under(欄位下方)、side(右側)、none(不顯示)、errorMsg(指定元素)。callParent(arguments) 不可省略,否則父類別的初始化流程會中斷,元件可能無法正常渲染。me 的用途是解決 this 指向問題:在 handler 這類回呼函式裡,this 往往不是元件本身,用閉包捕住的 me 才保險。最後提醒:Ext JS 的商業授權與社群版功能差異,是選型時要先確認的前提;而现代專案若無特別的企業級元件需求,这套寫法的學習成本需要與替代方案一并評估。