从零开始，DIY一个jQuery（2）

在上篇文章我们简单实现了一个 jQuery 的基础结构，不过为了顺应潮流，这次咱把它改为模块化的写法，此举得以有效提升项目的可维护性，因此在后续也将以模块化形式进行持续开发。

模块化开发和编译需要用上 ES6 和 rollup，具体原因和使用方法请参照我之前的《冗余代码都走开——前端模块打包利器 Rollup.js 入门》一文。

本期代码均挂在我的github上，有需要的童鞋自行下载。

1. 基本配置

为了让 rollup 得以静态解析模块，从而减少可能存在的冗余代码，我们得用上 ES6 的解构赋值语法，因此得配合 babel 辅助开发。

在目录下我们新建一个 babel 配置“.babelrc”：

{
  "presets": ["es2015-rollup"]
}

以及 rollup 配置“rollup.comfig.js”：

var rollup = require( ‘rollup‘ );
var babel = require(‘rollup-plugin-babel‘);

rollup.rollup({
    entry: ‘src/jquery.js‘,
    plugins: [ babel() ]
}).then( function ( bundle ) {
    bundle.write({
        format: ‘umd‘,
        moduleName: ‘jQuery‘,
        dest: ‘rel/jquery.js‘
    });
});

其中入口文件为“src/jquery.js”，并将以 umd 模式输出到 rel 文件夹下。

别忘了确保已安装了三大套：

npm i babel-preset-es2015-rollup rollup rollup-plugin-babel

后续咱们直接执行：

node rollup.config.js

即可实现打包。

2. 模块拆分

从模块功能性入手，我们暂时先简单地把上次的整个 IIFE 代码段拆分为：

src/jquery.js  //出口模块
src/core.js  //jQuery核心模块
src/global.js  //全局变量处理模块
src/init.js  //初始化模块

它们的内容分别如下：

jquery.js：

import jQuery from ‘./core‘;
import global from ‘./global‘;
import init from ‘./init‘;

global(jQuery);
init(jQuery);

export default jQuery;

core.js：

var version = "0.0.1",
      jQuery = function (selector, context) {

          return new jQuery.fn.init(selector, context);
      };

jQuery.fn = jQuery.prototype = {
    jquery: version,
    constructor: jQuery,
    setBackground: function(){
        this[0].style.background = ‘yellow‘;
        return this
    },
    setColor: function(){
        this[0].style.color = ‘blue‘;
        return this
    }
};

export default jQuery;

init.js：

var init = function(jQuery){
    jQuery.fn.init = function (selector, context, root) {
        if (!selector) {
            return this;
        } else {
            var elem = document.querySelector(selector);
            if (elem) {
                this[0] = elem;
                this.length = 1;
            }
            return this;
        }
    };

    jQuery.fn.init.prototype = jQuery.fn;
};

export default init;

global.js：

var global = function(jQuery){
    //走模块化形式的直接绕过
    if(typeof exports === ‘object‘ && typeof module !== ‘undefined‘) return;

    var _jQuery = window.jQuery,
        _$ = window.$;

    jQuery.noConflict = function( deep ) {
        //确保window.$没有再次被改写
        if ( window.$ === jQuery ) {
            window.$ = _$;
        }

        //确保window.jQuery没有再次被改写
        if ( deep && window.jQuery === jQuery ) {
            window.jQuery = _jQuery;
        }

        return jQuery;  //返回 jQuery 接口引用
    };

    window.jQuery = window.$ = jQuery;
};

export default global;

留意在 global.js 中我们先加了一层判断，如果使用者走的模块化形式，那是无须考虑全局变量冲突处理的，直接绕过该模块即可。

执行打包后效果如下（rel/jquery.js）：

