jQuery 與 ExtJS(以及 Prototype、MooTools 等)都將 $ 作為全局快捷變量。後加載的庫會覆蓋先前的 $,導致先加載庫的代碼失效。
<!-- 1. 先加載 jQuery -->
<script src="js/jquery.js"></script>
<script>
// 2. 釋放 $ 佔用,將 jQuery 賦值給自定義變量
var $j = jQuery.noConflict(); // 或 var jq = ...
</script>
<!-- 3. 再加載 ExtJS(此時 $ 歸 ExtJS 所有) -->
<script src="js/ext.js"></script>
| 模式 | 代碼示例 | 優點 | 缺點 |
|---|---|---|---|
| 自定義別名 | var $j = jQuery.noConflict(); $j('#id').hide(); | 簡潔,類似 $ 用法 | 需全項目統一替換 |
| 立即執行函數封裝 | (function($){ $('#id').hide(); })(jQuery); | 局部作用域用 $,無污染 | 嵌套較深時代碼縮進增加 |
| ready 回調傳參 | jQuery(function($){ $('#id').hide(); }); | 官方推薦,語義清晰 | 僅限 ready 內部 |
| 完全放棄 $ | jQuery('#id').hide(); | 零衝突風險 | 代碼冗長,可讀性下降 |
// utils/jQueryWrapper.js
define(['jquery'], function($) {
// 模塊內部安全使用 $
var api = {
init: function() {
$('.widget').each(function() { /* ... */ });
}
};
return api;
});
// main.js
require(['utils/jQueryWrapper', 'ext'], function(jqWrapper, Ext) {
// Ext 佔用全局 $
jqWrapper.init();
Ext.onReady(function() {
// Ext 代碼正常用 $
});
});
<script src="jquery-1.12.4.js"></script>
<script>var $jq1 = jQuery.noConflict(true);</script> // true=釋放 jQuery 變量
<script src="jquery-3.6.0.js"></script>
<script>var $jq3 = jQuery.noConflict(true);</script>
// 使用
$jq1('#old-plugin').legacyPlugin();
$jq3('#new-feature').modernPlugin();
注意: noConflict(true) 會同時釋放 $ 和 jQuery,舊插件若引用 jQuery 會失效,需在插件代碼前捕獲引用。
$ 別名(Ext.getDom 等),釋放後 Ext 正常工作$,需在插件前重新映射:window.$ = $j;(插件加載後再 window.$ = Ext.$ 恢復)externals + ProvidePlugin 管理全局變量,避免腳本標籤順序問題新項目不推薦引入 ExtJS,考慮:
若必須維護老項目,將 jQuery 代碼遷移至獨立模塊,通過事件總線與 Ext 交互,逐步剝離依賴。