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()。於是這兩行都能運作:
$("[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())通常更好。真要覆寫,請務必在註解裡寫清楚原因與行為差異。