(function (global, factory) {
  typeof exports === ‘object‘ && typeof module !== ‘undefined‘ ? module.exports = factory() :
  typeof define === ‘function‘ && define.amd ? define(factory) :
  (global.jQuery = factory());
}(this, function () { ‘use strict‘;

  /**
   * Created by vajoy on 2016/8/1.
   */

  var version = "0.0.1";
  var jQuery = function jQuery(selector, context) {

      return new jQuery.fn.init(selector, context);
  };
  jQuery.fn = jQuery.prototype = {
      jquery: version,
      constructor: jQuery,
      setBackground: function setBackground() {
          this[0].style.background = ‘yellow‘;
          return this;
      },
      setColor: function setColor() {
          this[0].style.color = ‘blue‘;
          return this;
      }
  };

  var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) {
    return typeof obj;
  } : function (obj) {
    return obj && typeof Symbol === "function" && obj.constructor === Symbol ? "symbol" : typeof obj;
  };

  /**
   * Created by vajoy on 2016/8/2.
   */
  var global$1 = function global(jQuery) {
      //走模块化形式的直接绕过
      if ((typeof exports === ‘undefined‘ ? ‘undefined‘ : _typeof(exports)) === ‘object‘ && typeof module !== ‘undefined‘) return;

      var _jQuery = window.jQuery,
          _$ = window.$;

      jQuery.noConflict = function (deep) {
          //确保window.$没有再次被改写
          if (window.$ === jQuery) {
              window.$ = _$;
          }

          //确保window.jQuery没有再次被改写
          if (deep && window.jQuery === jQuery) {
              window.jQuery = _jQuery;
          }

          return jQuery; //返回 jQuery 接口引用
      };

      window.jQuery = window.$ = jQuery;
  };

  /**
   * Created by vajoy on 2016/8/1.
   */

  var init = function init(jQuery) {
      jQuery.fn.init = function (selector, context, root) {
          if (!selector) {
              return this;
          } else {
              var elem = document.querySelector(selector);
              if (elem) {
                  this[0] = elem;
                  this.length = 1;
              }
              return this;
          }
      };

      jQuery.fn.init.prototype = jQuery.fn;
  };

  global$1(jQuery);
  init(jQuery);

  return jQuery;

}));

3. extend 完善

如上章所说，我们可以通过 $.extend / $.fn.extend 接口来扩展 JQ 的静态方法/实例方法，也可以简单地实现对象的合并和深/浅拷贝。这是非常重要且实用的功能，在这里我们得完善它。

在 core.js 中我们新增如下代码段：

jQuery.extend = jQuery.fn.extend = function() {
    var options,
        target = arguments[ 0 ] || {},  //target为要被合并的目标对象
        i = 1,
        length = arguments.length,
        deep = false; //默认为浅拷贝

    // 若第一个参数为Boolean，表示其为决定是否要深拷贝的参数
    if ( typeof target === "boolean" ) {
        deep = target;

        // 那么 target 参数就得往后挪一位了
        target = arguments[ i ] || {};
        i++;
    }

    // 若 target 类型不是对象的处理
    if ( typeof target !== "object" && typeof target !== "function" ) {
        target = {};
    }

    // 若 target 后没有其它参数（要被拷贝的对象）了，则直接扩展jQuery自身（把target合并入jQuery）
    if ( i === length ) {
        target = this;
        i--;  //减1是为了方便取原target（它反过来变成被拷贝的源对象了）
    }

    for ( ; i < length; i++ ) {

        // 只处理源对象值不为 null/undefined 的情况
        if ( ( options = arguments[ i ] ) != null ) {

            // TODO - 完善Extend
        }
    }

    // 返回修改后的目标对象
    return target;
};

该段代码可以判断如下写法并做对应处理：

$.extend( targetObj, copyObj1[, copyObj2...] )
$.extend( true, targetObj, copyObj1[, copyObj2...]  )
$.extend( copyObj )
$.extend( true, copyObj )

其它情况会被绕过（返回空对象）。

