jquery/src/data.js

210 lines
4.6 KiB
JavaScript
Raw Normal View History

(function( jQuery ) {
var windowData = {},
rbrace = /^(?:\{.*\}|\[.*\])$/;
2009-11-25 18:09:53 +01:00
jQuery.extend({
cache: {},
// Please use with caution
uuid: 0,
// Unique for each copy of jQuery on the page
expando: "jQuery" + jQuery.now(),
2009-11-25 18:09:53 +01:00
// The following elements throw uncatchable exceptions if you
// attempt to add expando properties to them.
noData: {
"embed": true,
// Ban all objects except for Flash (which handle expandos)
"object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",
"applet": true
},
2009-11-25 18:09:53 +01:00
data: function( elem, name, data ) {
if ( !jQuery.acceptData( elem ) ) {
return;
}
2009-11-25 18:09:53 +01:00
elem = elem == window ?
windowData :
elem;
var id = elem[ jQuery.expando ], cache = jQuery.cache, thisCache,
isNode = elem.nodeType,
store;
2009-11-25 18:09:53 +01:00
if ( !id && typeof name === "string" && data === undefined ) {
return;
2009-11-25 18:09:53 +01:00
}
// Get the data from the object directly
if ( !isNode ) {
cache = elem;
id = jQuery.expando;
2009-11-25 18:09:53 +01:00
// Compute a unique ID for the element
} else if ( !id ) {
elem[ jQuery.expando ] = id = ++jQuery.uuid;
2009-11-25 18:09:53 +01:00
}
// Avoid generating a new cache unless none exists and we
// want to manipulate it.
if ( typeof name === "object" ) {
if ( isNode ) {
cache[ id ] = jQuery.extend(cache[ id ], name);
} else {
store = jQuery.extend(cache[ id ], name);
cache[ id ] = function() {
return store;
};
}
} else if ( !cache[ id ] ) {
if ( isNode ) {
cache[ id ] = {};
} else {
store = {};
cache[ id ] = function() {
return store;
};
}
2009-11-25 18:09:53 +01:00
}
thisCache = isNode ? cache[ id ] : cache[ id ]();
2009-11-25 18:09:53 +01:00
// Prevent overriding the named cache with undefined values
if ( data !== undefined ) {
thisCache[ name ] = data;
}
return typeof name === "string" ? thisCache[ name ] : thisCache;
2009-11-25 18:09:53 +01:00
},
removeData: function( elem, name ) {
if ( !jQuery.acceptData( elem ) ) {
return;
}
2009-11-25 18:09:53 +01:00
elem = elem == window ?
windowData :
elem;
var isNode = elem.nodeType,
id = elem[ jQuery.expando ], cache = jQuery.cache;
if ( id && !isNode ) {
id = id();
}
var thisCache = cache[ id ];
2009-11-25 18:09:53 +01:00
// If we want to remove a specific section of the element's data
if ( name ) {
if ( thisCache ) {
// Remove the section of cache data
delete thisCache[ name ];
// If we've removed all the data, remove the element's cache
if ( jQuery.isEmptyObject(thisCache) ) {
jQuery.removeData( elem );
}
}
// Otherwise, we want to remove all of the element's data
} else {
if ( jQuery.support.deleteExpando || !isNode ) {
delete elem[ jQuery.expando ];
} else if ( elem.removeAttribute ) {
elem.removeAttribute( jQuery.expando );
2009-11-25 18:09:53 +01:00
}
// Completely remove the data cache
if ( isNode ) {
delete cache[ id ];
}
2009-11-25 18:09:53 +01:00
}
},
// A method for determining if a DOM node can handle the data expando
acceptData: function( elem ) {
if ( elem.nodeName ) {
match = jQuery.noData[ elem.nodeName.toLowerCase() ];
if ( match ) {
return !(match === true || elem.getAttribute("classid") !== match);
}
}
return true;
2009-11-25 18:09:53 +01:00
}
});
jQuery.fn.extend({
data: function( key, value ) {
if ( typeof key === "undefined" ) {
return this.length ? jQuery.data( this[0] ) : null;
} else if ( typeof key === "object" ) {
return this.each(function() {
jQuery.data( this, key );
});
2009-11-25 18:09:53 +01:00
}
var parts = key.split(".");
parts[1] = parts[1] ? "." + parts[1] : "";
if ( value === undefined ) {
var data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]);
// Try to fetch any internally stored data first
if ( data === undefined && this.length ) {
2009-11-25 18:09:53 +01:00
data = jQuery.data( this[0], key );
// If nothing was found internally, try to fetch any
// data from the HTML5 data-* attribute
if ( data === undefined && this[0].nodeType === 1 ) {
data = this[0].getAttribute( "data-" + key );
if ( typeof data === "string" ) {
try {
data = data === "true" ? true :
data === "false" ? false :
data === "null" ? null :
!jQuery.isNaN( data ) ? parseFloat( data ) :
rbrace.test( data ) ? jQuery.parseJSON( data ) :
data;
} catch( e ) {}
} else {
data = undefined;
}
}
}
2009-11-25 18:09:53 +01:00
return data === undefined && parts[1] ?
this.data( parts[0] ) :
data;
} else {
return this.each(function() {
var $this = jQuery( this ), args = [ parts[0], value ];
$this.triggerHandler( "setData" + parts[1] + "!", args );
2009-11-25 18:09:53 +01:00
jQuery.data( this, key, value );
$this.triggerHandler( "changeData" + parts[1] + "!", args );
2009-11-25 18:09:53 +01:00
});
}
2009-11-25 18:09:53 +01:00
},
removeData: function( key ) {
return this.each(function() {
2009-11-25 18:09:53 +01:00
jQuery.removeData( this, key );
});
}
});
})( jQuery );