歷史項目中常見 jQuery (DOM 操作、插件生態) 與 AngularJS (MVVM、雙向綁定) 混用。核心衝突點:**jQuery 直接修改 DOM 不會觸發 AngularJS 的 $digest 循環,導致 Model 與 View 不同步**。
<div ng-app="ngDemo" ng-controller="ngCtrl">
<!-- 純 Angular -->
test1: <div id="dv1">{{test1}}</div>
<button ng-click="test1=test1+1">Angular +1</button>
<!-- jQuery + Angular 混合 -->
test2: <div id="dv2" ng-bind="test2" ng-model="test2"></div>
<button id="btn">jQuery +1</button>
<!-- 純 jQuery -->
test3: <div id="dv3">0</div>
</div>
<script>
var app = angular.module('ngDemo', []);
app.controller('ngCtrl', ['$scope', function($scope) {
$scope.test1 = 0;
$scope.test2 = 0;
}]);
$('#btn').on('click', function() {
// 直接修改 DOM 文本
$('#dv2').text(Number($('#dv2').text()) + 1);
$('#dv3').text(Number($('#dv3').text()) + 1);
});
</script>
dv3 (純 jQuery) 正常遞增dv2 (ng-bind) **視圖更新但 Model 未更新** ($scope.test2 仍為 0)dv1 更新,dv2 **回退到 Model 值 (0+1=1)**,用戶操作丟失!AngularJS 通過 $digest 循環 檢測 Model 變化並更新 View。jQuery 直接操作 DOM 繞過了 Angular 的監測機制:
// 發生了什麼
$('#dv2').text('新值'); // 只修改了 DOM 文本節點
// $scope.test2 依然是舊值
// 下次 $digest 運行時:View <- Model (覆蓋了 jQuery 的修改)
$('#btn').on('click', function() {
var scope = angular.element('#dv2').scope(); // 獲取元素對應的 scope
scope.test2 = scope.test2 + 1; // 修改 Model
scope.$apply(); // 強制觸發 $digest,同步 View
$('#dv3').text(Number($('#dv3').text()) + 1);
});
⚠️ 注意:若已在 $digest 階段調用 $apply() 會拋錯「$digest already in progress」。安全寫法:
if (!scope.$$phase) {
scope.$apply();
} else {
// 已在 digest 中,Model 修改會自動同步
}
scope.$evalAsync(function() {
scope.test2 = scope.test2 + 1;
});
在當前或下一個 $digest 循環執行,避免衝突。
app.service('JQueryBridge', ['$timeout', function($timeout) {
this.syncUpdate = function(scope, key, value) {
$timeout(function() {
scope[key] = value;
}, 0); // 0 延時 = 下一個 digest 循環
};
}]);
app.directive('jqueryPlugin', ['$timeout', function($timeout) {
return {
restrict: 'A',
scope: { model: '=jqueryPlugin' },
link: function(scope, element, attrs) {
// 初始化 jQuery 插件
const instance = $(element).somePlugin({
onChange: function(newVal) {
$timeout(() => { scope.model = newVal; });
}
});
// Model -> View 同步
scope.$watch('model', function(newVal) {
if (instance) instance.setValue(newVal);
});
// 銷毀清理
scope.$on('$destroy', () => instance.destroy());
}
};
}]);
// 使用
<div jquery-plugin model="myModel"></div>
用戶操作 / jQuery 修改
↓
修改 $scope 屬性 (Model)
↓
$apply() / $evalAsync() / $timeout()
↓
$digest 循環啟動
↓
所有 $watch 執行檢測變化
↓
View 更新 (ng-bind, {{}}, 指令)
↓
完成同步
| 坑點 | 症狀 | 解決 |
|---|---|---|
| 重複 $apply | $digest already in progress | 用 $evalAsync 或判斷 $$phase |
| scope 隔離 | angular.element().scope() 取到錯誤 scope | 用 isolate scope 或 controllerAs |
| 內存洩漏 | jQuery 插件未銷毀,$destroy 未清理 | 指令 link 中綁定 $destroy 事件 |
| 性能問題 | 頻繁 $apply 導致大量 digest | 批量修改後統一 $apply,或用不可變數據 |
jQuery 操作 DOM、AngularJS 管理 Model,兩者混用的核心難題是**數據同步**。關鍵在於:**修改 Model 而非 DOM,並確保 $digest 循環運行**。最佳實踐是編寫 Angular 指令封裝 jQuery 交互,將「如何同步」封裝在指令內部,業務代碼只操作 Model。