我们继续完善内部的遍历：

    var isObject = function(obj){
        return Object.prototype.toString.call(obj) === "[object Object]"
    };
    var isArray = function(obj){
        return Object.prototype.toString.call(obj) === "[object Array]"
    };

    for ( ; i < length; i++ ) { //遍历被拷贝的源对象

        // 只处理源对象值不为 null/undefined 的情况
        if ( ( options = arguments[ i ] ) != null ) {

            var name, clone, copy;
            // 遍历源对象属性
            for ( name in options ) {
                src = target[ name ];
                copy = options[ name ];

                // target已有该属性且完全相等，跳出本次循环
                if ( target === copy ) {
                    continue;
                }

                // 深拷贝，且确保被拷贝属性值为对象/数组
                if ( deep && copy && ( isObject( copy ) ||
                    ( copyIsArray = isArray( copy ) ) ) ) {

                    //被拷贝属性值为数组
                    if ( copyIsArray ) {
                        copyIsArray = false;
                        //若被合并属性不是数组，则设为[]
                        clone = src && isArray( src ) ? src : [];

                    } else {  //被拷贝属性值为对象
                        //若被合并属性不是数组，则设为{}
                        clone = src && isObject( src ) ? src : {};
                    }

                    // 右侧递归直到最内层属性值非对象，再把返回值赋给 target 对应属性
                    target[ name ] = jQuery.extend( deep, clone, copy );

                    // 非对象/数组，或者浅拷贝情况（注意排除 undefined 类型）
                } else if ( copy !== undefined ) {
                    target[ name ] = copy;
                }
            }
        }
    }

    // 返回被修改后的目标对象
    return target;

这里需要留意的有，我们会通过

jQuery.extend( deep, clone, copy )

来递归生成被合并的 target 属性值，这是为了避免扩展后的 target 属性和被扩展的 copyObj 属性引用了同一个对象，导致互相影响。

通过 extend 递归解剖 copyObj 源对象的属性直到最内层，最内层属性的值（上方代码里的 copy）大致有这么两种情况：

1. copy 为空对象/空数组：

    for ( ; i < length; i++ ) { //遍历被拷贝对象

        // 只处理源对象值不为 null/undefined 的情况
        if ( ( options = arguments[ i ] ) != null ) {

            //空数组/空对象没有可枚举的元素/属性，这里会忽略
        }
    }

    // 返回被修改后的目标对象
    return target;    //直接返回空数组/空对象

2. copy 为非对象（如“vajoy”）：

                if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
                    ( copyIsArray = jQuery.isArray( copy ) ) ) ) {
                                //不会执行这里

                } else if ( copy !== undefined ) {// 执行这里
                    target[ name ] = copy;
                }
            }
        }
    }

    // 返回如 [‘vajoy‘] 或者 {‘name‘ : ‘vajoy‘}
    return target;

从而确保 target 所扩展的每一层属性都跟 copyObj 的是互不关联的。

4. 建立基础工具模块

在上方的 extend 代码块中其实存在两个不合理的地方：

1. 仅通过 Object.toString.call(obj) === "[object Object]" 作为对象判断条件在我们扩展对象的逻辑中有些片面，适合扩展的对象应当是“纯粹/简单”（plain）的 js Object 对象，但在某些浏览器中，像 document 在 Object.toSting 调用时也会返回和 Object 相同结果；
2. 像 Object.hasOwnProperty 和 Object.prototype.toString.call 等方法在我们后续开发中会经常使用上，如果能把它们写到一个模块中封装起来复用就更好了。

关于 plainObject 的概念可以点这里了解。

基于上述两点，我们新增一个 util.js 来封装这些常用功能接口：

export var class2type = {};  //在core.js中会被赋予各类型属性值

export const toString = class2type.toString; //等同于 Object.prototype.toString

export const getProto = Object.getPrototypeOf;

export const hasOwn = class2type.hasOwnProperty;

export const fnToString = hasOwn.toString; //等同于 Object.toString/Function.toString

export const ObjectFunctionString = fnToString.call( Object ); //顶层Object构造函数字符串"function Object() { [native code] }"，用于判断 plainObj

然后在 core.js 导入所需接口即可：

import { class2type, toString, getProto, hasOwn, fnToString, ObjectFunctionString } from ‘./util.js‘;

我们进一步修改 extend 接口代码为：

