DIV CSS 佈局教程網

jQuery 的 $ 命名衝突怎麼解:noConflict、別名與閉包封裝
編輯:JavaScript綜合知識     

在 jQuery 裡,$ 只是 jQuery 的別名,$('#msg') 等同 jQuery('#msg')。問題是 Prototype、MooTools 等函式庫也愛用 $,一旦同時載入,就會互相搶走這個符號。

衝突取決於載入順序

情況一:prototype.js 先,jquery.js 後

<script src="prototype.js"></script>
<script src="jquery.js"></script>

$('#msg').hide();     // 這裡的 $ 是 jQuery 的

後載入者勝出,所以 $ 屬於 jQuery。

情況二:jquery.js 先,prototype.js 後

<script src="jquery.js"></script>
<script src="prototype.js"></script>

$('#msg').hide();     // 這裡的 $ 是 Prototype 的,會出錯
jQuery('#msg').hide();// 只能用全稱

解法一:JQuery.noConflict()

這個方法讓 jQuery 交出 $ 的所有權,還給先佔用的函式庫,它的回傳值就是 jQuery 物件本身。

jQuery.noConflict();
// 此後 $('#msg') 是 Prototype 的 $,不可再用
jQuery('#msg').hide();

解法二:自訂別名

var $j = jQuery.noConflict();
$j('#msg').hide();      // $j 成為 jQuery 的短名

這是最實用的做法,既避開衝突,又保有簡短的呼叫形式。

解法三:用作用域包住(最推薦)

jQuery(document).ready(function ($) {
  $('#msg').hide();     // 這個 ready 回呼內的 $ 一定是 jQuery
});

或者用 IIFE 立即建立獨立作用域:

(function ($) {
  // ...
  $('#msg').hide();     // 這個區塊內的 $ 都是 jQuery
})(jQuery);

若 Prototype 是後載入的,這招同樣有效,因為我們是明確把 jQuery 傳進去當參數,不受全域 $ 被誰覆蓋影響。

為什麼寫插件一定要這樣包

(function(){})() 這種寫法是「建立匿名函式並立刻執行」。它製造出一個獨立作用域,內部的 $ 不會外洩,外部的 $ 也不會污染內部。由於你無法預知使用者的頁面會以什麼順序載入哪些函式庫,這種封裝是唯一能保證插件在任何環境都不衝突的寫法:

(function ($) {
  $.fn.myPlugin = function (options) {
    // 在這裡自由使用 $,不必擔心與外界衝突
    return this.each(function () { /* ... */ });
  };
})(jQuery);

仔細拆解:(function(){})() 建立並立即執行匿名函式,形成封閉作用域;(function($){})(jQuery) 則在此基礎上把 jQuery 當參數傳入,在內部命名為 $。因為 jQuery 內部 $ 與 jQuery 本是同一個東西,這樣重新命名後,插件內部就能安全地使用熟悉的 $ 語法,而完全不理会全域命名空間的狀態。

一個附帶的好處

IIFE 不只解決衝突,還能避免全域變數污染。插件內宣告的暫存變數都留在函式作用域裡,不會附在 window 上與其他程式打架。在 ES Module 普及之前,這是 JavaScript 做模組化的主力手法;今天寫 jQuery 插件時,這依然是標準起手式。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved