69adc1239b107611031666633ec5624a860b61a5
[jquery.git] / data.js
1 var expando = "jQuery" + now(), uuid = 0, windowData = {};
2 var emptyObject = {};
3
4 jQuery.extend({
5         cache: {},
6         
7         expando:expando,
8
9         // The following elements throw uncatchable exceptions if you
10         // attempt to add expando properties to them.
11         noData: {
12                 "embed": true,
13                 "object": true,
14                 "applet": true
15         },
16
17         data: function( elem, name, data ) {
18                 if ( elem.nodeName && jQuery.noData[elem.nodeName.toLowerCase()] ) {
19                         return;
20                 }
21
22                 elem = elem == window ?
23                         windowData :
24                         elem;
25
26                 var id = elem[ expando ], cache = jQuery.cache, thisCache;
27
28                 // Handle the case where there's no name immediately
29                 if ( !name && !id ) {
30                         return null;
31                 }
32
33                 // Compute a unique ID for the element
34                 if ( !id ) { 
35                         id = ++uuid;
36                 }
37
38                 // Avoid generating a new cache unless none exists and we
39                 // want to manipulate it.
40                 if ( typeof name === "object" ) {
41                         elem[ expando ] = id;
42                         thisCache = cache[ id ] = jQuery.extend(true, {}, name);
43                 } else if ( cache[ id ] ) {
44                         thisCache = cache[ id ];
45                 } else if ( typeof data === "undefined" ) {
46                         thisCache = emptyObject;
47                 } else {
48                         thisCache = cache[ id ] = {};
49                 }
50
51                 // Prevent overriding the named cache with undefined values
52                 if ( data !== undefined ) {
53                         elem[ expando ] = id;
54                         thisCache[ name ] = data;
55                 }
56
57                 return typeof name === "string" ? thisCache[ name ] : thisCache;
58         },
59
60         removeData: function( elem, name ) {
61                 if ( elem.nodeName && jQuery.noData[elem.nodeName.toLowerCase()] ) {
62                         return;
63                 }
64
65                 elem = elem == window ?
66                         windowData :
67                         elem;
68
69                 var id = elem[ expando ], cache = jQuery.cache, thisCache = cache[ id ];
70
71                 // If we want to remove a specific section of the element's data
72                 if ( name ) {
73                         if ( thisCache ) {
74                                 // Remove the section of cache data
75                                 delete thisCache[ name ];
76
77                                 // If we've removed all the data, remove the element's cache
78                                 if ( jQuery.isEmptyObject(thisCache) ) {
79                                         jQuery.removeData( elem );
80                                 }
81                         }
82
83                 // Otherwise, we want to remove all of the element's data
84                 } else {
85                         // Clean up the element expando
86                         try {
87                                 delete elem[ expando ];
88                         } catch( e ) {
89                                 // IE has trouble directly removing the expando
90                                 // but it's ok with using removeAttribute
91                                 if ( elem.removeAttribute ) {
92                                         elem.removeAttribute( expando );
93                                 }
94                         }
95
96                         // Completely remove the data cache
97                         delete cache[ id ];
98                 }
99         }
100 });
101
102 jQuery.fn.extend({
103         data: function( key, value ){
104                 if ( typeof key === "undefined" && this.length ) {
105                         return jQuery.data( this[0] );
106
107                 } else if ( typeof key === "object" ) {
108                         return this.each(function() {
109                                 jQuery.data( this, key );
110                         });
111                 }
112
113                 var parts = key.split(".");
114                 parts[1] = parts[1] ? "." + parts[1] : "";
115
116                 if ( value === undefined ) {
117                         var data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]);
118
119                         if ( data === undefined && this.length ) {
120                                 data = jQuery.data( this[0], key );
121                         }
122                         return data === undefined && parts[1] ?
123                                 this.data( parts[0] ) :
124                                 data;
125                 } else {
126                         return this.trigger("setData" + parts[1] + "!", [parts[0], value]).each(function(){
127                                 jQuery.data( this, key, value );
128                         });
129                 }
130         },
131
132         removeData: function( key ){
133                 return this.each(function(){
134                         jQuery.removeData( this, key );
135                 });
136         }
137 });