jQuery.access源码分析

基本理解

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等上层需要灵活设置参数的功能做了一个统一的整理，方便了调用，节省了比特。