What's new in ngAnimate


Matias Niemelä

ng-conf 2015
[email protected]

Animations in Angular

ngAnimate is used for Animations in Angular

CSS Hooks (transitions/keyframes)

JavaScript Hooks

How does it work again?

Directives use $animate

Which triggers animations

Animations take over

CSS Transitions/Keyframes

.my-animation.ng-enter { transition:0.5s linear all; /* or */ animation:0.5s my_keyframe_animation; opacity:0; } .my-animation.ng-enter.ng-enter-active { opacity:1; }

JavaScript Animations

ngModule.animation('.my-animation', [function() { return { enter: function(element, done) { startAnimation(element, done); } }; }]);

ngAnimate in 1.4

There was a big refactor

A better foundation

Easier to maintain and reuse components

Lots of fixes

Two small breaking changes

What has been Improved?

Better organization of code

Animations are fully promise oriented

Lots of bugs fixed

A handful of new features

New & Improved Callbacks

It's now easier to detect animations

$animate callbacks

// 1.2+ element.addEvent('$animate:enter', function() { // do something }); // 1.4+ $animate.on('enter', container, function() { // do something });

Why have things changed?

Easier to find new elements (ngRepeat)

Events were triggered only on the element

Better Performance

Controller Access

Controller Callbacks

ngModule.controller('MyController', ['$animate', function($animate) { $animate.on('enter', '[ng-view]', function() { // the page is ready! }); }])

Example 1: ng-tube

Where this feature may go

DOM-related callbacks may come in 1.5

In a service called $dom

We can then better detect the state of the UI


Making the most of CSS

What's the deal?

Manipulating CSS is complex

ngAnimate does a great job

We can now make direct use of it

Using a versatile service


var animator = $animateCss(element, { addClass: 'fade', removeClass: 'paused', easing: 'ease-out', duration: 6, from: { 'font-size': '20px' }, to: { 'font-size': '50px' } }); animator.start(); //returns a promise


var a1 = $animateCss(...).start(); var a2 = $animateCss(...).start(); var a3 = $animateCss(...).start(); $q.all([a1, a2, a3]).then(function() { // all animations complete! });

JS Animations + $animateCss

ngModule.animation('.my-animation', ['$animateCss', function($animateCss) { return { enter: function(element, done) { $animateCss(element, { addClass: 'fade', from: { background: 'blue' }, to: { background: 'red' } }).start().then(done); } }; }]);

Example 2: collapsing divs

Anchoring (with CSS)

Remember ngAnimateKeep?


Move one item from view to view

All you need are a couple of HTML attributes

And some simple CSS transition code

Referencing Template Code

<!-- this area is related to... --> <div ng-if="page.activeItem"> <div ng-repeat="item in items" ng-click="page.activeItem=item"> {{ item.summary }} </div> </div> <!-- this area --> <div ng-if="page.activeItem"> {{ item.content }} </div>

Referencing Template Code

<div ng-if="page.activeItem" class="transfer-animation">
  <div ng-repeat="item in items"
       ng-animate-ref="{ { item.id }}"
<div class="transfer-animation"
        ng-animate-ref="{ { page.activeItem.id }}"">

CSS Anchoring

.transfer-animation.ng-enter { animation: enter_animation 0.5s; } .transfer-animation.ng-leave { animation: leave_animation 0.5s; } .transfer-animation-anchor { transition:0.5s linear all; }

Example 3: anchored repeats

Example 4: ng-conf directory

Future Features (1.5 & 2.0)

What is being developed next

Features still being planned

Animations Runners

Custom Drivers

Reversable Animations

JS-level Anchors

Anchor Triggers & Events

Animation Runners (Player)

Soon you will be able to pause/resume/skip animations

Using a player object that is returned from an animation

(We haven't figured out the API yet)

Custom Drivers

Drivers will be able to tackle all animations

And better facilitate data with animations

Or tap deeper into native device animations

(We haven't figured out the API yet)

What about Angular 1.5 & 2.0

NgAnimate is a large amount of code

So 1.4+ and 2.0 will share the same codebase

(Just like how the router works)

This way new features come to everyone

Animations in 2.0

Nothing just yet

But the basics will be the same

Plus low-level device translation

And suppport for timelines


formerly ngAnimateLayout

No we haven't abandoned it!

ngTimeline by itself

The goal is to sequence events

Perhaps even changes to the app

In a sequential/parallel form

ngTimeline + ngAnimate

It is a supercharged animation recipe

That can mix together JS/CSS

And any form of promises can be used

It is designed to fill what CSS/JS can't do

Planned ngTimeline Features

Parallel timelines


Reusable Directives

Smart Device Integration

Example 5: ngTimeline


Twitter: @yearofmoo

Website: www.yearofmoo.com

Email: [email protected]@com