DIV CSS 佈局教程網

給 jQuery EasyUI 表單控件綁定額外事件的兩種寫法
編輯:JQuery入門技巧     

EasyUI 的 textbox、combobox 這類控件是「渲染 upgrade 出來的」——它把原始 input 包了一層 span,真正的可見元素不再是那個 input。這導致一個常見困惑:直接給元素綁 click、keydown 沒反應。

比如想給 textbox 加鼠標事件(mouseover、click)或鍵盤事件(keydown、keyup),有兩種可行做法。

方法一:通過 textbox('textbox') 拿到真實 input 再綁定

$('#tt').textbox('textbox').click(function () {
  console.info(123);
});
// 注意這裡必須有 .textbox('textbox')

textbox('textbox') 是 EasyUI 提供的方法,返回值是渲染後真正的那個 input 元素(一個 jQuery 對象)。在它上面綁定事件才是有效的。

這個方法的優點是直觀,缺點是必須在 textbox 初始化之後調用,否則拿不到元素。

方法二:通過 inputEvents 配置項傳入

$('#org').textbox({
  inputEvents: $.extend({}, $.fn.textbox.defaults.inputEvents, {
    click: function () {
      console.info(123);
    }
  })
});

幾個關鍵點:

  • inputEvents 是 textbox 的配置項,專門用於綁定原生事件;
  • $.fn.textbox.defaults.inputEvents 是默認的事件集合,用 $.extend 合併是為了保留默認行為而不把它們覆蓋掉;
  • 如果是其他控件,要把這裡的 textbox 換成對應名字,例如 combobox 用 $.fn.combobox.defaults.inputEvents。

方法二的好處是把事件綁定寫進初始化配置,代碼集中;而且可以在一個 inputEvents 裡傳多個事件,用逗號隔開:

$('#org').textbox({
  inputEvents: $.extend({}, $.fn.textbox.defaults.inputEvents, {
    click: function () { console.info('click'); },
    keydown: function (e) {
      if (e.keyCode === 13) {
        console.info('按下回車');
      }
    },
    blur: function () { console.info('失去焦點'); }
  })
});

幾個實務提醒

  • 為什麼一定要 $.extend 合併默認值。如果直接寫 inputEvents: { click: fn },會把 EasyUI 內部依賴的默認事件處理全部丟掉,可能導致控件行為異常(比如 combobox 的下拉打不開)。
  • 事件裡的 this 指向。這兩種方式綁定的都是原生 input,回調裡的 this 是該 input 的 DOM 節點。要拿 EasyUI 的 API,用 $(this).textbox('getValue') 而不是 $(this).val() 更合適。
  • combobox 的 onSelect 與 inputEvents 的區別。如果只是想在選中某項時做處理,直接用 combobox 自帶的 onSelect 回調就好,不必繞道 inputEvents。inputEvents 適合處理「鍵盤輸入、焦點變化」這類控件沒有現成回調的場景。
  • datebox、combobox 等複合控件同理。它們都繼承自 textbox,因此 xxx('textbox') 這種寫法普遍適用。

兩種方法選哪個取決於代碼組織習慣:偏好「配置集中」用方法二,偏好「後續追加綁定」用方法一。實際項目裡方法二更常見,因為它天然保證了事件綁定發生在初始化時刻,不會出現時序問題。

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