DIV CSS 佈局教程網

Ext JS 4 類的定義與擴充:define、override 與實際元件範例
編輯:JavaScript綜合知識     

Ext JS 4 引入了統一的類別系統,Ext.define 負責定義、Ext.override 負責擴充。搞懂這兩個方法,後面的元件開發、權限控制、表單面板都有共通套路。

一、定義一個類並賦予方法

Ext.define('Simple.Class', {
  welcome: function () {
    alert('Welcome to the app');
  }
});

注意:在 define 的設定物件裡,方法要寫成 名稱: function(){},不能寫成 function 名稱(){}。

二、用 override 擴充既有類

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 的商業授權與社群版功能差異,是選型時要先確認的前提;而现代專案若無特別的企業級元件需求,这套寫法的學習成本需要與替代方案一并評估。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved