src/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         data: function( elem, name, data ) {
  10                 elem = elem == window ?
  11                         windowData :
  12                         elem;
  13
  14                 var id = elem[ expando ], cache = jQuery.cache, thisCache;
  15
  16                 // Handle the case where there's no name immediately
  17                 if ( !name && !id ) {
  18                         return null;
  19                 }
  20
  21                 // Compute a unique ID for the element
  22                 if ( !id ) {
  23                         id = ++uuid;
  24                 }
  25
  26                 // Avoid generating a new cache unless none exists and we
  27                 // want to manipulate it.
  28                 if ( cache[ id ] ) {
  29                         thisCache = cache[ id ];
  30                 } else if ( typeof data === "undefined" ) {
  31                         thisCache = emptyObject;
  32                 } else {
  33                         thisCache = cache[ id ] = {};
  34                 }
  35
  36                 // Prevent overriding the named cache with undefined values
  37                 if ( data !== undefined ) {
  38                         elem[ expando ] = id;
  39                         thisCache[ name ] = data;
  40                 }
  41
  42                 return name ? thisCache[ name ] : thisCache;
  43         },
  44
  45         removeData: function( elem, name ) {
  46                 elem = elem == window ?
  47                         windowData :
  48                         elem;
  49
  50                 var id = elem[ expando ], cache = jQuery.cache, thisCache = cache[ id ];
  51
  52                 // If we want to remove a specific section of the element's data
  53                 if ( name ) {
  54                         if ( thisCache ) {
  55                                 // Remove the section of cache data
  56                                 delete thisCache[ name ];
  57
  58                                 // If we've removed all the data, remove the element's cache
  59                                 if ( jQuery.isEmptyObject(thisCache) ) {
  60                                         jQuery.removeData( elem );
  61                                 }
  62                         }
  63
  64                 // Otherwise, we want to remove all of the element's data
  65                 } else {
  66                         // Clean up the element expando
  67                         try {
  68                                 delete elem[ expando ];
  69                         } catch( e ) {
  70                                 // IE has trouble directly removing the expando
  71                                 // but it's ok with using removeAttribute
  72                                 if ( elem.removeAttribute ) {
  73                                         elem.removeAttribute( expando );
  74                                 }
  75                         }
  76
  77                         // Completely remove the data cache
  78                         delete cache[ id ];
  79                 }
  80         },
  81
  82         queue: function( elem, type, data ) {
  83                 if( !elem ) return;
  84
  85                 type = (type || "fx") + "queue";
  86                 var q = jQuery.data( elem, type );
  87
  88                 // Speed up dequeue by getting out quickly if this is just a lookup
  89                 if( !data ) return q || [];
  90
  91                 if ( !q || jQuery.isArray(data) )
  92                         q = jQuery.data( elem, type, jQuery.makeArray(data) );
  93                 else
  94                         q.push( data );
  95
  96                 return q;
  97         },
  98
  99         dequeue: function( elem, type ){
 100                 type = type || "fx";
 101
 102                 var queue = jQuery.queue( elem, type ), fn = queue.shift();
 103
 104                 // If the fx queue is dequeued, always remove the progress sentinel
 105                 if( fn === "inprogress" ) fn = queue.shift();
 106
 107                 if( fn ) {
 108                         // Add a progress sentinel to prevent the fx queue from being
 109                         // automatically dequeued
 110                         if( type == "fx" ) queue.unshift("inprogress");
 111
 112                         fn.call(elem, function() { jQuery.dequeue(elem, type); });
 113                 }
 114         }
 115 });
 116
 117 jQuery.fn.extend({
 118         data: function( key, value ){
 119                 if ( typeof key === "undefined" && this.length ) {
 120                         return jQuery.data( this[0] );
 121                 }
 122
 123                 var parts = key.split(".");
 124                 parts[1] = parts[1] ? "." + parts[1] : "";
 125
 126                 if ( value === undefined ) {
 127                         var data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]);
 128
 129                         if ( data === undefined && this.length )
 130                                 data = jQuery.data( this[0], key );
 131
 132                         return data === undefined && parts[1] ?
 133                                 this.data( parts[0] ) :
 134                                 data;
 135                 } else
 136                         return this.trigger("setData" + parts[1] + "!", [parts[0], value]).each(function(){
 137                                 jQuery.data( this, key, value );
 138                         });
 139         },
 140
 141         removeData: function( key ){
 142                 return this.each(function(){
 143                         jQuery.removeData( this, key );
 144                 });
 145         },
 146         queue: function(type, data){
 147                 if ( typeof type !== "string" ) {
 148                         data = type;
 149                         type = "fx";
 150                 }
 151
 152                 if ( data === undefined )
 153                         return jQuery.queue( this[0], type );
 154
 155                 return this.each(function(i, elem){
 156                         var queue = jQuery.queue( this, type, data );
 157
 158                         if( type == "fx" && queue[0] !== "inprogress" )
 159                                 jQuery.dequeue( this, type )
 160                 });
 161         },
 162         dequeue: function(type){
 163                 return this.each(function(){
 164                         jQuery.dequeue( this, type );
 165                 });
 166         },
 167         clearQueue: function(type){
 168                 return this.queue( type || "fx", [] );
 169         }
 170 });