两个方法很相似,但是有区别,简单说一下:
$.data():jq的静态方法,也就是jQuery.data()直接调用
$().data():实例方法,先有实例,才能调用这个方法,例如:$("#id").data("name","zhangsan")
区别:
通过例子说下:
var div1 = $("#d1");
var div2 = $("#d1");
$.data(div1, "name", "zhangsan");
$.data(div2, "name", "lisi");
document.write($.data(div1).name);//zhangsan
document.write($.data(div2).name);//zhangsan
div1.data("name", "zhangsan");
div2.data("name", "lisi");
document.write(div1.data("name"));//lisi
document.write(div2.data("name"));//lisi
顺便说一下他们定义的来源,$.extend(),$.fn.extend();这篇文章讲的不错,大家可以看一下http://caibaojian.com/jquery-extend-and-jquery-fn-extend.html
$.extend():增加全局函数、对象,相当于给jQuery这个类增加了静态方法
$.fn.extend():这个是对jQuery.prototype进得扩展(原来 jQuery.fn = jQuery.prototype),就是为jQuery类添加“成员函数”
ok,进入正题,先来看静态方法:$.data();
举几个例子:
$.data($("#id"),"name","zhangsan");
$.data({},"name","zhangsan");
$.data({},{"name",function(){}});
等等jQuery.extend({
data: function( elem, name, data ) {
return internalData( elem, name, data );
}
...
}
//内部方法
function internalData( elem, name, data, pvt /* Internal Use Only */ ){
//检测这个elem是否可接受数据
if ( !jQuery.acceptData( elem ) ) {
return;
}
var thisCache, ret,
//随机号,jquery加载的时候初始化它,expando: "jQuery" + ( core_version + Math.random() ).replace( /\D/g, "" )
internalKey = jQuery.expando,
//name是string类型为true
getByName = typeof name === "string", // We have to handle DOM nodes and JS objects differently because IE6-7
// can't GC object references properly across the DOM-JS boundary
// 必须区分处理DOM元素和JS对象,因为IE6-7不能垃圾回收对象跨DOM对象和JS对象进行的引用属性(这个目前还不太懂)
isNode = elem.nodeType, // Only DOM nodes need the global jQuery cache; JS object data is
// attached directly to the object so GC can occur automatically
//如果是dom节点,则cache取jq全局的cache,否则取elem本身,这个有点意思
cache = isNode ? jQuery.cache : elem,
// Only defining an ID for JS objects if its cache already exists allows
// the code to shortcut on the same path as a DOM node with no cache
//如果已经存在cache,则直接取,如果不存在则undefined
id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey; // Avoid doing any more work than we need to when trying to get data on an
// object that has no data at all
//对象没有任何数据,直接返回
if ( (!id || !cache[id] || (!pvt && !cache[id].data)) && getByName && data === undefined ) {
return;
}
//id不存在
if ( !id ) {
// Only DOM nodes need a new unique ID for each element since their data
// ends up in the global cache
//如果是dom节点,则添加internalKey/guid这个键值对到elem上,方便以后调用
if ( isNode ) {
elem[ internalKey ] = id = core_deletedIds.pop() || jQuery.guid++;
} else {//非dom节点,比如自己创建的对象{}
id = internalKey;
}
}
//cache[id]不存在则添加一个空对象
if ( !cache[ id ] ) {
cache[ id ] = {}; // Avoids exposing jQuery metadata on plain JS objects when the object
// is serialized using JSON.stringify
//废掉cache[id]的toJSON方法,防止这个对象进行序列化通过toJSON方法,从而暴露jQuery的元数据(还不太理解)
if ( !isNode ) {
cache[ id ].toJSON = jQuery.noop;
}
} // An object can be passed to jQuery.data instead of a key/value pair; this gets
// shallow copied over onto the existing cache
//如果是对象或者函数,则浅克隆它到cache[id]的data属性
if ( typeof name === "object" || typeof name === "function" ) {
if ( pvt ) {
cache[ id ] = jQuery.extend( cache[ id ], name );
} else {
cache[ id ].data = jQuery.extend( cache[ id ].data, name );
}
} thisCache = cache[ id ]; // jQuery data() is stored in a separate object inside the object's internal data
// cache in order to avoid key collisions between internal data and user-defined
// data.
//不是内部元素的话定义赋值cache相关属性
if ( !pvt ) {
//cache[id].data不存在则创建
if ( !thisCache.data ) {
thisCache.data = {};
}
//单独取出data对象
thisCache = thisCache.data;
}
//如果此处data有定义,则把name/data赋值到cache.data的上面,即cache.data={name:data}
if ( data !== undefined ) {
//camelCase这个函数是驼峰函数,进行一些大小写的,如a-and-b-》aAndB
thisCache[ jQuery.camelCase( name ) ] = data;
} // Check for both converted-to-camel and non-converted data property names
// If a data property was specified
如果name是String类型的,则取对应的data值(“zhangsan”),否则返回cache中的data对象({name:funciton(){}})
if ( getByName ) { // First Try to find as-is property data
ret = thisCache[ name ]; // Test for null|undefined property data
if ( ret == null ) { // Try to find the camelCased property
ret = thisCache[ jQuery.camelCase( name ) ];
}
} else {
ret = thisCache;
} return ret;
}
再来看看实例data方法的定义:
jQuery.fn.extend({
data: function( key, value ) {
var attrs, name,
elem = this[0],
i = 0,
data = null; // Gets all values
//当key不存在,data();
if ( key === undefined ) {
if ( this.length ) {
//取elem的缓存
data = jQuery.data( elem );
//如果是element对象并且没有被解析过,如果被解析过,cache中存在{parseAttrs:true}
if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) {
attrs = elem.attributes;
//取所有属性,然后进行遍历
for ( ; i < attrs.length; i++ ) {
name = attrs[i].name;
//查找html5的属性例如data-option
if ( !name.indexOf( "data-" ) ) {
name = jQuery.camelCase( name.slice(5) );
//以驼峰命名的方式,取出那么,并且存到缓存中,data[name]先取缓存,如果存在则不缓存,不存在的话进行缓存
dataAttr( elem, name, data[ name ] );
}
}
//比较已经解析过此elem,设置此元素对应的cache的parseAttrs字段为true
jQuery._data( elem, "parsedAttrs", true );
}
} return data;
} // Sets multiple values
//当key是object类型的时候,例如:{"name":"john"}
if ( typeof key === "object" ) {
//遍历this,用key赋值,通常这里的this都是实例的数组形式
return this.each(function() {
//通过静态方法存储key,这时候这里的this就是dom元素了,有上面的data源码分析可以知道,他是存储在jQuery.cache
//意味着,如果一个再存储一个值,比如{"name":"zhangsan"},则会替换原先的cache的值
jQuery.data( this, key );
});
}
//当key存在且不是object的时候,返回一个函数,这个access中就是参数中function的调用(value值存在的时候调用一次,value值不存在的时候还调用),简单数一下这个参数中的function
return jQuery.access( this, function( value ) {
//value不存在的时候说明是get方法,从缓存中取值
if ( value === undefined ) {
// Try to fetch any internally stored data first
//先用jQuery.data(elem,key)取出值ret,dataAttr判断ret的值,存在则返回,不存在则进一步判断这个key是否是html5元素,是的话取值,并存储
return elem ? dataAttr( elem, key, jQuery.data( elem, key ) ) : null;
} this.each(function() {
//存储key-value
jQuery.data( this, key, value );
});
}, null, value, arguments.length > 1, null, true );
}, removeData: function( key ) {
return this.each(function() {
jQuery.removeData( this, key );
});
}
});
/*
* @param elems jQuery的this
* @param fn 函数
* @param key 属性
* @param value 值
* @param chainable 是否可以链式调用,如果是get动作,为false,如果是set动作,为true
* @param emptyGet 如果jQuery没有选中到元素的返回值
* @param raw value是否为原始数据,如果raw是true,说明value是原始数据,如果是false,说明raw是个函数
* @returns {*}
*/
// Multifunctional method to get and set values of a collection
// The value/s can optionally be executed if it's a function
access: function( elems, fn, key, value, chainable, emptyGet, raw ) {
var i = 0,
length = elems.length,
bulk = key == null; // Sets many values
//这个access方法是复用的,虽然data的方法没传值,其它方法调用如: attr: function (name, value) {return jQuery.access(this, jQuery.attr, name, value, arguments.length > 1);}
if ( jQuery.type( key ) === "object" ) {
chainable = true;
//当key是{"name":"value"}的时候,把链式操作设置为true,然后递归调用access方法
for ( i in key ) {
jQuery.access( elems, fn, i, key[i], true, emptyGet, raw );
} // Sets one value
//key!=object并且value存在(这里包括了key==null)
} else if ( value !== undefined ) {
chainable = true;
//value不是function
if ( !jQuery.isFunction( value ) ) {
raw = true;
}
//key==null
if ( bulk ) {
// Bulk operations run against the entire set
// key==null并且value存在还不是function,调用fn函数,之后设置为null
if ( raw ) {
fn.call( elems, value );
fn = null; // ...except when executing function values
} else {// key==null并且value===function,bulk存储原来的fn函数,fn指向一个新函数(返回bulk函数的调用,即原来fn的调用)
bulk = fn;
fn = function( elem, key, value ) {
return bulk.call( jQuery( elem ), value );
};
}
}
//如果fn存在,无论是否被修改过,即fn的指向是否有变
if ( fn ) {
for ( ; i < length; i++ ) {//循环elems调用fn
fn( elems[i], key,
raw ? value :
//value不是function的话直接取value,是function则直接调用,下面摘录一下网上的解释,引用的attr的方法,如下:
/**
attr: function (name, value) {
return jQuery.access(this, jQuery.attr, name, value, arguments.length > 1);
},
* 如果value是原始数据,就取value,如果是个函数,就调用这个函数取值
* $('#box').attr('abc',function (index,value) { index指向当前元素的索引,value指向oldValue
*
* 先调用jQuery.attr(elements[i],key) 取到当前的值,然后调用传入的fn值
* });
*/
value.call( elems[i], i, fn( elems[i], key ) ) );
}
}
}
/**引用一下网上的解释
* 如果chainable为true,说明是个set方法,就返回elems
* 否则说明是get方法
* 1.如果bulk是个true,说明没有key值,调用fn,将elems传进去
* 2.如果bulk为false,说明key有值哦,然后判断元素的长度是否大于0
* 2.1 如果大于0,调用fn,传入elems[0]和key,完成get
* 2.2 如果为0,说明传参有问题,返回指定的空值emptyGet
*/
return chainable ?
elems : // Gets
bulk ?
fn.call( elems ) :
length ? fn( elems[0], key ) : emptyGet;
}
看完源码之后,你会发现,两个data的方法本质是一样的,实例方法是静态方法的扩展,底层存储读取还是掉用的静态方法
随机推荐
-
浏览器网页判断手机是否安装IOS/Android客户端程序
IOS 原理如下: 为HTML页面中的超链接点击事件增加一个setTimeout方法. 如果在iPhone上面500ms内,本机有应用程序能解析这个协议并打开程序,则这个回调方法失效: 如果本机没有应 ...
-
runtime运行机制方法学习
runtime这玩意第一次听说时都不知道是什么,经过了解后才知道它就是oc动态语言的机制,没有它那oc就不能称为动态语言.在之前可能大家对runtime了解都不深,随着编程技能的日益加深和需要,大家开 ...
-
shell Builtin variables(shell内建变量)
内容来自:abs-guide $BASH The path to the Bash binary itself bash$ echo $BASH /bin/bash $BASH_ENV An envi ...
-
UITabBarController的创建等基本方法
#import "AppDelegate.h" @interface AppDelegate () <UITabBarControllerDelegate> @end ...
-
dot.js教程文档api
dot.js是一个短小精悍的js模板引擎,压缩版仅有4K大小,最近使用dot的时候整理出这个dot.js教程文档,其实称不上什么教程,只是对dot.js的介绍和实例,希望能帮助到一部分需要的人. 使用 ...
-
(转)java 从jar包中读取资源文件
(转)java 从jar包中读取资源文件 博客分类: java 源自:http://blog.csdn.net/b_h_l/article/details/7767829 在代码中读取一些资源文件 ...
-
Patterns for application development with ASP.NET Core
此文章翻译自 NDC { London } 16-20 January 2017 上, Damian Edwards和David Fowler的演讲,如果翻译不周,请大家指出错误. Logging 生 ...
-
Linux Capability探索实验
Linux内核从2.1版本开始,就开始支持Capabilities的安全机制.Capabilities安全机制提出的目的在于实现系统特权操作的更加细粒度的访问控制,使用户能够根据实际的安全需求来控制r ...
-
Spring Boot中application.yml与bootstrap.yml的区别(转载)
说明:其实yml和properties文件是一样的原理,主要是说明application和bootstrap的加载顺序.且一个项目上要么yml或者properties,二选一的存在. Bootstra ...
-
调试cnn-Sentence-Classifier遇到的问题
运行train文件训练模型出现了以下错误: train文件在app文件目录下: raw_vectors.txt文件则在cnn-Sentence-Classifier目录下: 这是train代码调用re ...