angular.js的$timeout指令對window.setTimeout做了一個封裝,它的返回值是一個promise物件.當定義的時間到了以後,這個promise物件就會被resolve,回撥函式就會被執行.
如果需要取消一個timeout,呼叫$timeout.cancel(promise)方法.
用法:
$timeout(fn, [delay], [invokeApply]);
fn: 回撥函式(必填)
delay: number型別.延遲的時間(非必填),如果不填,表示等執行緒空下來以後就執行.比如當頁面被渲染完成後.
invokeApply: 布林值.是否需要進行髒值檢測(非必填),不填預設為false,如果設定為true,則fn回撥會被包在$scope.$apply()中執行
返回值: 返回一個promise物件.當定義的時間到了以後,這個promise物件就會被resolve.resolve的值就是fn回撥函式的返回值
方法:
$timeout.cancel([promise])
promise: 一個由$timeout()所建立的promise物件.(非必填).呼叫cancel()以後,這個promise物件就會被reject.
返回值: 如果$timeout()的回撥還沒有被執行,那就取消成功.返回true
下面來簡單的測試一下:
var timeoutApp = angular.module('timeoutApp',[]); timeoutApp.run(function($timeout){ var a = $timeout(function(){ console.log('執行$timeout回撥'); return 'angular' },1000); a.then(function(data){ console.log(data) },function(data){ console.log(data) }); //$timeout.cancel(a); })
執行以後看到控制檯列印:
執行$timeout回撥
angular
如果我開啟註釋,執行.cancel()方法,那麼$timeout的回撥就不會被執行,它返回的promise被reject,控制檯列印:
canceled
下面做個很實用的小demo: 延遲下拉選單: 滑鼠放到button上的時候,延遲500毫秒顯示下拉選單,當滑鼠離開button的時候,延遲500毫秒隱藏下拉選單,如果滑鼠是進入了下拉選單部分,那麼就不隱藏下拉選單.如果滑鼠離開了下拉選單,延遲500毫秒隱藏下拉選單,如果滑鼠是進入了button,那麼還是不隱藏下拉選單
html:
<!DOCTYPE html> <html ng-app="timeoutApp"> <head> <title>$timeout服務</title> <meta charset="utf-8"> <link rel="stylesheet" href="../bootstrap.css"/> <script src="../angular.js"></script> <script src="script.js"></script> <style type="text/css"> * { font-family:'MICROSOFT YAHEI' } </style> </head> <body > <div ng-controller="myCtrl"> <div class="dropdown" dropdown > <button class="btn btn-default dropdown-toggle" type="button" ng-mouseenter = "showMenu()" ng-mouseleave = "hideMenu()"> Dropdown <span class="caret"></span> </button> <ul class="dropdown-menu" ng-show="ifShowMenu" ng-mouseenter = "showMenu()" ng-mouseleave = "hideMenu()"> <li><a href="#">Action</a></li> <li><a href="#">Another action</a></li> <li><a href="#">Something else here</a></li> <li><a href="#">Separated link</a></li> </ul> </div> </div> </body> </html>
js:
var timeoutApp = angular.module('timeoutApp',[]); timeoutApp.controller('myCtrl',function($scope){ $scope.ifShowMenu = false; }); timeoutApp.directive('dropdown',function($timeout){ return { restrict:"EA", link:function(scope,iele,iattr){ scope.showMenu = function(){ $timeout.cancel(scope.t2); scope.t1 = $timeout(function(){ scope.ifShowMenu = true },500) }; scope.hideMenu = function(){ $timeout.cancel(scope.t1); scope.t2 = $timeout(function(){ scope.ifShowMenu = false },500) }; } } })
程式碼應該很好理解: 就是進入button和進入ul下拉選單的時候,都定義一個timeout回撥(過500毫秒以後顯示下拉選單),同時取消隱藏下拉選單的回撥.而離開button和ul的時候相反.
參考原文: http://docs.angularjs.cn/api/ng/service/$timeout
程式碼地址: https://github.com/OOP-Code-Bunny/angular/tree/master/%24timeout