前段時間同事在群裡對 jQuery 的 .data() 方法大發牢騷:
<a id="a" data-xxx="00123" />
alert($('#a').data('xxx'));// 輸出 123,而非 "00123"
// data 方法不靠譜
於是有人建議老老實實用 attr('data-xxx')。仔細研究 jQuery 文檔對 .data() 方法的描述後,發現這其實是有原因的。
文檔中說明:
As of jQuery 1.4.3, HTML5 data- attributes are automatically pulled in to jQuery's data object. The treatment of attributes with embedded dashes was changed in jQuery 1.6 to conform to the W3C HTML5 specification.
針對如下示例:
<div data-role="page" data-last-value="43" data-hidden="true"
data-options='{"name":"John"}'></div>
$("div").data("role") === "page";
$("div").data("lastValue") === 43;
$("div").data("hidden") === true;
$("div").data("options").name === "John";
也就是說,當使用 .data() 取值時,jQuery 會先嘗試把獲取到的字符串值轉化成對應的 JS 類型,包括布爾值、null、數字、對象、數組:
若值為 "true" 或 "false",返回相應布爾值;若值為 "null",返回 null;若值是由純數字構成的字符串(+data + "" === data),返回相應數字;若值形如 {key:value} 或 [1,2,3],則嘗試用 jQuery.parseJSON 解析。
否則返回原始字符串值。
文檔也特別說明了:如果就是想獲取字符串值、不希望被自動轉換,可以用 .attr("data-" + key) 來獲取:
To retrieve the value's attribute as a string without any attempt to convert it, use the attr() method.
下面是 jQuery 的源碼實現,可以印證上述邏輯:
function dataAttr(elem, key, data) {
// 若內部找不到,則嘗試從 HTML5 data-* 屬性獲取
if (data === undefined && elem.nodeType === 1) {
var name = "data-" + key.replace(rmultiDash, "-$1").toLowerCase();
data = elem.getAttribute(name);
if (typeof data === "string") {
try {
data = data === "true" ? true :
data === "false" ? false :
data === "null" ? null :
// 只有轉數字後字符串不變才轉
+data + "" === data ? +data :
rbrace.test(data) ? jQuery.parseJSON(data) :
data;
} catch (e) {}
jQuery.data(elem, key, data);
} else {
data = undefined;
}
}
return data;
}
所以同事遇到的「00123 變成 123」正是因為前導零被自動轉成了數字。若確實需要保留 "00123" 這樣的字符串原貌,改用 .attr("data-xxx") 即可。理解了這個機制,就能根據實際需求在 .data() 和 .attr() 之間做出正確選擇了。