jquery源码解析：jQuery工具方法详解3

jQuery的工具方法，其实就是静态方法，源码里面就是通过extend方法，把这些工具方法添加给jQuery构造函数的。

jQuery.extend({ 

　　......　　　　

　　each: function( obj, callback, args ) {   //$.each(arr , function(i,value){}),第三个参数用于内部调用。此方法就是来遍历数组的，然后取数组中的值进行显示。不能改变原数组arr，跟map一样，但是map返回新数组，而each返回原数组。这里跟原生的forEach和map的回调方法参数不一样，原生的回调方法中，第三个参数是原数组，可以在回调方法中改变原数组的值。但jQuery的回调方法，不会传第三个参数。
　　　　var value,
　　　　　　i = 0,
　　　　　　length = obj.length,
　　　　　　isArray = isArraylike( obj );   //是否是类数组或数组，json（不包括jQuery这种对象形式）返回false

　　　　if ( args ) {    //jQuery内部使用
　　　　　　if ( isArray ) {
　　　　　　　　for ( ; i < length; i++ ) {
　　　　　　　　　　value = callback.apply( obj[ i ], args );

　　　　　　　　　　if ( value === false ) {
　　　　　　　　　　　　break;
　　　　　　　　　　}
　　　　　　　　}
　　　　　　}

　　　　　　else {
　　　　　　　　for ( i in obj ) {
　　　　　　　　　　value = callback.apply( obj[ i ], args );

　　　　　　　　　　if ( value === false ) {
　　　　　　　　　　　　break;
　　　　　　　　　　}
　　　　　　　　}
　　　　　　}

　　　　}

　　　　else {       //我们在外面调用时，执行的代码
　　　　　　if ( isArray ) {   //如果是类数组
　　　　　　　　for ( ; i < length; i++ ) {
　　　　　　　　　　value = callback.call( obj[ i ], i, obj[ i ] );  //回调方法返回false就停止循环

　　　　　　　　　　if ( value === false ) {
　　　　　　　　　　　　break;
　　　　　　　　　　}
　　　　　　　　}
　　　　　　}

　　　　　　else {
　　　　　　　　for ( i in obj ) {  //如果是json对象
　　　　　　　　　　value = callback.call( obj[ i ], i, obj[ i ] );

　　　　　　　　　　if ( value === false ) {
　　　　　　　　　　　　break;
　　　　　　　　　　}
　　　　　　　　}
　　　　　　}
　　　　}

　　　　return obj;
　　},　

　　trim: function( text ) {   //core_trim是字符串的trim方法
　　　　return text == null ? "" : core_trim.call( text );
　　},　

　　makeArray: function( arr, results ) {  //把所有东西转换成数组，$.makeArray(json) -> []，第二个参数是给内部用的
　　　　var ret = results || [];

　　　　if ( arr != null ) {
　　　　　　if ( isArraylike( Object(arr) ) ) {

　　　　　　//如果arr为数字123，这里会返回false，因为number不是类数组。但是如果是字符串"hello"，Object会把它转成具有length的json对象，所以就返回true。字符串是有length属性的。
　　　　　　　　jQuery.merge( ret,
　　　　　　　　　　typeof arr === "string" ?
　　　　　　　　　　　　[ arr ] : arr
　　　　　　　　);
　　　　　　}

　　　　　　else {    //如果传入123，就执行这里，把123push到数组中。假设有第二个参数，$.makeArray(123,{length:0}) ,那么就会出现[].push.call({length:0},123)，这里我做了测试，是没有任何问题的，会变成{length:1,0:123}

　　　　　　　　core_push.call( ret, arr );   
　　　　　　}
　　　　}

　　　　return ret;
　　},

　　inArray: function( elem, arr, i ) {  //元素是否在arr数组中，从i位置开始找。core_indexOf=[].indexOf
　　　　return arr == null ? -1 : core_indexOf.call( arr, elem, i );
　　},　

　　merge: function( first, second ) {    //合并数组
　　　　var l = second.length,
　　　　　　i = first.length,
　　　　　　j = 0;

　　　　if ( typeof l === "number" ) {    //第二个参数，可能不是数组或类数组，特殊json。第一个参数必须是。
　　　　　　for ( ; j < l; j++ ) {
　　　　　　　　first[ i++ ] = second[ j ];
　　　　　　}
　　　　}

　　　　else {
　　　　　　while ( second[j] !== undefined ) {   //普通json的情况，{0:"0",1:"1"}，但必须是0,1，2...这种
　　　　　　　　first[ i++ ] = second[ j++ ];
　　　　　　}
　　　　}

　　　　first.length = i;    //当第一个参数，不是数组时，比如是{0:"0",1:"1",length:2}，length就需要手动改变

　　　　return first;
　　},　　　

　　grep: function( elems, callback, inv ) {

　　//过滤得到一个新数组，$.grep(arr,function(value,index){ return value>2})，arr数组中大于2的，才会返回生成数组。也就是返回true时，才会返回此值生成数组，第三个参数，true，就代表相反的（小于等于2）返回生成数组

　　　　var retVal,
　　　　　　ret = [],
　　　　　　i = 0,
　　　　　　length = elems.length;
　　　　inv = !!inv;    //转换成true or false，不传的时候是undefined，就会变成fase.

　　　　for ( ; i < length; i++ ) {
　　　　　　retVal = !!callback( elems[ i ], i );    //转换成true or false
　　　　　　if ( inv !== retVal ) {
　　　　　　　　ret.push( elems[ i ] );
　　　　　　}
　　　　}

　　　　return ret;
　　},

　　map: function( elems, callback, arg ) {  //支持普通json,数组，类数组，特殊json（jQuery对象形式）

　　//$.map(arr,function(value,index){ return })，通过回调，把返回的值组成一个全新的数组，返回全新的数组。第三个参数内部调用
　　　　var value,
　　　　　　i = 0,
　　　　　　length = elems.length,
　　　　　　isArray = isArraylike( elems ),    //数组和类数组都可以，jQuery对象形式也可以
　　　　　　ret = [];

　　　　if ( isArray ) {
　　　　　　　　for ( ; i < length; i++ ) {
　　　　　　　　　　value = callback( elems[ i ], i, arg );

　　　　　　　　　　if ( value != null ) {   //回调返回的值不是null或者undefined，就存入新数组中
　　　　　　　　　　　　ret[ ret.length ] = value;
　　　　　　　　　　}
　　　　　　　　}

　　　　}

　　　　else {      //普通json就执行这里，比如：{name:"chaojidan",age:25}
　　　　　　　　for ( i in elems ) {
　　　　　　　　　　value = callback( elems[ i ], i, arg );//callback("chaojidan",name)

　　　　　　　　　　if ( value != null ) {
　　　　　　　　　　　　ret[ ret.length ] = value;
　　　　　　　　　　}
　　　　　　　　}
　　　　}

　　　　return core_concat.apply( [], ret );

　　　　//core_concat=[].concat，以防回调方法返回的是数组形式，那么就会出现复合数组，比如:ret = [[1],[2],[3]],通过concat([1],[2],[3])，合并，返回[1,2,3]
　　},

　　......

})

加油！