$apply() 與 $digest() 是 AngularJS 裡最核心、也最容易讓人卡住的一對概念。想真正理解 Angular 的資料更新機制,就繞不開它們。以下就從雙向綁定講起,一路拆到髒值檢查的執行細節。
AngularJS 最迷人的特性莫過於雙向資料綁定:view 上的值改了,scope 模型自動跟著變;scope 模型改了,view 也立刻反映。它是怎麼辦到的?
當你寫下 {{ aModel }} 這樣的插值表達式時,Angular 會在背後替這個模型註冊一個 watcher。watcher 的本質就是你自己會寫的那種:
$scope.$watch('aModel', function(newValue, oldValue) {
// 用 newValue 更新 DOM
});
第二個參數是回呼函數,當 aModel 的值改變時被觸發。問題來了——Angular 究竟怎麼知道 aModel 變了?它會定時輪詢嗎?答案就是 $digest 循環。
呼叫 $scope.$digest() 之後,循環就啟動了。它會跑一遍所有 watcher,每個 watcher 拿「現在的 model 值」跟「上次記錄的值」比對,若不同就執行對應的 listener,view 上的表達式內容因此被更新。
而 ng-click 這類內建指令之所以能自動更新畫面,是因為 Angular 在處理事件時會幫你呼叫 $scope.$apply(),而 $apply() 內部呼叫的是 $rootScope.$digest()。所以循環其實是從 $rootScope 開始,再往下遍歷所有子 scope 的 watcher。
記住:$scope.$apply() 會自動觸發 $rootScope.$digest()。
第一種接受一個函式作為參數:先執行該函式,再啟動一輪 $digest 循環。
第二種不接參數:單純觸發一輪 $digest 循環。
實務上永遠優先用第一種。因為傳入函式時,Angular 會把它包進 try…catch,一旦丟出例外,會交由 $exceptionHandler 服務統一處理;不傳參數的寫法則少了這層保護。
關鍵規則只有一句:Angular 只會自動響應發生在 Angular 上下文裡的變更。 所有內建指令(ng-click、ng-model 等)與部分服務($timeout、$http 等)都已經幫你包好了,所以那些場合不用操心。
但只要你跑到 Angular 的框架之外——例如直接用原生 setTimeout()、用 jQuery 綁 DOM 事件、或串接第三方函式庫(Facebook SDK、某個外掛)——改完 model 之後就必須自己補上 $apply(),否則資料雖然在 scope 裡變了,畫面卻不會更新。
HTML:
<body ng-app="myApp">
<div ng-controller="MessageController">
Delayed Message: {{message}}
</div>
</body>
不呼叫 $apply() 的版本:
/* 沒有 $apply() 會發生什麼事 */
angular.module('myApp', []).controller('MessageController', function($scope) {
$scope.getMessage = function() {
setTimeout(function() {
$scope.message = 'Fetched after 3 seconds';
console.log('message:' + $scope.message);
}, 2000);
};
$scope.getMessage();
});
跑起來你會發現:兩秒後 console 確實印出了新值,畫面卻還是舊的。因為我們忘了通知 Angular 該做髒值檢查了。
加上 $apply() 之後:
/* 加上 $apply() */
angular.module('myApp', []).controller('MessageController', function($scope) {
$scope.getMessage = function() {
setTimeout(function() {
$scope.$apply(function() {
$scope.message = 'Fetched after 3 seconds';
console.log('message:' + $scope.message);
});
}, 2000);
};
$scope.getMessage();
});
現在畫面就會在兩秒後同步更新。順帶一提:與其用 setTimeout 再手動補 $apply(),不如直接用 $timeout 服務,它會幫你把這件事做完。
$scope.getMessage = function() {
setTimeout(function() {
$scope.message = 'Fetched after two seconds';
console.log('message:' + $scope.message);
$scope.$apply(); // 手動觸發 $digest
}, 2000);
};
能動,但不建議——少了例外處理的保護傘。
這裡有個容易忽略的細節:循環不會只跑一次。跑完一輪後,Angular 會再跑一輪,檢查 listener 有沒有又改動了 model。這就是所謂的髒值檢查(Dirty Checking)。
因此循環會持續進行,直到 model 不再變動,或達到上限 10 次。若超過 10 次還在變,Angular 會丟出錯誤——這通常代表你在 watcher 裡寫了互相觸發的邏輯。
實務結論:盡量不要在 listener 裡修改 model;即使沒有改,循環至少也會跑兩輪(第二輪純粹是為了確認)。
• 使用 ng- 開頭的事件指令(ng-click、ng-keypress…)時,Angular 已代為呼叫 $apply()。
• 使用 $http、$timeout 等內建服務時,它們也會自行觸發 $digest()。
• 自己手寫事件監聽、整合 jQuery 或第三方 API、直接呼叫 setTimeout() 時,才需要主動補上 $apply()。
<!DOCTYPE html>
<html ng-app="myApp">
<head>
<title>$scope.$apply() 用法</title>
<meta charset="utf-8">
<script src="https://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script>
</head>
<body>
<div id="div1" ng-controller="mytext">
<div>{{text}}</div>
<input id="btn" type="button" value="jquery-event"></input>
</div>
</body>
</html>
<script type="text/javascript">
var myModule = angular.module('myApp', []);
myModule.controller("mytext", function($scope){
$scope.text = "place";
setTimeout(function(){
$scope.text = "value setted after time out";
$scope.$apply(); // 必須手動觸發髒值檢測,否則資料無法刷新到畫面
}, 1000);
});
</script>
<!DOCTYPE html>
<html ng-app="myApp">
<head>
<title>$scope.$apply() 用法</title>
<meta charset="utf-8">
<script src="https://cdn.jsdelivr.net/jquery/3.1.0/jquery.min.js"></script>
<script src="https://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script>
</head>
<body>
<div id="div1" ng-controller="mytext">
<div>{{text}}</div>
<input id="btn" type="button" value="jquery-event"></input>
</div>
</body>
</html>
<script type="text/javascript">
var myModule = angular.module('myApp', []);
myModule.controller("mytext", function($scope){
$scope.text = "place";
});
$(function(){
$("#btn").click(function(){
var $scope = $("#btn").scope();
$scope.text = "value setted in jquery";
$scope.$apply();
});
});
</script>
判斷標準其實很單純:問問自己,Angular 能不能察覺到你改了 model? 能,什麼都不用做;不能,就補一次 $apply()。把這個判斷習慣養成自然反應,大多數「資料明明變了畫面卻沒動」的靈異事件就會消失。