DIV CSS 佈局教程網

不修改原始碼也能擴充:重新定義 jQuery 物件的方法
編輯:JQuery特效代碼     

jQuery 是非常優秀的類庫,但它不可能滿足所有情境。當現成方法不夠用時,我們可以重新定義它——關鍵是別弄壞原有功能。

需求場景

我的 web 應用大量以 Ajax 完成資料交換,因此傾向把一些「不需要使用者輸入、但必須送出」的欄位(例如 ID、Timestamp)直接存在標籤屬性裡,而不是多放一組隱藏欄位。

傳統做法:

<input name="ID" value="343" type="hidden" />

改成屬性式寫法:

<div>
  <label data-field="id" data-property="data-id" data-id="343">First Name</label>
  <input type="text" data-field="FirstName" />
</div>

屬性名稱不必太計較,可依專案慣例命名。接下來要做的,是重新定義 val(),讓它同時能讀寫 data-id。

用閉包保留原方法

<script>
$.prototype.val = function (base) {
  return function () {
    var s = this,
        a = "data-property",
        p = s.attr(a),
        isset = arguments.length > 0,
        v = isset ? arguments[0] : null;

    // 呼叫原本的實作,保留原有行為
    if (isset && typeof(base) == "function") {
      base.call(s, v);
    } else {
      v = base.call(s);
    }

    if (p) {
      // 有指定 data-property,改走屬性讀寫
      if (isset) {
        s.attr(p, v);
        return s;
      } else {
        return s.attr(p);
      }
    } else {
      if (!s.is(":input")) {
        // 非表單元素:等同 text()
        if (isset) {
          s.text(v);
          return s;
        } else {
          return s.text();
        }
      } else {
        // 表單元素:維持原本行為
        return isset ? s : v;
      }
    }
  }
}($.prototype.val);   // 把原方法傳進來
</script>

這個技巧的核心是「以閉包包住原始函數」:$.prototype.val 被換成一個新函數,而舊函數作為參數 base 被保存在閉包裡,隨時可以呼叫。什麼時候要呼叫、要不要呼叫,完全由新的業務邏輯決定。

重定義後的行為

  • 標籤上有 data-property 時,val() 等同 attr("data-property")。
  • 沒有指定 data-property 且為非表單元素時,val() 等同 text()。
  • 沒有指定且為表單元素時,完全維持原來的 value 讀寫。

於是這兩行都能運作:

$("[data-field='id']").val(345);   // 寫入 data-id
$("[data-field='id']").val();      // 讀出 345

data-field 這個屬性還能對應到伺服器端同名的資料型別欄位,讓前端 DOM 與後端 model 之間有清楚的映射關係。

完整範例

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>在 JavaScript 中重寫對象的方法</title>
<script src="Scripts/jquery-1.8.2.min.js"></script>
<script>
$.prototype.val = function (base) {
  return function () {
    var s = this, a = "data-property", p = s.attr(a),
        isset = arguments.length > 0, v = isset ? arguments[0] : null;

    if (isset && typeof(base) == "function") { base.call(s, v); }
    else { v = base.call(s); }

    if (p) {
      if (isset) { s.attr(p, v); return s; }
      else { return s.attr(p); }
    } else {
      if (!s.is(":input")) {
        if (isset) { s.text(v); return s; }
        else { return s.text(); }
      } else {
        return isset ? s : v;
      }
    }
  }
}($.prototype.val);
</script>
</head>
<body>
<span id="lbl">Hello world!</span>
<input type="text" id="txt" value="hello world" />
<input type="checkbox" value="哈哈哈。。。" />
</body>
</html>

其他方法的重寫也是同樣思路,讀者可以舉一反三。

不過要提醒一個取捨:覆寫框架內建方法的除錯成本很高,後接手的人也很難察覺 val() 的行為已被改變。若非必要,另開一個語意明確的方法(例如 $.fn.valOrAttr())通常更好。真要覆寫,請務必在註解裡寫清楚原因與行為差異。

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