首先載入 angular-animate.js 並注入 ngAnimate 依賴:
angular.module('coursesApp', ['ngAnimate']);
載入後,指令會自動觸發對應的動畫事件(enter/leave/move/add/remove 等),無需額外配置。
angular.module('coursesApp').animation('.animation-name', function($injectables) {
return {
event: function(element, done) {
// element: jQuery/jqLite 對象
// done: 動畫結束回調,**必須調用**以通知 Angular 繼續
}
};
});
關鍵點:動畫名以
.開頭;done()回調機制讓 Angular 能同步等待動畫完成;若頁面先載入 jQuery,element即為 jQuery 對象,可直接用.animate()。
courseAppAnimations.animation('.view-slide-in', function() {
return {
enter: function(element, done) {
element.css({ opacity: 0.5, position: 'relative', top: '10px', left: '20px' })
.animate({ top: 0, left: 0, opacity: 1 }, 1000, done);
}
};
});
套用:<div ng-view class="view-slide-in"></div>
courseAppAnimations.animation('.repeat-animation', function() {
return {
enter: function(el, done) {
el.css({ position: 'relative', left: -10, opacity: 0 })
.animate({ left: 0, opacity: 1 }, done);
},
leave: function(el, done) {
el.css({ position: 'relative', left: 0, opacity: 1 })
.animate({ left: -10, opacity: 0 }, done);
},
move: function(el, done) {
el.css({ left: '2px', opacity: 0.5 })
.animate({ left: '0px', opacity: 1 }, done);
}
};
});
courseAppAnimations.animation('.hide-animation', function() {
return {
beforeAddClass: function(element, className, done) {
if (className === 'ng-hide') element.animate({ opacity: 0 }, 500, done);
else done();
},
removeClass: function(element, className, done) {
if (className === 'ng-hide') {
element.css('opacity', 0).animate({ opacity: 1 }, 500, done);
} else done();
}
};
});
若需在自定義指令中觸發動畫,注入 $animate 服務(需載入 ngAnimate 才生效):
app.directive('courseStats', ['$animate', function($animate) {
return {
link: function(scope, element, attrs) {
scope.$watch('showDetails', function(newVal) {
if (newVal) $animate.addClass(element, 'show-details');
else $animate.removeClass(element, 'show-details');
});
}
};
}]);
done()**,否則 Angular 會卡住。enter/leave 中操作會觸發重排的屬性(如 width/height),改用 transform/opacity。track by 減少 DOM 重建。