萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AngularJS 動畫實戰指南:ngAnimate 與 JavaScript 動畫完整範例

啟用動畫模組

首先載入 angular-animate.js 並注入 ngAnimate 依賴:

angular.module('coursesApp', ['ngAnimate']);

載入後,指令會自動觸發對應的動畫事件(enter/leave/move/add/remove 等),無需額外配置。

JavaScript 動畫定義語法

angular.module('coursesApp').animation('.animation-name', function($injectables) {
  return {
    event: function(element, done) {
      // element: jQuery/jqLite 對象
      // done: 動畫結束回調,**必須調用**以通知 Angular 繼續
    }
  };
});

關鍵點:動畫名以 . 開頭;done() 回調機制讓 Angular 能同步等待動畫完成;若頁面先載入 jQuery,element 即為 jQuery 對象,可直接用 .animate()。

常見指令動畫範例

1. ng-view 視圖切換滑入效果

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>

2. ng-repeat 列表進場/離場/移動

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);
    }
  };
});

3. ng-show/ng-hide 淡入淡出(操作 class)

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 服務

若需在自定義指令中觸發動畫,注入 $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 會卡住。
  • 優先使用 CSS3 Transition/Animation(性能更好),複雜序列動畫再用 JS。
  • 避免在 enter/leave 中操作會觸發重排的屬性(如 width/height),改用 transform/opacity。
  • 大量列表動畫時考慮 track by 減少 DOM 重建。
copyright © 萬盛學電腦網 all rights reserved