jQuery.noConflict方法解析

2024年5月14日 143次阅读 来源: 普拉斯

功能

jQuery API文档中对noConflict方法的描述是：”释放jQuery对变量$的控制权”。( ′◔ ‸◔`)不是很明确，慢慢解释下。
我们都知道jQuery库占用了全局变量$(是变量jQuery的别名), 但是其他JS库也可以使用该变量了（比如zeptoJS, prototypejs）。当项目中同时引用了jQuery和其他占用全局变量$的库时，可能会导致变量$冲突。所以jQuery在给全局变量$赋值的时候先保存当时全局变量$已经存在的值，然后通过jQuery.noConflict方法把原来保存的值重新赋值给全局变量$。

类似的手法noConflict方法也实现了对jQuery变量的释放控制（主要用于同时引入多个版本的jQuery）。
这里只对全局变量$的处理进行解析，jQuery变量的处理方式类似。

实现

jQuery v3.2.1中noConflict方法的完整实现（解释见注释）：

var

    // 保存此时全局变量jQuery的值，可能其他版本的jQuery已经加载了
    _jQuery = window.jQuery,

    // 保存此时全局变量$的值，可能其JS库已经占用了全局变量$
    _$ = window.$;

jQuery.noConflict = function( deep ) {
    // 如果此时全局变量$还属于jQuery，则把全局变量$在jQuery初始化时的值_$重新赋值给$。
    if ( window.$ === jQuery ) {
        window.$ = _$;
    }
    // 如果参数deep为true且此时全局变量jQuery还属于当前版本的jQuery，则把全局变量jQuery在当前版本jQuery初始化时的值_jQuery重新赋值给jQuery。
    if ( deep && window.jQuery === jQuery ) {
        window.jQuery = _jQuery;
    }
    // 返回当前版本的jQuery变量
    return jQuery;
};

通过实现发现jQuery库在且只在初始化的时候会保存当时全局变量$和jQuery的值，保存的值会在方法noConflict调用的时候复原。所以其他占用全局变量$的库要先于jQuery引用，noConflit方法才能正确工作。

举例

假设有个js文件glib.js也占用了全局变量$:

;(function() {
    var glib = function() {
        console.log('I am from glib js');
    };

    window.$ = window.glib = glib;
})()

index.html 内容:

<!DOCTYPE html>
<html>
<head>
    <title>jQuery</title>
</head>
<body>
<h1 id="title">hi jQuery noConflit</h1>
<script type="text/javascript" src="glib.js"></script>
<script type="text/javascript" src="../a.libs/jquery.js"></script>
<script type="text/javascript">
    ;(function() {
        var text = $('#title').text(); // 变量$是jQuery
        console.log(text);
        $.noConflict(); // jQuery释放$变量，这样变量$的是glib中定义的
        $(); // 输出"I am from glib js"
    })()
</script>
</body>
</html>

注意一定在jQuery前引用glib.js文件。这样当jQuery初始化时，全局变量已经被glib占用了。

其他

调用noConflict方法释放全局变量$的控制权后，可以使用变量jQuery使用代替，或者给jQuery另其一个别名（$也只是一个别名啊）

<script type="text/javascript">
    ;(function() {
        var text = $('#title').text(); // 变量$是jQuery
        console.log(text);
        var j = $.noConflict(); // 新的别名j
      // 方式1   
        console.log(jQuery('#title').text()); // 这里直接使用jQuery变量
      // 方式2
      console.log(j('#title').text()); // 这里使用新的别名j
    })()
</script>

怎么还可以使用变量$呢？一般通过立即执行函数方式继续使用全局变量$

<script type="text/javascript">
    ;(function() {
        var text = $('#title').text(); // 变量$是jQuery
        console.log(text);
        var j = $.noConflict(); // 新的别名j
          // 方式1   
        console.log(jQuery('#title').text()); // 这里直接使用jQuery变量
          // 方式2
          console.log(j('#title').text()); // 这里使用新的别名j
          // 方式3
          ;(function($){
              console.log(j('#title').text()); // 在立即执行函数里继续使用变量$
          })(jQuery) // 变量jQuery当作参数传入
    })()
</script>

参考

  1. jQuery API noConflict

    原文作者：普拉斯
    原文地址: https://segmentfault.com/a/1190000012033344
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