jQuery.extend = jQuery.fn.extend = function() {
    var options, name, src, copy, copyIsArray, clone,
        target = arguments[ 0 ] || {},
        i = 1,
        length = arguments.length,
        deep = false;

    if ( typeof target === "boolean" ) {
        deep = target;

        target = arguments[ i ] || {};
        i++;
    }

    if ( typeof target !== "object" && !jQuery.isFunction( target ) ) {  //修改点1
        target = {};
    }

    if ( i === length ) {
        target = this;
        i--;
    }

    for ( ; i < length; i++ ) {

        if ( ( options = arguments[ i ] ) != null ) {

            for ( name in options ) {
                src = target[ name ];
                copy = options[ name ];

                if ( target === copy ) {
                    continue;
                }

                // Recurse if we‘re merging plain objects or arrays
                if ( deep && copy && ( jQuery.isPlainObject( copy ) ||  //修改点2
                    ( copyIsArray = jQuery.isArray( copy ) ) ) ) {

                    if ( copyIsArray ) {
                        copyIsArray = false;
                        clone = src && jQuery.isArray( src ) ? src : [];  //修改点3

                    } else {
                        clone = src && jQuery.isPlainObject( src ) ? src : {};
                    }

                    target[ name ] = jQuery.extend( deep, clone, copy );

                } else if ( copy !== undefined ) {
                    target[ name ] = copy;
                }
            }
        }
    }

    return target;
};

//新增修改点1，class2type注入各JS类型键值对，配合 jQuery.type 使用，后面会用上
"Boolean Number String Function Array Date RegExp Object Error Symbol".split(" ").forEach(function(name){
    class2type[ "[object " + name + "]" ] = name.toLowerCase();
});

//新增修改点2
jQuery.extend( {
    isArray: Array.isArray,
    isPlainObject: function( obj ) {
        var proto, Ctor;

        // 明显的非对象判断，直接返回false
        if ( !obj || toString.call( obj ) !== "[object Object]" ) {
            return false;
        }

        proto = getProto( obj );  //获取 prototype

        // 通过 Object.create( null ) 形式创建的 {} 是没有prototype的
        if ( !proto ) {
            return true;
        }

        // 简单对象的构造函数等于最顶层 Object 构造函数
        Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
        return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
    },
    //获取类型（如‘function‘），后面会用上
    type: function( obj ) {
        if ( obj == null ) {
            return obj + ""; //‘undefined‘ 或 ‘null‘
        }

        return typeof obj === "object" || typeof obj === "function" ?
        class2type[ toString.call( obj ) ] || "object" :
            typeof obj;
    }

});

这里我们新增了isArray、isPlainObject 两个 jQuery 静态方法，其中 isPlainObject 比较有趣，为了过滤某些浏览器中的 document 等特殊类型，会对 obj.prototype 及其构造函数进行判断：

1. 通过Object.create( null ) 形式创建的 {} ，或者实例对象都是没有 prototype 的，直接返回 true；
2. 判断其构造函数合法性（存在且等于原生的对象构造器 function Object(){ [native code] }）

关于第二点，实际是直接判断两个构造器字符串化后是否相同：

Function.toString.call(constructor) === Function.toString.call(Object)

我们执行打包处理：

node rollup.config.js

在 HTML 页面运行下述代码：

    var $div = $(‘div‘);
    $div.setBackground().setColor();

    var arr = [1, 2, 3];
    console.log($.type(arr))

效果如下：

留意 $.type 静态方法是我们上方通过 jQuery.extend 扩展进去的：

//新增修改点1，class2type注入各JS类型键值对，配合 jQuery.type 使用
"Boolean Number String Function Array Date RegExp Object Error Symbol".split(" ").forEach(function(name){
    class2type[ "[object " + name + "]" ] = name.toLowerCase();
});

jQuery.extend( {
    type: function( obj ) {
        if ( obj == null ) {
            return obj + ""; //‘undefined‘ 或 ‘null‘
        }

        return typeof obj === "object" || typeof obj === "function" ?
        //兼容安卓2.3- 函数表达式类型不正确情况
        class2type[ toString.call( obj ) ] || "object" :
            typeof obj;
    }

});

它返回传入参数的类型（小写）。该方法在我们下一章也会直接在模块中使用到。

本章先这样吧，得感谢这台风天赏赐了一天的假期，才有了时间写文章，共勉~

时间： 2024-09-28 12:32:43

从零开始，DIY一个jQuery（2）的相关文章

从零开始，DIY一个jQuery（3）

