基本理解
jQuery.attr是jQuery.attr,jQuery.prop,jQuery.css提供底层支持,jQuery里一个比较有特色的地方就是函数的重载, 比如attr,有如下几种重载
- $(‘#box‘).attr(‘title‘)
- $(‘#box‘).attr(‘title‘,‘标题‘)
- $(‘#box‘).attr({title:‘标题‘,data-menu-toggle:‘dropdown‘})
- $(‘#box‘).attr(‘title‘,function () {....})
但是纵观jQuery.attr代码中,却没有判断value是不是存在啊之类的,ok,你猜对了,在access里实现了
jQuery.fn.extend({ attr: function (name, value) { return jQuery.access(this, jQuery.attr, name, value, arguments.length > 1); }, removeAttr: function (name) { return this.each(function () { jQuery.removeAttr(this, name); }); }, prop: function (name, value) { return jQuery.access(this, jQuery.prop, name, value, arguments.length > 1); }});
源码分析
大致思路
- 1.首先判断key值是不是一个object,如果是,遍历key,递归调用jQuery.access,并将是否可以链式调用的标志位设置为true
- 2.判断value值是否已经定义,如果已经定义,说明是个set操作
- 2.1 set操作的是可链式调用的
- 2.2 如果value不是function,设置raw为true
- 2.3 判断key值是否为null或者undefined,key若为空值
- 2.3.1 如果value不是个函数,或者强制赋值raw为true,那么调用fn,可能是以下调用:$(‘#box‘).attr(null,{abc:‘def‘,a:‘1‘})
- 2.3.1 如果value是个函数,将fn包装之,改变原来fn的作用域和参数
- 2.4 如果fn存在,遍历jQuery内部元素,分别执行set操作
- 3.首先判断是否为set方法,如果是,返回 elems,如果不是执行get操作(如果jQuery内部length为0,返回指定的默认空值)
源码
// Multifunctional method to get and set values of a collection // The value/s can optionally be executed if it‘s a function /** attr: function (name, value) { return jQuery.access(this, jQuery.attr, name, value, arguments.length > 1); }, * * @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 {*} */ access: function( elems, fn, key, value, chainable, emptyGet, raw ) { var i = 0, length = elems.length, bulk = key == null; // bulk 体积,容量;大多数,大部分;大块 // Sets many values /** * 如果参数key是对象,表示要设置多个属性,则遍历参数key,遍历调用access方法 * * $(‘#box‘).attr({data:1,def:‘addd‘}); */ if ( jQuery.type( key ) === "object" ) { chainable = true; //表示可以链式调用 for ( i in key ) { jQuery.access( elems, fn, i, key[i], true, emptyGet, raw ); } // Sets one value /** * $(‘#box‘).attr(‘customvalue‘,‘abc‘) * $(‘#box‘).attr(‘customvalue‘,function (value) {}); */ } else if ( value !== undefined ) { chainable = true; if ( !jQuery.isFunction( value ) ) { raw = true; } if ( bulk ) { // if (key == null && value !== undefined) // Bulk operations run against the entire set /** * $(‘#box‘).attr(undefined,‘abc‘) * * jQuery.attr.call(elems,value); 调用完毕之后,将fn设置为空 */ if ( raw ) { fn.call( elems, value ); fn = null; // ...except when executing function values /** * $(‘#box‘).attr(undefined,function () {}) * * fn = bulk = jQuery.attr; * * fn = function (elem, key, value) { * return jQuery.attr.call(jQuery(elem),value); * } * */ } else { //如果key有值的话,好办,这里的bulk是为了节省一个变量,将fn用bulk存起来,然后封装fn的调用 bulk = fn; fn = function( elem, key, value ) { return bulk.call( jQuery( elem ), value ); }; } } //jQuery.access(elems,jQuery.attr,) //如果fn存在,掉调用每一个元素,无论key是否有值,都会走到这个判断,执行set动作 if ( fn ) { // 递归调用之 for ( ; i < length; i++ ) { fn( elems[i], key, raw ? value : /** * 如果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; },
ExtJS 中的flexSetter方法
这让我猛然想起了Ext的flexSetter方法,该方法在Ext.Function.flexSetter 详细API请看这里
用法:
var ele = document.getElementById(‘box‘); function setAttribute(name, value) { ele.setAttribute(name, value); } var flexSetAttribute = Ext.Function.flexSetter(setAttribute); flexSetAttribute(‘title‘, ‘标题‘); flexSetAttribute({ ‘abc‘: ‘otherattribu‘, ‘other‘: 1 });
源码
/** * 1.关于Ext.enumerables的实现 * * 这里为了兼容某些浏览器的toString,valueOf等内置方法不能被遍历出来的bug * var o = {toString:111,valueOf:222}; * * for (var oo in o) * { alert(oo); } * */ var enumerables = [//‘hasOwnProperty‘, ‘isPrototypeOf‘, ‘propertyIsEnumerable‘, ‘valueOf‘, ‘toLocaleString‘, ‘toString‘, ‘constructor‘]; for (i in { toString: 1 }) { enumerables = null; } Ext.Function = { flexSetter: function(setter) { return function(name, value) { // 返回一个闭包 var k, i; if (name !== null) { if (typeof name !== ‘string‘) { //如果name不是字符串,这里就认为是对象,进行for in for (k in name) { if (name.hasOwnProperty(k)) { setter.call(this, k, name[k]); //逐个调用setter } } if (Ext.enumerables) { for (i = Ext.enumerables.length; i--;) { k = Ext.enumerables[i]; if (name.hasOwnProperty(k)) { setter.call(this, k, name[k]); } } } } else { setter.call(this, name, value); // 如果是个字符串,直接调用了 } } return this; }; } };
总结:很显然,Ext的flexSetter没有jQuery的强大,但是足够严谨,jQuery.access为prop、attr等上层需要灵活设置参数的功能做了一个统一的整理,方便了调用,节省了比特。
jQuery.access源码分析
时间: 2024-10-23 08:52:12