在 jQuery 中,可以对每一个 DOM 对象保存私有的数据。
这个数据当然要通过属性来进行存取,但是,有多个属性怎么办呢?,要定义多个属性吗?,属性的名字叫什么呢?会不会与其他的属性有冲突呢?
在 jQuery 中,针对 DOM 对象扩展的私有数据可以用一个对象来表示,多个数据就使用这个对象的多个属性来表示。为了能够通过 DOM 对象找到这个扩展数据对象,而不会与其他现有的属性冲突,在 jQuery 中通过 expando 这个常量表示扩展对象的属性名,这个 expando 的值是计算出来的。而这个属性的值就是用来找到扩展对象的键值。
例如,我们可以定义 expando 的值为 "jQuery1234" ,那么,我们可以为每个 DOM 对象增加这个名为 "jQuery1234" 的属性,这个属性的值可以是一个键,例如为 1000。
在 jQuery 对象上的 cache 用来保存所有对象扩展的对象,这个对象可以看作一个字典,属性名就是键值,所对应的值就是扩展数据对象。
也就是说,在 jQuery 对象的 cache 上,将会有一个 1000 的成员,这个成员引用的对象就是 1000 号 DOM 对象的私有扩展对象。1000 号成员的私有数据将被存在在这个对象上。
当一个 DOM 对象需要取得扩展数据的时候,首先通过对象的 expando 属性取得一个键值,然后通过这个键值到 jQuery.cache 中取得自己的扩展对象,然后在扩展对象上读写数据。
1 /// <reference path="jQuery-core.js" />
2
3 // 常用方法
4 function now() {
5 return (new Date).getTime();
6 }
7
8 // 扩充数据的属性名,动态生成,避免与已有的属性冲突
9 var expando = "jQuery" + now(), uuid = 0, windowData = {};
10 jQuery.cache = {};
11 jQuery.expando = expando;
12
13 // 数据管理,可以针对 DOM 对象保存私有的数据,可以读取保存的数据
14 jQuery.fn.data = function (key, value) {
15
16 // 读取
17 if (value === undefined) {
18 return jQuery.data(this[0], key);
19 }
20 else { // 设置
21
22 this.each(
23 function () {
24 jQuery.data(this, key, value);
25 }
26 );
27 }
28 }
29 // 移除数据,删除保存在对象上的数据
30 jQuery.fn.removeData = function (key) {
31 return this.each(function () {
32 jQuery.removeData(this, key);
33 })
34 }
35
36
37 // 为元素保存数据
38 jQuery.data = function (elem, name, data) { // #1001
39
40 // 取得元素保存数据的键值
41 var id = elem[expando], cache = jQuery.cache, thisCache;
42
43 // 没有 id 的情况下,无法取值
44 if (!id && typeof name === "string" && data === undefined) {
45 return null;
46 }
47
48 // Compute a unique ID for the element
49 // 为元素计算一个唯一的键值
50 if (!id) {
51 id = ++uuid;
52 }
53
54 // 如果没有保存过
55 if (!cache[id]) {
56 elem[expando] = id; // 在元素上保存键值
57 cache[id] = {}; // 在 cache 上创建一个对象保存元素对应的值
58 }
59
60 // 取得此元素的数据对象
61 thisCache = cache[id];
62
63 // Prevent overriding the named cache with undefined values
64 // 保存值
65 if (data !== undefined) {
66 thisCache[name] = data;
67 }
68
69 // 返回对应的值
70 return typeof name === "string" ? thisCache[name] : thisCache;
71
72 }
73
74 // 删除保存的数据
75 jQuery.removeData = function (elem, name) { // #1042
76
77 var id = elem[expando], cache = jQuery.cache, thisCache = cache[id];
78
79 // If we want to remove a specific section of the element's data
80 if (name) {
81 if (thisCache) {
82 // Remove the section of cache data
83 delete thisCache[name];
84
85 // If we've removed all the data, remove the element's cache
86 if (jQuery.isEmptyObject(thisCache)) {
87 jQuery.removeData(elem);
88 }
89 }
90
91 // Otherwise, we want to remove all of the element's data
92 } else {
93
94 delete elem[jQuery.expando];
95
96 // Completely remove the data cache
97 delete cache[id];
98 }
99 }
100
101 // 检查对象是否是空的
102 jQuery.isEmptyObject = function (obj) {
103 // 遍历元素的属性,只有要属性就返回假,否则返回真
104 for (var name in obj) {
105 return false;
106 }
107 return true;
108
109 }
110
111 // toString 是 jQuery 中定义的一个变量 #68
112 // hasOwnProperty #69
113
114 // 检查是否是一个函数
115 jQuery.isFunction = function (obj) {
116 return toString.call(obj) === "[object Function]";
117 }
118
119 // 检查是否为一个数组
120 jQuery.isArray = function( obj ) {
121 return toString.call(obj) === "[object Array]";
122 }
123
124 // 是否是纯粹的 js 对象,而不是 DOM 对象,或者 window 对象
125 jQuery.isPlainObject = function( obj ) {
126 // Must be an Object.
127 // Because of IE, we also have to check the presence of the constructor property.
128 // Make sure that DOM nodes and window objects don't pass through, as well
129 if ( !obj || toString.call(obj) !== "[object Object]" || obj.nodeType || obj.setInterval ) {
130 return false;
131 }
132
133 // Not own constructor property must be Object
134 if ( obj.constructor
135 && !hasOwnProperty.call(obj, "constructor")
136 && !hasOwnProperty.call(obj.constructor.prototype, "isPrototypeOf") ) {
137 return false;
138 }
139
140 // Own properties are enumerated firstly, so to speed up,
141 // if last one is own, then all properties are own.
142
143 var key;
144 for ( key in obj ) {}
145
146 return key === undefined || hasOwnProperty.call( obj, key );
147 }
148
2
3 // 常用方法
4 function now() {
5 return (new Date).getTime();
6 }
7
8 // 扩充数据的属性名,动态生成,避免与已有的属性冲突
9 var expando = "jQuery" + now(), uuid = 0, windowData = {};
10 jQuery.cache = {};
11 jQuery.expando = expando;
12
13 // 数据管理,可以针对 DOM 对象保存私有的数据,可以读取保存的数据
14 jQuery.fn.data = function (key, value) {
15
16 // 读取
17 if (value === undefined) {
18 return jQuery.data(this[0], key);
19 }
20 else { // 设置
21
22 this.each(
23 function () {
24 jQuery.data(this, key, value);
25 }
26 );
27 }
28 }
29 // 移除数据,删除保存在对象上的数据
30 jQuery.fn.removeData = function (key) {
31 return this.each(function () {
32 jQuery.removeData(this, key);
33 })
34 }
35
36
37 // 为元素保存数据
38 jQuery.data = function (elem, name, data) { // #1001
39
40 // 取得元素保存数据的键值
41 var id = elem[expando], cache = jQuery.cache, thisCache;
42
43 // 没有 id 的情况下,无法取值
44 if (!id && typeof name === "string" && data === undefined) {
45 return null;
46 }
47
48 // Compute a unique ID for the element
49 // 为元素计算一个唯一的键值
50 if (!id) {
51 id = ++uuid;
52 }
53
54 // 如果没有保存过
55 if (!cache[id]) {
56 elem[expando] = id; // 在元素上保存键值
57 cache[id] = {}; // 在 cache 上创建一个对象保存元素对应的值
58 }
59
60 // 取得此元素的数据对象
61 thisCache = cache[id];
62
63 // Prevent overriding the named cache with undefined values
64 // 保存值
65 if (data !== undefined) {
66 thisCache[name] = data;
67 }
68
69 // 返回对应的值
70 return typeof name === "string" ? thisCache[name] : thisCache;
71
72 }
73
74 // 删除保存的数据
75 jQuery.removeData = function (elem, name) { // #1042
76
77 var id = elem[expando], cache = jQuery.cache, thisCache = cache[id];
78
79 // If we want to remove a specific section of the element's data
80 if (name) {
81 if (thisCache) {
82 // Remove the section of cache data
83 delete thisCache[name];
84
85 // If we've removed all the data, remove the element's cache
86 if (jQuery.isEmptyObject(thisCache)) {
87 jQuery.removeData(elem);
88 }
89 }
90
91 // Otherwise, we want to remove all of the element's data
92 } else {
93
94 delete elem[jQuery.expando];
95
96 // Completely remove the data cache
97 delete cache[id];
98 }
99 }
100
101 // 检查对象是否是空的
102 jQuery.isEmptyObject = function (obj) {
103 // 遍历元素的属性,只有要属性就返回假,否则返回真
104 for (var name in obj) {
105 return false;
106 }
107 return true;
108
109 }
110
111 // toString 是 jQuery 中定义的一个变量 #68
112 // hasOwnProperty #69
113
114 // 检查是否是一个函数
115 jQuery.isFunction = function (obj) {
116 return toString.call(obj) === "[object Function]";
117 }
118
119 // 检查是否为一个数组
120 jQuery.isArray = function( obj ) {
121 return toString.call(obj) === "[object Array]";
122 }
123
124 // 是否是纯粹的 js 对象,而不是 DOM 对象,或者 window 对象
125 jQuery.isPlainObject = function( obj ) {
126 // Must be an Object.
127 // Because of IE, we also have to check the presence of the constructor property.
128 // Make sure that DOM nodes and window objects don't pass through, as well
129 if ( !obj || toString.call(obj) !== "[object Object]" || obj.nodeType || obj.setInterval ) {
130 return false;
131 }
132
133 // Not own constructor property must be Object
134 if ( obj.constructor
135 && !hasOwnProperty.call(obj, "constructor")
136 && !hasOwnProperty.call(obj.constructor.prototype, "isPrototypeOf") ) {
137 return false;
138 }
139
140 // Own properties are enumerated firstly, so to speed up,
141 // if last one is own, then all properties are own.
142
143 var key;
144 for ( key in obj ) {}
145
146 return key === undefined || hasOwnProperty.call( obj, key );
147 }
148
下面的脚本可以保存或者读取对象的扩展数据。
1 // 数据操作
2 $("#msg").data("name", "Hello, world.");
3 alert($("#msg").data("name"));
4 $("#msg").removeData("name");
5 alert($("#msg").data("name"));
2 $("#msg").data("name", "Hello, world.");
3 alert($("#msg").data("name"));
4 $("#msg").removeData("name");
5 alert($("#msg").data("name"));