在前两章,为了方便调试,我们写了一个非常简单的 jQuery.fn.init 方法: jQuery.fn.init = function (selector, context, root) { if (!selector) { return this; } else { var elem = document.querySelector(selector); if (elem) { this[0] = elem; this.length = 1; } return this; } }; 因此我们

从零开始，DIY一个jQuery（一）

从本篇开始会陪大家一起从零开始走一遍 jQuery 的奇妙旅途,在整个系列的实践中,我们会把 jQuery 的主要功能模块都了解和实现一遍. 这会是一段很长的历程,但也会很有意思 —— 作为前端领域的经典之作,jQuery 里有着太多奇思妙想,如果能够深入理解它,对于我们稳固js基础.提升前端大法技能来说大有裨益. 另外,本系列的相关代码均可以从 我的github 上获取到. 1. 免 new 实现 我们在使用很多插件的时候,都需要使用 new XXX() 的写法来实例化一个引用: var li

从零开始构建一个的asp.net Core 项目

最近突发奇想,想从零开始构建一个Core的MVC项目,于是开始了构建过程. 首先我们添加一个空的CORE下的MVC项目,创建完成之后我们运行一下(Ctrl +F5).我们会在页面上看到"Hello World!". 既然是从零开始构建的项目,我们需要搞明白这个"Hello World!"是从哪里出现的? 点开我们的项目,我们会看到VS为我们生成了两个类,一个是Program.cs 和startup.cs,和一个空文件夹(wwwroot),除此之外VS在也没有为我们多

从零开始构建一个centos+jdk7+tomcat7的docker镜像文件

从零开始构建一个centos+jdk7+tomcat7的镜像文件 centos7系统下docker运行环境的搭建 准备centos基础镜像 docker pull centos 或者直接下载我准备好的镜像 docker pull registry.cn-hangzhou.aliyuncs.com/repos_zyl/centos:0.0.1 准备jdk7和tomcat7安装包 创建工作目录, mkdir -p /z/docker 准备下载jdk7的tar.gz包http://download.o

一个jQuery扩展工具包

带有详尽注释的源代码: var jQuery = jQuery || {}; // TODO // ###################################string操作相关函数################################### jQuery.string = jQuery.string || {}; /** * 对目标字符串进行html解码 * * @name jQuery.string.decodeHTML * @function * @grammar j

DIY一个基于树莓派和Python的无人机视觉跟踪系统

DIY一个基于树莓派和Python的无人机视觉跟踪系统 无人机通过图传将航拍到的图像存储并实时传送回地面站几乎已经是标配.如果想来点高级的--在无人机上直接处理拍摄的图像并实现自动控制要怎么实现呢?其实视觉跟踪已经在一些高端的消费级无人机上有了应用,不过玩现成的永远没有自己动手来劲;).前段时间DIY了一个无人机三轴云台的视觉跟踪系统,除去云台花了￥370,本文将设计思路与实验效果分享出来. 一.基本配置 1.1 硬件 计算平台:树莓派3 (￥219.00) 摄像头:USB网络摄像头(￥108.

深入浅出React Native 3: 从零开始写一个Hello World

这是深入浅出React Native的第三篇文章. 1. 环境配置 2. 我的第一个应用 将index.ios.js中的代码全部删掉,为什么要删掉呢?因为我们准备从零开始写一个应用~学习技术最好的方式就是自己动手写,看别人的代码一百遍的效果也不如自己写一遍来的效果大~ 我们要做的事情主要分成以下两步: 1. 创建组件 2. 将创建好的组件显示在app上 打开index.ios.js文件,输入 var HelloWorld = React.createClass({ render: functio

分享一个jquery功能强大的提示信息插件代码

代码属于提示文字特效,很好,使用有些复杂,请参demo使用 下载地址:jquery功能强大的提示信息插件代码 预览DEMO:DEMO 分享一个jquery功能强大的提示信息插件代码,布布扣,bubuko.com

一个jquery在不同浏览器下的兼容性问题。

<div id ='pdiv' style='visibility:hidden;'> <div id='cdiv'>子元素</div> </div> 以上HTML. 父div设置了visibility为hidden.当使用jquery获取子div的visibility的值时,在不同版本的IE浏览器得到的值不一样: 在>=IE8时 $("#cdiv").css("visibility")的值为"hidd