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

jQuery.access源码分析,古老的榕树,5-wow.com

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。