angular-gem 1.3.6 → 1.3.7

Sign up to get free protection for your applications and to get access to all the features.
Files changed (27) hide show
  1. checksums.yaml +8 -8
  2. data/lib/angular-gem/version.rb +1 -1
  3. data/vendor/assets/javascripts/1.3.7/angular-animate.js +2137 -0
  4. data/vendor/assets/javascripts/1.3.7/angular-aria.js +332 -0
  5. data/vendor/assets/javascripts/1.3.7/angular-cookies.js +206 -0
  6. data/vendor/assets/javascripts/1.3.7/angular-loader.js +405 -0
  7. data/vendor/assets/javascripts/1.3.7/angular-messages.js +400 -0
  8. data/vendor/assets/javascripts/1.3.7/angular-mocks.js +2382 -0
  9. data/vendor/assets/javascripts/1.3.7/angular-resource.js +667 -0
  10. data/vendor/assets/javascripts/1.3.7/angular-route.js +995 -0
  11. data/vendor/assets/javascripts/1.3.7/angular-sanitize.js +680 -0
  12. data/vendor/assets/javascripts/1.3.7/angular-scenario.js +37391 -0
  13. data/vendor/assets/javascripts/1.3.7/angular-touch.js +622 -0
  14. data/vendor/assets/javascripts/1.3.7/angular.js +26037 -0
  15. data/vendor/assets/javascripts/angular-animate.js +1 -1
  16. data/vendor/assets/javascripts/angular-aria.js +1 -1
  17. data/vendor/assets/javascripts/angular-cookies.js +1 -1
  18. data/vendor/assets/javascripts/angular-loader.js +2 -2
  19. data/vendor/assets/javascripts/angular-messages.js +1 -1
  20. data/vendor/assets/javascripts/angular-mocks.js +1 -1
  21. data/vendor/assets/javascripts/angular-resource.js +2 -2
  22. data/vendor/assets/javascripts/angular-route.js +1 -1
  23. data/vendor/assets/javascripts/angular-sanitize.js +1 -1
  24. data/vendor/assets/javascripts/angular-scenario.js +137 -100
  25. data/vendor/assets/javascripts/angular-touch.js +1 -1
  26. data/vendor/assets/javascripts/angular.js +137 -100
  27. metadata +15 -3
checksums.yaml CHANGED
@@ -1,15 +1,15 @@
1
1
  ---
2
2
  !binary "U0hBMQ==":
3
3
  metadata.gz: !binary |-
4
- ZWUxZThjN2I3NDU5MDdkZTQ4N2JlZmMwOGFiNDdiYTczOGQyMzgwMQ==
4
+ NmYwZDA2ZWU2NjRkZDNmMzY0Nzc4ODYxNzhhNDc1ZDRlNzZmYTg2Yg==
5
5
  data.tar.gz: !binary |-
6
- ZTRjZTkzNmUxNjM1YmIxYmY0ZWJiNmM0YjNlYTVkNzE1NWZkOTc5OQ==
6
+ MDA4MWVmNzVmMzUyN2QzMTEwODk2ZTlhMDcyMmEzNjI2MGE5MDcxMA==
7
7
  SHA512:
8
8
  metadata.gz: !binary |-
9
- MGU5ZThjM2IxZWMwNGFlZTc1YTJmZTc5ODVjNjA2MDYyMjA0ZGI4ZDE2ZDZj
10
- MWFiMGU4Y2EwMzlmOWI4OGE0YjZlYjNmMjI1MzQ5OGNlZWRmZmQ4MTg4NGRl
11
- OTEwYzQ1ZDBlNzdlOGM4OTMwNjRkNGVjZWNjOWU3ZWY0MmE5Yjg=
9
+ NDc0YzQ0M2IwZWI1YjkxYWIyODZjZWU1NGY4MTAxMDAwZDY0NWRhMDMzYWMw
10
+ YWViMTRmZTZhODFmNmIwNjhkZDIyZmFmODM1YTEyNGExODhiNjgzODFiZGEx
11
+ ZDkwMDcxYWFlMTQ3NjgyZjc5MWNhZGI5ODYyYjZjNWI4M2NlMGQ=
12
12
  data.tar.gz: !binary |-
13
- ZmVlYmE5YzUxZWE5ODkyNTJiOTU1YmI0OGQ0NTMwMGNjMmRmYWJhYzc0ZjA4
14
- ZTVmZTNlZWNjZWYzNmJmZjZmZjRkYzY4YWQ2NmE1MGFjNjczMzY4NWQzNGNk
15
- YjgyOWE5MmJkMmMyODRjZTUyNjMzM2QyZTk0MmMzZjJkYTA4Njg=
13
+ YWVlMTA4YjA1MzBhMzk3NmM0ZWM3ZWJkNjk2MmVhOTJhN2VmOGI4MzE2NzVk
14
+ N2U4YWU3NmYzZDc2MDNkZGU1MTFiZDUxNGIyYTA2ZTI4OTE3ZmQzZTE5ZTQw
15
+ ODAyMTRjZWM5ZmQwZDQ4MDgxNzNhZTc5NGMwNDJkYTJjNzg2NTE=
@@ -1,3 +1,3 @@
1
1
  module AngularGem
2
- VERSION = "1.3.6"
2
+ VERSION = "1.3.7"
3
3
  end
@@ -0,0 +1,2137 @@
1
+ /**
2
+ * @license AngularJS v1.3.7
3
+ * (c) 2010-2014 Google, Inc. http://angularjs.org
4
+ * License: MIT
5
+ */
6
+ (function(window, angular, undefined) {'use strict';
7
+
8
+ /* jshint maxlen: false */
9
+
10
+ /**
11
+ * @ngdoc module
12
+ * @name ngAnimate
13
+ * @description
14
+ *
15
+ * The `ngAnimate` module provides support for JavaScript, CSS3 transition and CSS3 keyframe animation hooks within existing core and custom directives.
16
+ *
17
+ * <div doc-module-components="ngAnimate"></div>
18
+ *
19
+ * # Usage
20
+ *
21
+ * To see animations in action, all that is required is to define the appropriate CSS classes
22
+ * or to register a JavaScript animation via the `myModule.animation()` function. The directives that support animation automatically are:
23
+ * `ngRepeat`, `ngInclude`, `ngIf`, `ngSwitch`, `ngShow`, `ngHide`, `ngView` and `ngClass`. Custom directives can take advantage of animation
24
+ * by using the `$animate` service.
25
+ *
26
+ * Below is a more detailed breakdown of the supported animation events provided by pre-existing ng directives:
27
+ *
28
+ * | Directive | Supported Animations |
29
+ * |----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|
30
+ * | {@link ng.directive:ngRepeat#animations ngRepeat} | enter, leave and move |
31
+ * | {@link ngRoute.directive:ngView#animations ngView} | enter and leave |
32
+ * | {@link ng.directive:ngInclude#animations ngInclude} | enter and leave |
33
+ * | {@link ng.directive:ngSwitch#animations ngSwitch} | enter and leave |
34
+ * | {@link ng.directive:ngIf#animations ngIf} | enter and leave |
35
+ * | {@link ng.directive:ngClass#animations ngClass} | add and remove (the CSS class(es) present) |
36
+ * | {@link ng.directive:ngShow#animations ngShow} & {@link ng.directive:ngHide#animations ngHide} | add and remove (the ng-hide class value) |
37
+ * | {@link ng.directive:form#animation-hooks form} & {@link ng.directive:ngModel#animation-hooks ngModel} | add and remove (dirty, pristine, valid, invalid & all other validations) |
38
+ * | {@link module:ngMessages#animations ngMessages} | add and remove (ng-active & ng-inactive) |
39
+ * | {@link module:ngMessages#animations ngMessage} | enter and leave |
40
+ *
41
+ * You can find out more information about animations upon visiting each directive page.
42
+ *
43
+ * Below is an example of how to apply animations to a directive that supports animation hooks:
44
+ *
45
+ * ```html
46
+ * <style type="text/css">
47
+ * .slide.ng-enter, .slide.ng-leave {
48
+ * -webkit-transition:0.5s linear all;
49
+ * transition:0.5s linear all;
50
+ * }
51
+ *
52
+ * .slide.ng-enter { } /&#42; starting animations for enter &#42;/
53
+ * .slide.ng-enter.ng-enter-active { } /&#42; terminal animations for enter &#42;/
54
+ * .slide.ng-leave { } /&#42; starting animations for leave &#42;/
55
+ * .slide.ng-leave.ng-leave-active { } /&#42; terminal animations for leave &#42;/
56
+ * </style>
57
+ *
58
+ * <!--
59
+ * the animate service will automatically add .ng-enter and .ng-leave to the element
60
+ * to trigger the CSS transition/animations
61
+ * -->
62
+ * <ANY class="slide" ng-include="..."></ANY>
63
+ * ```
64
+ *
65
+ * Keep in mind that, by default, if an animation is running, any child elements cannot be animated
66
+ * until the parent element's animation has completed. This blocking feature can be overridden by
67
+ * placing the `ng-animate-children` attribute on a parent container tag.
68
+ *
69
+ * ```html
70
+ * <div class="slide-animation" ng-if="on" ng-animate-children>
71
+ * <div class="fade-animation" ng-if="on">
72
+ * <div class="explode-animation" ng-if="on">
73
+ * ...
74
+ * </div>
75
+ * </div>
76
+ * </div>
77
+ * ```
78
+ *
79
+ * When the `on` expression value changes and an animation is triggered then each of the elements within
80
+ * will all animate without the block being applied to child elements.
81
+ *
82
+ * ## Are animations run when the application starts?
83
+ * No they are not. When an application is bootstrapped Angular will disable animations from running to avoid
84
+ * a frenzy of animations from being triggered as soon as the browser has rendered the screen. For this to work,
85
+ * Angular will wait for two digest cycles until enabling animations. From there on, any animation-triggering
86
+ * layout changes in the application will trigger animations as normal.
87
+ *
88
+ * In addition, upon bootstrap, if the routing system or any directives or load remote data (via $http) then Angular
89
+ * will automatically extend the wait time to enable animations once **all** of the outbound HTTP requests
90
+ * are complete.
91
+ *
92
+ * ## CSS-defined Animations
93
+ * The animate service will automatically apply two CSS classes to the animated element and these two CSS classes
94
+ * are designed to contain the start and end CSS styling. Both CSS transitions and keyframe animations are supported
95
+ * and can be used to play along with this naming structure.
96
+ *
97
+ * The following code below demonstrates how to perform animations using **CSS transitions** with Angular:
98
+ *
99
+ * ```html
100
+ * <style type="text/css">
101
+ * /&#42;
102
+ * The animate class is apart of the element and the ng-enter class
103
+ * is attached to the element once the enter animation event is triggered
104
+ * &#42;/
105
+ * .reveal-animation.ng-enter {
106
+ * -webkit-transition: 1s linear all; /&#42; Safari/Chrome &#42;/
107
+ * transition: 1s linear all; /&#42; All other modern browsers and IE10+ &#42;/
108
+ *
109
+ * /&#42; The animation preparation code &#42;/
110
+ * opacity: 0;
111
+ * }
112
+ *
113
+ * /&#42;
114
+ * Keep in mind that you want to combine both CSS
115
+ * classes together to avoid any CSS-specificity
116
+ * conflicts
117
+ * &#42;/
118
+ * .reveal-animation.ng-enter.ng-enter-active {
119
+ * /&#42; The animation code itself &#42;/
120
+ * opacity: 1;
121
+ * }
122
+ * </style>
123
+ *
124
+ * <div class="view-container">
125
+ * <div ng-view class="reveal-animation"></div>
126
+ * </div>
127
+ * ```
128
+ *
129
+ * The following code below demonstrates how to perform animations using **CSS animations** with Angular:
130
+ *
131
+ * ```html
132
+ * <style type="text/css">
133
+ * .reveal-animation.ng-enter {
134
+ * -webkit-animation: enter_sequence 1s linear; /&#42; Safari/Chrome &#42;/
135
+ * animation: enter_sequence 1s linear; /&#42; IE10+ and Future Browsers &#42;/
136
+ * }
137
+ * @-webkit-keyframes enter_sequence {
138
+ * from { opacity:0; }
139
+ * to { opacity:1; }
140
+ * }
141
+ * @keyframes enter_sequence {
142
+ * from { opacity:0; }
143
+ * to { opacity:1; }
144
+ * }
145
+ * </style>
146
+ *
147
+ * <div class="view-container">
148
+ * <div ng-view class="reveal-animation"></div>
149
+ * </div>
150
+ * ```
151
+ *
152
+ * Both CSS3 animations and transitions can be used together and the animate service will figure out the correct duration and delay timing.
153
+ *
154
+ * Upon DOM mutation, the event class is added first (something like `ng-enter`), then the browser prepares itself to add
155
+ * the active class (in this case `ng-enter-active`) which then triggers the animation. The animation module will automatically
156
+ * detect the CSS code to determine when the animation ends. Once the animation is over then both CSS classes will be
157
+ * removed from the DOM. If a browser does not support CSS transitions or CSS animations then the animation will start and end
158
+ * immediately resulting in a DOM element that is at its final state. This final state is when the DOM element
159
+ * has no CSS transition/animation classes applied to it.
160
+ *
161
+ * ### Structural transition animations
162
+ *
163
+ * Structural transitions (such as enter, leave and move) will always apply a `0s none` transition
164
+ * value to force the browser into rendering the styles defined in the setup (`.ng-enter`, `.ng-leave`
165
+ * or `.ng-move`) class. This means that any active transition animations operating on the element
166
+ * will be cut off to make way for the enter, leave or move animation.
167
+ *
168
+ * ### Class-based transition animations
169
+ *
170
+ * Class-based transitions refer to transition animations that are triggered when a CSS class is
171
+ * added to or removed from the element (via `$animate.addClass`, `$animate.removeClass`,
172
+ * `$animate.setClass`, or by directives such as `ngClass`, `ngModel` and `form`).
173
+ * They are different when compared to structural animations since they **do not cancel existing
174
+ * animations** nor do they **block successive transitions** from rendering on the same element.
175
+ * This distinction allows for **multiple class-based transitions** to be performed on the same element.
176
+ *
177
+ * In addition to ngAnimate supporting the default (natural) functionality of class-based transition
178
+ * animations, ngAnimate also decorates the element with starting and ending CSS classes to aid the
179
+ * developer in further styling the element throughout the transition animation. Earlier versions
180
+ * of ngAnimate may have caused natural CSS transitions to break and not render properly due to
181
+ * $animate temporarily blocking transitions using `0s none` in order to allow the setup CSS class
182
+ * (the `-add` or `-remove` class) to be applied without triggering an animation. However, as of
183
+ * **version 1.3**, this workaround has been removed with ngAnimate and all non-ngAnimate CSS
184
+ * class transitions are compatible with ngAnimate.
185
+ *
186
+ * There is, however, one special case when dealing with class-based transitions in ngAnimate.
187
+ * When rendering class-based transitions that make use of the setup and active CSS classes
188
+ * (e.g. `.fade-add` and `.fade-add-active` for when `.fade` is added) be sure to define
189
+ * the transition value **on the active CSS class** and not the setup class.
190
+ *
191
+ * ```css
192
+ * .fade-add {
193
+ * /&#42; remember to place a 0s transition here
194
+ * to ensure that the styles are applied instantly
195
+ * even if the element already has a transition style &#42;/
196
+ * transition:0s linear all;
197
+ *
198
+ * /&#42; starting CSS styles &#42;/
199
+ * opacity:1;
200
+ * }
201
+ * .fade-add.fade-add-active {
202
+ * /&#42; this will be the length of the animation &#42;/
203
+ * transition:1s linear all;
204
+ * opacity:0;
205
+ * }
206
+ * ```
207
+ *
208
+ * The setup CSS class (in this case `.fade-add`) also has a transition style property, however, it
209
+ * has a duration of zero. This may not be required, however, incase the browser is unable to render
210
+ * the styling present in this CSS class instantly then it could be that the browser is attempting
211
+ * to perform an unnecessary transition.
212
+ *
213
+ * This workaround, however, does not apply to standard class-based transitions that are rendered
214
+ * when a CSS class containing a transition is applied to an element:
215
+ *
216
+ * ```css
217
+ * /&#42; this works as expected &#42;/
218
+ * .fade {
219
+ * transition:1s linear all;
220
+ * opacity:0;
221
+ * }
222
+ * ```
223
+ *
224
+ * Please keep this in mind when coding the CSS markup that will be used within class-based transitions.
225
+ * Also, try not to mix the two class-based animation flavors together since the CSS code may become
226
+ * overly complex.
227
+ *
228
+ *
229
+ * ### Preventing Collisions With Third Party Libraries
230
+ *
231
+ * Some third-party frameworks place animation duration defaults across many element or className
232
+ * selectors in order to make their code small and reuseable. This can lead to issues with ngAnimate, which
233
+ * is expecting actual animations on these elements and has to wait for their completion.
234
+ *
235
+ * You can prevent this unwanted behavior by using a prefix on all your animation classes:
236
+ *
237
+ * ```css
238
+ * /&#42; prefixed with animate- &#42;/
239
+ * .animate-fade-add.animate-fade-add-active {
240
+ * transition:1s linear all;
241
+ * opacity:0;
242
+ * }
243
+ * ```
244
+ *
245
+ * You then configure `$animate` to enforce this prefix:
246
+ *
247
+ * ```js
248
+ * $animateProvider.classNameFilter(/animate-/);
249
+ * ```
250
+ * </div>
251
+ *
252
+ * ### CSS Staggering Animations
253
+ * A Staggering animation is a collection of animations that are issued with a slight delay in between each successive operation resulting in a
254
+ * curtain-like effect. The ngAnimate module (versions >=1.2) supports staggering animations and the stagger effect can be
255
+ * performed by creating a **ng-EVENT-stagger** CSS class and attaching that class to the base CSS class used for
256
+ * the animation. The style property expected within the stagger class can either be a **transition-delay** or an
257
+ * **animation-delay** property (or both if your animation contains both transitions and keyframe animations).
258
+ *
259
+ * ```css
260
+ * .my-animation.ng-enter {
261
+ * /&#42; standard transition code &#42;/
262
+ * -webkit-transition: 1s linear all;
263
+ * transition: 1s linear all;
264
+ * opacity:0;
265
+ * }
266
+ * .my-animation.ng-enter-stagger {
267
+ * /&#42; this will have a 100ms delay between each successive leave animation &#42;/
268
+ * -webkit-transition-delay: 0.1s;
269
+ * transition-delay: 0.1s;
270
+ *
271
+ * /&#42; in case the stagger doesn't work then these two values
272
+ * must be set to 0 to avoid an accidental CSS inheritance &#42;/
273
+ * -webkit-transition-duration: 0s;
274
+ * transition-duration: 0s;
275
+ * }
276
+ * .my-animation.ng-enter.ng-enter-active {
277
+ * /&#42; standard transition styles &#42;/
278
+ * opacity:1;
279
+ * }
280
+ * ```
281
+ *
282
+ * Staggering animations work by default in ngRepeat (so long as the CSS class is defined). Outside of ngRepeat, to use staggering animations
283
+ * on your own, they can be triggered by firing multiple calls to the same event on $animate. However, the restrictions surrounding this
284
+ * are that each of the elements must have the same CSS className value as well as the same parent element. A stagger operation
285
+ * will also be reset if more than 10ms has passed after the last animation has been fired.
286
+ *
287
+ * The following code will issue the **ng-leave-stagger** event on the element provided:
288
+ *
289
+ * ```js
290
+ * var kids = parent.children();
291
+ *
292
+ * $animate.leave(kids[0]); //stagger index=0
293
+ * $animate.leave(kids[1]); //stagger index=1
294
+ * $animate.leave(kids[2]); //stagger index=2
295
+ * $animate.leave(kids[3]); //stagger index=3
296
+ * $animate.leave(kids[4]); //stagger index=4
297
+ *
298
+ * $timeout(function() {
299
+ * //stagger has reset itself
300
+ * $animate.leave(kids[5]); //stagger index=0
301
+ * $animate.leave(kids[6]); //stagger index=1
302
+ * }, 100, false);
303
+ * ```
304
+ *
305
+ * Stagger animations are currently only supported within CSS-defined animations.
306
+ *
307
+ * ## JavaScript-defined Animations
308
+ * In the event that you do not want to use CSS3 transitions or CSS3 animations or if you wish to offer animations on browsers that do not
309
+ * yet support CSS transitions/animations, then you can make use of JavaScript animations defined inside of your AngularJS module.
310
+ *
311
+ * ```js
312
+ * //!annotate="YourApp" Your AngularJS Module|Replace this or ngModule with the module that you used to define your application.
313
+ * var ngModule = angular.module('YourApp', ['ngAnimate']);
314
+ * ngModule.animation('.my-crazy-animation', function() {
315
+ * return {
316
+ * enter: function(element, done) {
317
+ * //run the animation here and call done when the animation is complete
318
+ * return function(cancelled) {
319
+ * //this (optional) function will be called when the animation
320
+ * //completes or when the animation is cancelled (the cancelled
321
+ * //flag will be set to true if cancelled).
322
+ * };
323
+ * },
324
+ * leave: function(element, done) { },
325
+ * move: function(element, done) { },
326
+ *
327
+ * //animation that can be triggered before the class is added
328
+ * beforeAddClass: function(element, className, done) { },
329
+ *
330
+ * //animation that can be triggered after the class is added
331
+ * addClass: function(element, className, done) { },
332
+ *
333
+ * //animation that can be triggered before the class is removed
334
+ * beforeRemoveClass: function(element, className, done) { },
335
+ *
336
+ * //animation that can be triggered after the class is removed
337
+ * removeClass: function(element, className, done) { }
338
+ * };
339
+ * });
340
+ * ```
341
+ *
342
+ * JavaScript-defined animations are created with a CSS-like class selector and a collection of events which are set to run
343
+ * a javascript callback function. When an animation is triggered, $animate will look for a matching animation which fits
344
+ * the element's CSS class attribute value and then run the matching animation event function (if found).
345
+ * In other words, if the CSS classes present on the animated element match any of the JavaScript animations then the callback function will
346
+ * be executed. It should be also noted that only simple, single class selectors are allowed (compound class selectors are not supported).
347
+ *
348
+ * Within a JavaScript animation, an object containing various event callback animation functions is expected to be returned.
349
+ * As explained above, these callbacks are triggered based on the animation event. Therefore if an enter animation is run,
350
+ * and the JavaScript animation is found, then the enter callback will handle that animation (in addition to the CSS keyframe animation
351
+ * or transition code that is defined via a stylesheet).
352
+ *
353
+ *
354
+ * ### Applying Directive-specific Styles to an Animation
355
+ * In some cases a directive or service may want to provide `$animate` with extra details that the animation will
356
+ * include into its animation. Let's say for example we wanted to render an animation that animates an element
357
+ * towards the mouse coordinates as to where the user clicked last. By collecting the X/Y coordinates of the click
358
+ * (via the event parameter) we can set the `top` and `left` styles into an object and pass that into our function
359
+ * call to `$animate.addClass`.
360
+ *
361
+ * ```js
362
+ * canvas.on('click', function(e) {
363
+ * $animate.addClass(element, 'on', {
364
+ * to: {
365
+ * left : e.client.x + 'px',
366
+ * top : e.client.y + 'px'
367
+ * }
368
+ * }):
369
+ * });
370
+ * ```
371
+ *
372
+ * Now when the animation runs, and a transition or keyframe animation is picked up, then the animation itself will
373
+ * also include and transition the styling of the `left` and `top` properties into its running animation. If we want
374
+ * to provide some starting animation values then we can do so by placing the starting animations styles into an object
375
+ * called `from` in the same object as the `to` animations.
376
+ *
377
+ * ```js
378
+ * canvas.on('click', function(e) {
379
+ * $animate.addClass(element, 'on', {
380
+ * from: {
381
+ * position: 'absolute',
382
+ * left: '0px',
383
+ * top: '0px'
384
+ * },
385
+ * to: {
386
+ * left : e.client.x + 'px',
387
+ * top : e.client.y + 'px'
388
+ * }
389
+ * }):
390
+ * });
391
+ * ```
392
+ *
393
+ * Once the animation is complete or cancelled then the union of both the before and after styles are applied to the
394
+ * element. If `ngAnimate` is not present then the styles will be applied immediately.
395
+ *
396
+ */
397
+
398
+ angular.module('ngAnimate', ['ng'])
399
+
400
+ /**
401
+ * @ngdoc provider
402
+ * @name $animateProvider
403
+ * @description
404
+ *
405
+ * The `$animateProvider` allows developers to register JavaScript animation event handlers directly inside of a module.
406
+ * When an animation is triggered, the $animate service will query the $animate service to find any animations that match
407
+ * the provided name value.
408
+ *
409
+ * Requires the {@link ngAnimate `ngAnimate`} module to be installed.
410
+ *
411
+ * Please visit the {@link ngAnimate `ngAnimate`} module overview page learn more about how to use animations in your application.
412
+ *
413
+ */
414
+ .directive('ngAnimateChildren', function() {
415
+ var NG_ANIMATE_CHILDREN = '$$ngAnimateChildren';
416
+ return function(scope, element, attrs) {
417
+ var val = attrs.ngAnimateChildren;
418
+ if (angular.isString(val) && val.length === 0) { //empty attribute
419
+ element.data(NG_ANIMATE_CHILDREN, true);
420
+ } else {
421
+ scope.$watch(val, function(value) {
422
+ element.data(NG_ANIMATE_CHILDREN, !!value);
423
+ });
424
+ }
425
+ };
426
+ })
427
+
428
+ //this private service is only used within CSS-enabled animations
429
+ //IE8 + IE9 do not support rAF natively, but that is fine since they
430
+ //also don't support transitions and keyframes which means that the code
431
+ //below will never be used by the two browsers.
432
+ .factory('$$animateReflow', ['$$rAF', '$document', function($$rAF, $document) {
433
+ var bod = $document[0].body;
434
+ return function(fn) {
435
+ //the returned function acts as the cancellation function
436
+ return $$rAF(function() {
437
+ //the line below will force the browser to perform a repaint
438
+ //so that all the animated elements within the animation frame
439
+ //will be properly updated and drawn on screen. This is
440
+ //required to perform multi-class CSS based animations with
441
+ //Firefox. DO NOT REMOVE THIS LINE.
442
+ var a = bod.offsetWidth + 1;
443
+ fn();
444
+ });
445
+ };
446
+ }])
447
+
448
+ .config(['$provide', '$animateProvider', function($provide, $animateProvider) {
449
+ var noop = angular.noop;
450
+ var forEach = angular.forEach;
451
+ var selectors = $animateProvider.$$selectors;
452
+ var isArray = angular.isArray;
453
+ var isString = angular.isString;
454
+ var isObject = angular.isObject;
455
+
456
+ var ELEMENT_NODE = 1;
457
+ var NG_ANIMATE_STATE = '$$ngAnimateState';
458
+ var NG_ANIMATE_CHILDREN = '$$ngAnimateChildren';
459
+ var NG_ANIMATE_CLASS_NAME = 'ng-animate';
460
+ var rootAnimateState = {running: true};
461
+
462
+ function extractElementNode(element) {
463
+ for (var i = 0; i < element.length; i++) {
464
+ var elm = element[i];
465
+ if (elm.nodeType == ELEMENT_NODE) {
466
+ return elm;
467
+ }
468
+ }
469
+ }
470
+
471
+ function prepareElement(element) {
472
+ return element && angular.element(element);
473
+ }
474
+
475
+ function stripCommentsFromElement(element) {
476
+ return angular.element(extractElementNode(element));
477
+ }
478
+
479
+ function isMatchingElement(elm1, elm2) {
480
+ return extractElementNode(elm1) == extractElementNode(elm2);
481
+ }
482
+ var $$jqLite;
483
+ $provide.decorator('$animate',
484
+ ['$delegate', '$$q', '$injector', '$sniffer', '$rootElement', '$$asyncCallback', '$rootScope', '$document', '$templateRequest', '$$jqLite',
485
+ function($delegate, $$q, $injector, $sniffer, $rootElement, $$asyncCallback, $rootScope, $document, $templateRequest, $$$jqLite) {
486
+
487
+ $$jqLite = $$$jqLite;
488
+ $rootElement.data(NG_ANIMATE_STATE, rootAnimateState);
489
+
490
+ // Wait until all directive and route-related templates are downloaded and
491
+ // compiled. The $templateRequest.totalPendingRequests variable keeps track of
492
+ // all of the remote templates being currently downloaded. If there are no
493
+ // templates currently downloading then the watcher will still fire anyway.
494
+ var deregisterWatch = $rootScope.$watch(
495
+ function() { return $templateRequest.totalPendingRequests; },
496
+ function(val, oldVal) {
497
+ if (val !== 0) return;
498
+ deregisterWatch();
499
+
500
+ // Now that all templates have been downloaded, $animate will wait until
501
+ // the post digest queue is empty before enabling animations. By having two
502
+ // calls to $postDigest calls we can ensure that the flag is enabled at the
503
+ // very end of the post digest queue. Since all of the animations in $animate
504
+ // use $postDigest, it's important that the code below executes at the end.
505
+ // This basically means that the page is fully downloaded and compiled before
506
+ // any animations are triggered.
507
+ $rootScope.$$postDigest(function() {
508
+ $rootScope.$$postDigest(function() {
509
+ rootAnimateState.running = false;
510
+ });
511
+ });
512
+ }
513
+ );
514
+
515
+ var globalAnimationCounter = 0;
516
+ var classNameFilter = $animateProvider.classNameFilter();
517
+ var isAnimatableClassName = !classNameFilter
518
+ ? function() { return true; }
519
+ : function(className) {
520
+ return classNameFilter.test(className);
521
+ };
522
+
523
+ function classBasedAnimationsBlocked(element, setter) {
524
+ var data = element.data(NG_ANIMATE_STATE) || {};
525
+ if (setter) {
526
+ data.running = true;
527
+ data.structural = true;
528
+ element.data(NG_ANIMATE_STATE, data);
529
+ }
530
+ return data.disabled || (data.running && data.structural);
531
+ }
532
+
533
+ function runAnimationPostDigest(fn) {
534
+ var cancelFn, defer = $$q.defer();
535
+ defer.promise.$$cancelFn = function() {
536
+ cancelFn && cancelFn();
537
+ };
538
+ $rootScope.$$postDigest(function() {
539
+ cancelFn = fn(function() {
540
+ defer.resolve();
541
+ });
542
+ });
543
+ return defer.promise;
544
+ }
545
+
546
+ function parseAnimateOptions(options) {
547
+ // some plugin code may still be passing in the callback
548
+ // function as the last param for the $animate methods so
549
+ // it's best to only allow string or array values for now
550
+ if (isObject(options)) {
551
+ if (options.tempClasses && isString(options.tempClasses)) {
552
+ options.tempClasses = options.tempClasses.split(/\s+/);
553
+ }
554
+ return options;
555
+ }
556
+ }
557
+
558
+ function resolveElementClasses(element, cache, runningAnimations) {
559
+ runningAnimations = runningAnimations || {};
560
+
561
+ var lookup = {};
562
+ forEach(runningAnimations, function(data, selector) {
563
+ forEach(selector.split(' '), function(s) {
564
+ lookup[s]=data;
565
+ });
566
+ });
567
+
568
+ var hasClasses = Object.create(null);
569
+ forEach((element.attr('class') || '').split(/\s+/), function(className) {
570
+ hasClasses[className] = true;
571
+ });
572
+
573
+ var toAdd = [], toRemove = [];
574
+ forEach((cache && cache.classes) || [], function(status, className) {
575
+ var hasClass = hasClasses[className];
576
+ var matchingAnimation = lookup[className] || {};
577
+
578
+ // When addClass and removeClass is called then $animate will check to
579
+ // see if addClass and removeClass cancel each other out. When there are
580
+ // more calls to removeClass than addClass then the count falls below 0
581
+ // and then the removeClass animation will be allowed. Otherwise if the
582
+ // count is above 0 then that means an addClass animation will commence.
583
+ // Once an animation is allowed then the code will also check to see if
584
+ // there exists any on-going animation that is already adding or remvoing
585
+ // the matching CSS class.
586
+ if (status === false) {
587
+ //does it have the class or will it have the class
588
+ if (hasClass || matchingAnimation.event == 'addClass') {
589
+ toRemove.push(className);
590
+ }
591
+ } else if (status === true) {
592
+ //is the class missing or will it be removed?
593
+ if (!hasClass || matchingAnimation.event == 'removeClass') {
594
+ toAdd.push(className);
595
+ }
596
+ }
597
+ });
598
+
599
+ return (toAdd.length + toRemove.length) > 0 && [toAdd.join(' '), toRemove.join(' ')];
600
+ }
601
+
602
+ function lookup(name) {
603
+ if (name) {
604
+ var matches = [],
605
+ flagMap = {},
606
+ classes = name.substr(1).split('.');
607
+
608
+ //the empty string value is the default animation
609
+ //operation which performs CSS transition and keyframe
610
+ //animations sniffing. This is always included for each
611
+ //element animation procedure if the browser supports
612
+ //transitions and/or keyframe animations. The default
613
+ //animation is added to the top of the list to prevent
614
+ //any previous animations from affecting the element styling
615
+ //prior to the element being animated.
616
+ if ($sniffer.transitions || $sniffer.animations) {
617
+ matches.push($injector.get(selectors['']));
618
+ }
619
+
620
+ for (var i=0; i < classes.length; i++) {
621
+ var klass = classes[i],
622
+ selectorFactoryName = selectors[klass];
623
+ if (selectorFactoryName && !flagMap[klass]) {
624
+ matches.push($injector.get(selectorFactoryName));
625
+ flagMap[klass] = true;
626
+ }
627
+ }
628
+ return matches;
629
+ }
630
+ }
631
+
632
+ function animationRunner(element, animationEvent, className, options) {
633
+ //transcluded directives may sometimes fire an animation using only comment nodes
634
+ //best to catch this early on to prevent any animation operations from occurring
635
+ var node = element[0];
636
+ if (!node) {
637
+ return;
638
+ }
639
+
640
+ if (options) {
641
+ options.to = options.to || {};
642
+ options.from = options.from || {};
643
+ }
644
+
645
+ var classNameAdd;
646
+ var classNameRemove;
647
+ if (isArray(className)) {
648
+ classNameAdd = className[0];
649
+ classNameRemove = className[1];
650
+ if (!classNameAdd) {
651
+ className = classNameRemove;
652
+ animationEvent = 'removeClass';
653
+ } else if (!classNameRemove) {
654
+ className = classNameAdd;
655
+ animationEvent = 'addClass';
656
+ } else {
657
+ className = classNameAdd + ' ' + classNameRemove;
658
+ }
659
+ }
660
+
661
+ var isSetClassOperation = animationEvent == 'setClass';
662
+ var isClassBased = isSetClassOperation
663
+ || animationEvent == 'addClass'
664
+ || animationEvent == 'removeClass'
665
+ || animationEvent == 'animate';
666
+
667
+ var currentClassName = element.attr('class');
668
+ var classes = currentClassName + ' ' + className;
669
+ if (!isAnimatableClassName(classes)) {
670
+ return;
671
+ }
672
+
673
+ var beforeComplete = noop,
674
+ beforeCancel = [],
675
+ before = [],
676
+ afterComplete = noop,
677
+ afterCancel = [],
678
+ after = [];
679
+
680
+ var animationLookup = (' ' + classes).replace(/\s+/g,'.');
681
+ forEach(lookup(animationLookup), function(animationFactory) {
682
+ var created = registerAnimation(animationFactory, animationEvent);
683
+ if (!created && isSetClassOperation) {
684
+ registerAnimation(animationFactory, 'addClass');
685
+ registerAnimation(animationFactory, 'removeClass');
686
+ }
687
+ });
688
+
689
+ function registerAnimation(animationFactory, event) {
690
+ var afterFn = animationFactory[event];
691
+ var beforeFn = animationFactory['before' + event.charAt(0).toUpperCase() + event.substr(1)];
692
+ if (afterFn || beforeFn) {
693
+ if (event == 'leave') {
694
+ beforeFn = afterFn;
695
+ //when set as null then animation knows to skip this phase
696
+ afterFn = null;
697
+ }
698
+ after.push({
699
+ event: event, fn: afterFn
700
+ });
701
+ before.push({
702
+ event: event, fn: beforeFn
703
+ });
704
+ return true;
705
+ }
706
+ }
707
+
708
+ function run(fns, cancellations, allCompleteFn) {
709
+ var animations = [];
710
+ forEach(fns, function(animation) {
711
+ animation.fn && animations.push(animation);
712
+ });
713
+
714
+ var count = 0;
715
+ function afterAnimationComplete(index) {
716
+ if (cancellations) {
717
+ (cancellations[index] || noop)();
718
+ if (++count < animations.length) return;
719
+ cancellations = null;
720
+ }
721
+ allCompleteFn();
722
+ }
723
+
724
+ //The code below adds directly to the array in order to work with
725
+ //both sync and async animations. Sync animations are when the done()
726
+ //operation is called right away. DO NOT REFACTOR!
727
+ forEach(animations, function(animation, index) {
728
+ var progress = function() {
729
+ afterAnimationComplete(index);
730
+ };
731
+ switch (animation.event) {
732
+ case 'setClass':
733
+ cancellations.push(animation.fn(element, classNameAdd, classNameRemove, progress, options));
734
+ break;
735
+ case 'animate':
736
+ cancellations.push(animation.fn(element, className, options.from, options.to, progress));
737
+ break;
738
+ case 'addClass':
739
+ cancellations.push(animation.fn(element, classNameAdd || className, progress, options));
740
+ break;
741
+ case 'removeClass':
742
+ cancellations.push(animation.fn(element, classNameRemove || className, progress, options));
743
+ break;
744
+ default:
745
+ cancellations.push(animation.fn(element, progress, options));
746
+ break;
747
+ }
748
+ });
749
+
750
+ if (cancellations && cancellations.length === 0) {
751
+ allCompleteFn();
752
+ }
753
+ }
754
+
755
+ return {
756
+ node: node,
757
+ event: animationEvent,
758
+ className: className,
759
+ isClassBased: isClassBased,
760
+ isSetClassOperation: isSetClassOperation,
761
+ applyStyles: function() {
762
+ if (options) {
763
+ element.css(angular.extend(options.from || {}, options.to || {}));
764
+ }
765
+ },
766
+ before: function(allCompleteFn) {
767
+ beforeComplete = allCompleteFn;
768
+ run(before, beforeCancel, function() {
769
+ beforeComplete = noop;
770
+ allCompleteFn();
771
+ });
772
+ },
773
+ after: function(allCompleteFn) {
774
+ afterComplete = allCompleteFn;
775
+ run(after, afterCancel, function() {
776
+ afterComplete = noop;
777
+ allCompleteFn();
778
+ });
779
+ },
780
+ cancel: function() {
781
+ if (beforeCancel) {
782
+ forEach(beforeCancel, function(cancelFn) {
783
+ (cancelFn || noop)(true);
784
+ });
785
+ beforeComplete(true);
786
+ }
787
+ if (afterCancel) {
788
+ forEach(afterCancel, function(cancelFn) {
789
+ (cancelFn || noop)(true);
790
+ });
791
+ afterComplete(true);
792
+ }
793
+ }
794
+ };
795
+ }
796
+
797
+ /**
798
+ * @ngdoc service
799
+ * @name $animate
800
+ * @kind object
801
+ *
802
+ * @description
803
+ * The `$animate` service provides animation detection support while performing DOM operations (enter, leave and move) as well as during addClass and removeClass operations.
804
+ * When any of these operations are run, the $animate service
805
+ * will examine any JavaScript-defined animations (which are defined by using the $animateProvider provider object)
806
+ * as well as any CSS-defined animations against the CSS classes present on the element once the DOM operation is run.
807
+ *
808
+ * The `$animate` service is used behind the scenes with pre-existing directives and animation with these directives
809
+ * will work out of the box without any extra configuration.
810
+ *
811
+ * Requires the {@link ngAnimate `ngAnimate`} module to be installed.
812
+ *
813
+ * Please visit the {@link ngAnimate `ngAnimate`} module overview page learn more about how to use animations in your application.
814
+ * ## Callback Promises
815
+ * With AngularJS 1.3, each of the animation methods, on the `$animate` service, return a promise when called. The
816
+ * promise itself is then resolved once the animation has completed itself, has been cancelled or has been
817
+ * skipped due to animations being disabled. (Note that even if the animation is cancelled it will still
818
+ * call the resolve function of the animation.)
819
+ *
820
+ * ```js
821
+ * $animate.enter(element, container).then(function() {
822
+ * //...this is called once the animation is complete...
823
+ * });
824
+ * ```
825
+ *
826
+ * Also note that, due to the nature of the callback promise, if any Angular-specific code (like changing the scope,
827
+ * location of the page, etc...) is executed within the callback promise then be sure to wrap the code using
828
+ * `$scope.$apply(...)`;
829
+ *
830
+ * ```js
831
+ * $animate.leave(element).then(function() {
832
+ * $scope.$apply(function() {
833
+ * $location.path('/new-page');
834
+ * });
835
+ * });
836
+ * ```
837
+ *
838
+ * An animation can also be cancelled by calling the `$animate.cancel(promise)` method with the provided
839
+ * promise that was returned when the animation was started.
840
+ *
841
+ * ```js
842
+ * var promise = $animate.addClass(element, 'super-long-animation').then(function() {
843
+ * //this will still be called even if cancelled
844
+ * });
845
+ *
846
+ * element.on('click', function() {
847
+ * //tooo lazy to wait for the animation to end
848
+ * $animate.cancel(promise);
849
+ * });
850
+ * ```
851
+ *
852
+ * (Keep in mind that the promise cancellation is unique to `$animate` since promises in
853
+ * general cannot be cancelled.)
854
+ *
855
+ */
856
+ return {
857
+ /**
858
+ * @ngdoc method
859
+ * @name $animate#animate
860
+ * @kind function
861
+ *
862
+ * @description
863
+ * Performs an inline animation on the element which applies the provided `to` and `from` CSS styles to the element.
864
+ * If any detected CSS transition, keyframe or JavaScript matches the provided `className` value then the animation
865
+ * will take on the provided styles. For example, if a transition animation is set for the given className then the
866
+ * provided `from` and `to` styles will be applied alongside the given transition. If a JavaScript animation is
867
+ * detected then the provided styles will be given in as function paramters.
868
+ *
869
+ * ```js
870
+ * ngModule.animation('.my-inline-animation', function() {
871
+ * return {
872
+ * animate : function(element, className, from, to, done) {
873
+ * //styles
874
+ * }
875
+ * }
876
+ * });
877
+ * ```
878
+ *
879
+ * Below is a breakdown of each step that occurs during the `animate` animation:
880
+ *
881
+ * | Animation Step | What the element class attribute looks like |
882
+ * |-----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|
883
+ * | 1. `$animate.animate(...)` is called | `class="my-animation"` |
884
+ * | 2. `$animate` waits for the next digest to start the animation | `class="my-animation ng-animate"` |
885
+ * | 3. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation ng-animate"` |
886
+ * | 4. the `className` class value is added to the element | `class="my-animation ng-animate className"` |
887
+ * | 5. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate className"` |
888
+ * | 6. `$animate` blocks all CSS transitions on the element to ensure the `.className` class styling is applied right away| `class="my-animation ng-animate className"` |
889
+ * | 7. `$animate` applies the provided collection of `from` CSS styles to the element | `class="my-animation ng-animate className"` |
890
+ * | 8. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation ng-animate className"` |
891
+ * | 9. `$animate` removes the CSS transition block placed on the element | `class="my-animation ng-animate className"` |
892
+ * | 10. the `className-active` class is added (this triggers the CSS transition/animation) | `class="my-animation ng-animate className className-active"` |
893
+ * | 11. `$animate` applies the collection of `to` CSS styles to the element which are then handled by the transition | `class="my-animation ng-animate className className-active"` |
894
+ * | 12. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate className className-active"` |
895
+ * | 13. The animation ends and all generated CSS classes are removed from the element | `class="my-animation"` |
896
+ * | 14. The returned promise is resolved. | `class="my-animation"` |
897
+ *
898
+ * @param {DOMElement} element the element that will be the focus of the enter animation
899
+ * @param {object} from a collection of CSS styles that will be applied to the element at the start of the animation
900
+ * @param {object} to a collection of CSS styles that the element will animate towards
901
+ * @param {string=} className an optional CSS class that will be added to the element for the duration of the animation (the default class is `ng-inline-animate`)
902
+ * @param {object=} options an optional collection of options that will be picked up by the CSS transition/animation
903
+ * @return {Promise} the animation callback promise
904
+ */
905
+ animate: function(element, from, to, className, options) {
906
+ className = className || 'ng-inline-animate';
907
+ options = parseAnimateOptions(options) || {};
908
+ options.from = to ? from : null;
909
+ options.to = to ? to : from;
910
+
911
+ return runAnimationPostDigest(function(done) {
912
+ return performAnimation('animate', className, stripCommentsFromElement(element), null, null, noop, options, done);
913
+ });
914
+ },
915
+
916
+ /**
917
+ * @ngdoc method
918
+ * @name $animate#enter
919
+ * @kind function
920
+ *
921
+ * @description
922
+ * Appends the element to the parentElement element that resides in the document and then runs the enter animation. Once
923
+ * the animation is started, the following CSS classes will be present on the element for the duration of the animation:
924
+ *
925
+ * Below is a breakdown of each step that occurs during enter animation:
926
+ *
927
+ * | Animation Step | What the element class attribute looks like |
928
+ * |-----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|
929
+ * | 1. `$animate.enter(...)` is called | `class="my-animation"` |
930
+ * | 2. element is inserted into the `parentElement` element or beside the `afterElement` element | `class="my-animation"` |
931
+ * | 3. `$animate` waits for the next digest to start the animation | `class="my-animation ng-animate"` |
932
+ * | 4. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation ng-animate"` |
933
+ * | 5. the `.ng-enter` class is added to the element | `class="my-animation ng-animate ng-enter"` |
934
+ * | 6. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate ng-enter"` |
935
+ * | 7. `$animate` blocks all CSS transitions on the element to ensure the `.ng-enter` class styling is applied right away | `class="my-animation ng-animate ng-enter"` |
936
+ * | 8. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation ng-animate ng-enter"` |
937
+ * | 9. `$animate` removes the CSS transition block placed on the element | `class="my-animation ng-animate ng-enter"` |
938
+ * | 10. the `.ng-enter-active` class is added (this triggers the CSS transition/animation) | `class="my-animation ng-animate ng-enter ng-enter-active"` |
939
+ * | 11. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate ng-enter ng-enter-active"` |
940
+ * | 12. The animation ends and all generated CSS classes are removed from the element | `class="my-animation"` |
941
+ * | 13. The returned promise is resolved. | `class="my-animation"` |
942
+ *
943
+ * @param {DOMElement} element the element that will be the focus of the enter animation
944
+ * @param {DOMElement} parentElement the parent element of the element that will be the focus of the enter animation
945
+ * @param {DOMElement} afterElement the sibling element (which is the previous element) of the element that will be the focus of the enter animation
946
+ * @param {object=} options an optional collection of options that will be picked up by the CSS transition/animation
947
+ * @return {Promise} the animation callback promise
948
+ */
949
+ enter: function(element, parentElement, afterElement, options) {
950
+ options = parseAnimateOptions(options);
951
+ element = angular.element(element);
952
+ parentElement = prepareElement(parentElement);
953
+ afterElement = prepareElement(afterElement);
954
+
955
+ classBasedAnimationsBlocked(element, true);
956
+ $delegate.enter(element, parentElement, afterElement);
957
+ return runAnimationPostDigest(function(done) {
958
+ return performAnimation('enter', 'ng-enter', stripCommentsFromElement(element), parentElement, afterElement, noop, options, done);
959
+ });
960
+ },
961
+
962
+ /**
963
+ * @ngdoc method
964
+ * @name $animate#leave
965
+ * @kind function
966
+ *
967
+ * @description
968
+ * Runs the leave animation operation and, upon completion, removes the element from the DOM. Once
969
+ * the animation is started, the following CSS classes will be added for the duration of the animation:
970
+ *
971
+ * Below is a breakdown of each step that occurs during leave animation:
972
+ *
973
+ * | Animation Step | What the element class attribute looks like |
974
+ * |-----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|
975
+ * | 1. `$animate.leave(...)` is called | `class="my-animation"` |
976
+ * | 2. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation ng-animate"` |
977
+ * | 3. `$animate` waits for the next digest to start the animation | `class="my-animation ng-animate"` |
978
+ * | 4. the `.ng-leave` class is added to the element | `class="my-animation ng-animate ng-leave"` |
979
+ * | 5. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate ng-leave"` |
980
+ * | 6. `$animate` blocks all CSS transitions on the element to ensure the `.ng-leave` class styling is applied right away | `class="my-animation ng-animate ng-leave"` |
981
+ * | 7. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation ng-animate ng-leave"` |
982
+ * | 8. `$animate` removes the CSS transition block placed on the element | `class="my-animation ng-animate ng-leave"` |
983
+ * | 9. the `.ng-leave-active` class is added (this triggers the CSS transition/animation) | `class="my-animation ng-animate ng-leave ng-leave-active"` |
984
+ * | 10. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate ng-leave ng-leave-active"` |
985
+ * | 11. The animation ends and all generated CSS classes are removed from the element | `class="my-animation"` |
986
+ * | 12. The element is removed from the DOM | ... |
987
+ * | 13. The returned promise is resolved. | ... |
988
+ *
989
+ * @param {DOMElement} element the element that will be the focus of the leave animation
990
+ * @param {object=} options an optional collection of styles that will be picked up by the CSS transition/animation
991
+ * @return {Promise} the animation callback promise
992
+ */
993
+ leave: function(element, options) {
994
+ options = parseAnimateOptions(options);
995
+ element = angular.element(element);
996
+
997
+ cancelChildAnimations(element);
998
+ classBasedAnimationsBlocked(element, true);
999
+ return runAnimationPostDigest(function(done) {
1000
+ return performAnimation('leave', 'ng-leave', stripCommentsFromElement(element), null, null, function() {
1001
+ $delegate.leave(element);
1002
+ }, options, done);
1003
+ });
1004
+ },
1005
+
1006
+ /**
1007
+ * @ngdoc method
1008
+ * @name $animate#move
1009
+ * @kind function
1010
+ *
1011
+ * @description
1012
+ * Fires the move DOM operation. Just before the animation starts, the animate service will either append it into the parentElement container or
1013
+ * add the element directly after the afterElement element if present. Then the move animation will be run. Once
1014
+ * the animation is started, the following CSS classes will be added for the duration of the animation:
1015
+ *
1016
+ * Below is a breakdown of each step that occurs during move animation:
1017
+ *
1018
+ * | Animation Step | What the element class attribute looks like |
1019
+ * |----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
1020
+ * | 1. `$animate.move(...)` is called | `class="my-animation"` |
1021
+ * | 2. element is moved into the parentElement element or beside the afterElement element | `class="my-animation"` |
1022
+ * | 3. `$animate` waits for the next digest to start the animation | `class="my-animation ng-animate"` |
1023
+ * | 4. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation ng-animate"` |
1024
+ * | 5. the `.ng-move` class is added to the element | `class="my-animation ng-animate ng-move"` |
1025
+ * | 6. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate ng-move"` |
1026
+ * | 7. `$animate` blocks all CSS transitions on the element to ensure the `.ng-move` class styling is applied right away | `class="my-animation ng-animate ng-move"` |
1027
+ * | 8. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation ng-animate ng-move"` |
1028
+ * | 9. `$animate` removes the CSS transition block placed on the element | `class="my-animation ng-animate ng-move"` |
1029
+ * | 10. the `.ng-move-active` class is added (this triggers the CSS transition/animation) | `class="my-animation ng-animate ng-move ng-move-active"` |
1030
+ * | 11. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate ng-move ng-move-active"` |
1031
+ * | 12. The animation ends and all generated CSS classes are removed from the element | `class="my-animation"` |
1032
+ * | 13. The returned promise is resolved. | `class="my-animation"` |
1033
+ *
1034
+ * @param {DOMElement} element the element that will be the focus of the move animation
1035
+ * @param {DOMElement} parentElement the parentElement element of the element that will be the focus of the move animation
1036
+ * @param {DOMElement} afterElement the sibling element (which is the previous element) of the element that will be the focus of the move animation
1037
+ * @param {object=} options an optional collection of styles that will be picked up by the CSS transition/animation
1038
+ * @return {Promise} the animation callback promise
1039
+ */
1040
+ move: function(element, parentElement, afterElement, options) {
1041
+ options = parseAnimateOptions(options);
1042
+ element = angular.element(element);
1043
+ parentElement = prepareElement(parentElement);
1044
+ afterElement = prepareElement(afterElement);
1045
+
1046
+ cancelChildAnimations(element);
1047
+ classBasedAnimationsBlocked(element, true);
1048
+ $delegate.move(element, parentElement, afterElement);
1049
+ return runAnimationPostDigest(function(done) {
1050
+ return performAnimation('move', 'ng-move', stripCommentsFromElement(element), parentElement, afterElement, noop, options, done);
1051
+ });
1052
+ },
1053
+
1054
+ /**
1055
+ * @ngdoc method
1056
+ * @name $animate#addClass
1057
+ *
1058
+ * @description
1059
+ * Triggers a custom animation event based off the className variable and then attaches the className value to the element as a CSS class.
1060
+ * Unlike the other animation methods, the animate service will suffix the className value with {@type -add} in order to provide
1061
+ * the animate service the setup and active CSS classes in order to trigger the animation (this will be skipped if no CSS transitions
1062
+ * or keyframes are defined on the -add-active or base CSS class).
1063
+ *
1064
+ * Below is a breakdown of each step that occurs during addClass animation:
1065
+ *
1066
+ * | Animation Step | What the element class attribute looks like |
1067
+ * |--------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
1068
+ * | 1. `$animate.addClass(element, 'super')` is called | `class="my-animation"` |
1069
+ * | 2. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation ng-animate"` |
1070
+ * | 3. the `.super-add` class is added to the element | `class="my-animation ng-animate super-add"` |
1071
+ * | 4. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation ng-animate super-add"` |
1072
+ * | 5. the `.super` and `.super-add-active` classes are added (this triggers the CSS transition/animation) | `class="my-animation ng-animate super super-add super-add-active"` |
1073
+ * | 6. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate super super-add super-add-active"` |
1074
+ * | 7. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate super super-add super-add-active"` |
1075
+ * | 8. The animation ends and all generated CSS classes are removed from the element | `class="my-animation super"` |
1076
+ * | 9. The super class is kept on the element | `class="my-animation super"` |
1077
+ * | 10. The returned promise is resolved. | `class="my-animation super"` |
1078
+ *
1079
+ * @param {DOMElement} element the element that will be animated
1080
+ * @param {string} className the CSS class that will be added to the element and then animated
1081
+ * @param {object=} options an optional collection of styles that will be picked up by the CSS transition/animation
1082
+ * @return {Promise} the animation callback promise
1083
+ */
1084
+ addClass: function(element, className, options) {
1085
+ return this.setClass(element, className, [], options);
1086
+ },
1087
+
1088
+ /**
1089
+ * @ngdoc method
1090
+ * @name $animate#removeClass
1091
+ *
1092
+ * @description
1093
+ * Triggers a custom animation event based off the className variable and then removes the CSS class provided by the className value
1094
+ * from the element. Unlike the other animation methods, the animate service will suffix the className value with {@type -remove} in
1095
+ * order to provide the animate service the setup and active CSS classes in order to trigger the animation (this will be skipped if
1096
+ * no CSS transitions or keyframes are defined on the -remove or base CSS classes).
1097
+ *
1098
+ * Below is a breakdown of each step that occurs during removeClass animation:
1099
+ *
1100
+ * | Animation Step | What the element class attribute looks like |
1101
+ * |----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
1102
+ * | 1. `$animate.removeClass(element, 'super')` is called | `class="my-animation super"` |
1103
+ * | 2. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation super ng-animate"` |
1104
+ * | 3. the `.super-remove` class is added to the element | `class="my-animation super ng-animate super-remove"` |
1105
+ * | 4. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation super ng-animate super-remove"` |
1106
+ * | 5. the `.super-remove-active` classes are added and `.super` is removed (this triggers the CSS transition/animation) | `class="my-animation ng-animate super-remove super-remove-active"` |
1107
+ * | 6. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate super-remove super-remove-active"` |
1108
+ * | 7. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate super-remove super-remove-active"` |
1109
+ * | 8. The animation ends and all generated CSS classes are removed from the element | `class="my-animation"` |
1110
+ * | 9. The returned promise is resolved. | `class="my-animation"` |
1111
+ *
1112
+ *
1113
+ * @param {DOMElement} element the element that will be animated
1114
+ * @param {string} className the CSS class that will be animated and then removed from the element
1115
+ * @param {object=} options an optional collection of styles that will be picked up by the CSS transition/animation
1116
+ * @return {Promise} the animation callback promise
1117
+ */
1118
+ removeClass: function(element, className, options) {
1119
+ return this.setClass(element, [], className, options);
1120
+ },
1121
+
1122
+ /**
1123
+ *
1124
+ * @ngdoc method
1125
+ * @name $animate#setClass
1126
+ *
1127
+ * @description Adds and/or removes the given CSS classes to and from the element.
1128
+ * Once complete, the `done()` callback will be fired (if provided).
1129
+ *
1130
+ * | Animation Step | What the element class attribute looks like |
1131
+ * |----------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|
1132
+ * | 1. `$animate.setClass(element, 'on', 'off')` is called | `class="my-animation off"` |
1133
+ * | 2. `$animate` runs the JavaScript-defined animations detected on the element | `class="my-animation ng-animate off"` |
1134
+ * | 3. the `.on-add` and `.off-remove` classes are added to the element | `class="my-animation ng-animate on-add off-remove off"` |
1135
+ * | 4. `$animate` waits for a single animation frame (this performs a reflow) | `class="my-animation ng-animate on-add off-remove off"` |
1136
+ * | 5. the `.on`, `.on-add-active` and `.off-remove-active` classes are added and `.off` is removed (this triggers the CSS transition/animation) | `class="my-animation ng-animate on on-add on-add-active off-remove off-remove-active"` |
1137
+ * | 6. `$animate` scans the element styles to get the CSS transition/animation duration and delay | `class="my-animation ng-animate on on-add on-add-active off-remove off-remove-active"` |
1138
+ * | 7. `$animate` waits for the animation to complete (via events and timeout) | `class="my-animation ng-animate on on-add on-add-active off-remove off-remove-active"` |
1139
+ * | 8. The animation ends and all generated CSS classes are removed from the element | `class="my-animation on"` |
1140
+ * | 9. The returned promise is resolved. | `class="my-animation on"` |
1141
+ *
1142
+ * @param {DOMElement} element the element which will have its CSS classes changed
1143
+ * removed from it
1144
+ * @param {string} add the CSS classes which will be added to the element
1145
+ * @param {string} remove the CSS class which will be removed from the element
1146
+ * CSS classes have been set on the element
1147
+ * @param {object=} options an optional collection of styles that will be picked up by the CSS transition/animation
1148
+ * @return {Promise} the animation callback promise
1149
+ */
1150
+ setClass: function(element, add, remove, options) {
1151
+ options = parseAnimateOptions(options);
1152
+
1153
+ var STORAGE_KEY = '$$animateClasses';
1154
+ element = angular.element(element);
1155
+ element = stripCommentsFromElement(element);
1156
+
1157
+ if (classBasedAnimationsBlocked(element)) {
1158
+ return $delegate.$$setClassImmediately(element, add, remove, options);
1159
+ }
1160
+
1161
+ // we're using a combined array for both the add and remove
1162
+ // operations since the ORDER OF addClass and removeClass matters
1163
+ var classes, cache = element.data(STORAGE_KEY);
1164
+ var hasCache = !!cache;
1165
+ if (!cache) {
1166
+ cache = {};
1167
+ cache.classes = {};
1168
+ }
1169
+ classes = cache.classes;
1170
+
1171
+ add = isArray(add) ? add : add.split(' ');
1172
+ forEach(add, function(c) {
1173
+ if (c && c.length) {
1174
+ classes[c] = true;
1175
+ }
1176
+ });
1177
+
1178
+ remove = isArray(remove) ? remove : remove.split(' ');
1179
+ forEach(remove, function(c) {
1180
+ if (c && c.length) {
1181
+ classes[c] = false;
1182
+ }
1183
+ });
1184
+
1185
+ if (hasCache) {
1186
+ if (options && cache.options) {
1187
+ cache.options = angular.extend(cache.options || {}, options);
1188
+ }
1189
+
1190
+ //the digest cycle will combine all the animations into one function
1191
+ return cache.promise;
1192
+ } else {
1193
+ element.data(STORAGE_KEY, cache = {
1194
+ classes: classes,
1195
+ options: options
1196
+ });
1197
+ }
1198
+
1199
+ return cache.promise = runAnimationPostDigest(function(done) {
1200
+ var parentElement = element.parent();
1201
+ var elementNode = extractElementNode(element);
1202
+ var parentNode = elementNode.parentNode;
1203
+ // TODO(matsko): move this code into the animationsDisabled() function once #8092 is fixed
1204
+ if (!parentNode || parentNode['$$NG_REMOVED'] || elementNode['$$NG_REMOVED']) {
1205
+ done();
1206
+ return;
1207
+ }
1208
+
1209
+ var cache = element.data(STORAGE_KEY);
1210
+ element.removeData(STORAGE_KEY);
1211
+
1212
+ var state = element.data(NG_ANIMATE_STATE) || {};
1213
+ var classes = resolveElementClasses(element, cache, state.active);
1214
+ return !classes
1215
+ ? done()
1216
+ : performAnimation('setClass', classes, element, parentElement, null, function() {
1217
+ if (classes[0]) $delegate.$$addClassImmediately(element, classes[0]);
1218
+ if (classes[1]) $delegate.$$removeClassImmediately(element, classes[1]);
1219
+ }, cache.options, done);
1220
+ });
1221
+ },
1222
+
1223
+ /**
1224
+ * @ngdoc method
1225
+ * @name $animate#cancel
1226
+ * @kind function
1227
+ *
1228
+ * @param {Promise} animationPromise The animation promise that is returned when an animation is started.
1229
+ *
1230
+ * @description
1231
+ * Cancels the provided animation.
1232
+ */
1233
+ cancel: function(promise) {
1234
+ promise.$$cancelFn();
1235
+ },
1236
+
1237
+ /**
1238
+ * @ngdoc method
1239
+ * @name $animate#enabled
1240
+ * @kind function
1241
+ *
1242
+ * @param {boolean=} value If provided then set the animation on or off.
1243
+ * @param {DOMElement=} element If provided then the element will be used to represent the enable/disable operation
1244
+ * @return {boolean} Current animation state.
1245
+ *
1246
+ * @description
1247
+ * Globally enables/disables animations.
1248
+ *
1249
+ */
1250
+ enabled: function(value, element) {
1251
+ switch (arguments.length) {
1252
+ case 2:
1253
+ if (value) {
1254
+ cleanup(element);
1255
+ } else {
1256
+ var data = element.data(NG_ANIMATE_STATE) || {};
1257
+ data.disabled = true;
1258
+ element.data(NG_ANIMATE_STATE, data);
1259
+ }
1260
+ break;
1261
+
1262
+ case 1:
1263
+ rootAnimateState.disabled = !value;
1264
+ break;
1265
+
1266
+ default:
1267
+ value = !rootAnimateState.disabled;
1268
+ break;
1269
+ }
1270
+ return !!value;
1271
+ }
1272
+ };
1273
+
1274
+ /*
1275
+ all animations call this shared animation triggering function internally.
1276
+ The animationEvent variable refers to the JavaScript animation event that will be triggered
1277
+ and the className value is the name of the animation that will be applied within the
1278
+ CSS code. Element, `parentElement` and `afterElement` are provided DOM elements for the animation
1279
+ and the onComplete callback will be fired once the animation is fully complete.
1280
+ */
1281
+ function performAnimation(animationEvent, className, element, parentElement, afterElement, domOperation, options, doneCallback) {
1282
+ var noopCancel = noop;
1283
+ var runner = animationRunner(element, animationEvent, className, options);
1284
+ if (!runner) {
1285
+ fireDOMOperation();
1286
+ fireBeforeCallbackAsync();
1287
+ fireAfterCallbackAsync();
1288
+ closeAnimation();
1289
+ return noopCancel;
1290
+ }
1291
+
1292
+ animationEvent = runner.event;
1293
+ className = runner.className;
1294
+ var elementEvents = angular.element._data(runner.node);
1295
+ elementEvents = elementEvents && elementEvents.events;
1296
+
1297
+ if (!parentElement) {
1298
+ parentElement = afterElement ? afterElement.parent() : element.parent();
1299
+ }
1300
+
1301
+ //skip the animation if animations are disabled, a parent is already being animated,
1302
+ //the element is not currently attached to the document body or then completely close
1303
+ //the animation if any matching animations are not found at all.
1304
+ //NOTE: IE8 + IE9 should close properly (run closeAnimation()) in case an animation was found.
1305
+ if (animationsDisabled(element, parentElement)) {
1306
+ fireDOMOperation();
1307
+ fireBeforeCallbackAsync();
1308
+ fireAfterCallbackAsync();
1309
+ closeAnimation();
1310
+ return noopCancel;
1311
+ }
1312
+
1313
+ var ngAnimateState = element.data(NG_ANIMATE_STATE) || {};
1314
+ var runningAnimations = ngAnimateState.active || {};
1315
+ var totalActiveAnimations = ngAnimateState.totalActive || 0;
1316
+ var lastAnimation = ngAnimateState.last;
1317
+ var skipAnimation = false;
1318
+
1319
+ if (totalActiveAnimations > 0) {
1320
+ var animationsToCancel = [];
1321
+ if (!runner.isClassBased) {
1322
+ if (animationEvent == 'leave' && runningAnimations['ng-leave']) {
1323
+ skipAnimation = true;
1324
+ } else {
1325
+ //cancel all animations when a structural animation takes place
1326
+ for (var klass in runningAnimations) {
1327
+ animationsToCancel.push(runningAnimations[klass]);
1328
+ }
1329
+ ngAnimateState = {};
1330
+ cleanup(element, true);
1331
+ }
1332
+ } else if (lastAnimation.event == 'setClass') {
1333
+ animationsToCancel.push(lastAnimation);
1334
+ cleanup(element, className);
1335
+ }
1336
+ else if (runningAnimations[className]) {
1337
+ var current = runningAnimations[className];
1338
+ if (current.event == animationEvent) {
1339
+ skipAnimation = true;
1340
+ } else {
1341
+ animationsToCancel.push(current);
1342
+ cleanup(element, className);
1343
+ }
1344
+ }
1345
+
1346
+ if (animationsToCancel.length > 0) {
1347
+ forEach(animationsToCancel, function(operation) {
1348
+ operation.cancel();
1349
+ });
1350
+ }
1351
+ }
1352
+
1353
+ if (runner.isClassBased
1354
+ && !runner.isSetClassOperation
1355
+ && animationEvent != 'animate'
1356
+ && !skipAnimation) {
1357
+ skipAnimation = (animationEvent == 'addClass') == element.hasClass(className); //opposite of XOR
1358
+ }
1359
+
1360
+ if (skipAnimation) {
1361
+ fireDOMOperation();
1362
+ fireBeforeCallbackAsync();
1363
+ fireAfterCallbackAsync();
1364
+ fireDoneCallbackAsync();
1365
+ return noopCancel;
1366
+ }
1367
+
1368
+ runningAnimations = ngAnimateState.active || {};
1369
+ totalActiveAnimations = ngAnimateState.totalActive || 0;
1370
+
1371
+ if (animationEvent == 'leave') {
1372
+ //there's no need to ever remove the listener since the element
1373
+ //will be removed (destroyed) after the leave animation ends or
1374
+ //is cancelled midway
1375
+ element.one('$destroy', function(e) {
1376
+ var element = angular.element(this);
1377
+ var state = element.data(NG_ANIMATE_STATE);
1378
+ if (state) {
1379
+ var activeLeaveAnimation = state.active['ng-leave'];
1380
+ if (activeLeaveAnimation) {
1381
+ activeLeaveAnimation.cancel();
1382
+ cleanup(element, 'ng-leave');
1383
+ }
1384
+ }
1385
+ });
1386
+ }
1387
+
1388
+ //the ng-animate class does nothing, but it's here to allow for
1389
+ //parent animations to find and cancel child animations when needed
1390
+ $$jqLite.addClass(element, NG_ANIMATE_CLASS_NAME);
1391
+ if (options && options.tempClasses) {
1392
+ forEach(options.tempClasses, function(className) {
1393
+ $$jqLite.addClass(element, className);
1394
+ });
1395
+ }
1396
+
1397
+ var localAnimationCount = globalAnimationCounter++;
1398
+ totalActiveAnimations++;
1399
+ runningAnimations[className] = runner;
1400
+
1401
+ element.data(NG_ANIMATE_STATE, {
1402
+ last: runner,
1403
+ active: runningAnimations,
1404
+ index: localAnimationCount,
1405
+ totalActive: totalActiveAnimations
1406
+ });
1407
+
1408
+ //first we run the before animations and when all of those are complete
1409
+ //then we perform the DOM operation and run the next set of animations
1410
+ fireBeforeCallbackAsync();
1411
+ runner.before(function(cancelled) {
1412
+ var data = element.data(NG_ANIMATE_STATE);
1413
+ cancelled = cancelled ||
1414
+ !data || !data.active[className] ||
1415
+ (runner.isClassBased && data.active[className].event != animationEvent);
1416
+
1417
+ fireDOMOperation();
1418
+ if (cancelled === true) {
1419
+ closeAnimation();
1420
+ } else {
1421
+ fireAfterCallbackAsync();
1422
+ runner.after(closeAnimation);
1423
+ }
1424
+ });
1425
+
1426
+ return runner.cancel;
1427
+
1428
+ function fireDOMCallback(animationPhase) {
1429
+ var eventName = '$animate:' + animationPhase;
1430
+ if (elementEvents && elementEvents[eventName] && elementEvents[eventName].length > 0) {
1431
+ $$asyncCallback(function() {
1432
+ element.triggerHandler(eventName, {
1433
+ event: animationEvent,
1434
+ className: className
1435
+ });
1436
+ });
1437
+ }
1438
+ }
1439
+
1440
+ function fireBeforeCallbackAsync() {
1441
+ fireDOMCallback('before');
1442
+ }
1443
+
1444
+ function fireAfterCallbackAsync() {
1445
+ fireDOMCallback('after');
1446
+ }
1447
+
1448
+ function fireDoneCallbackAsync() {
1449
+ fireDOMCallback('close');
1450
+ doneCallback();
1451
+ }
1452
+
1453
+ //it is less complicated to use a flag than managing and canceling
1454
+ //timeouts containing multiple callbacks.
1455
+ function fireDOMOperation() {
1456
+ if (!fireDOMOperation.hasBeenRun) {
1457
+ fireDOMOperation.hasBeenRun = true;
1458
+ domOperation();
1459
+ }
1460
+ }
1461
+
1462
+ function closeAnimation() {
1463
+ if (!closeAnimation.hasBeenRun) {
1464
+ if (runner) { //the runner doesn't exist if it fails to instantiate
1465
+ runner.applyStyles();
1466
+ }
1467
+
1468
+ closeAnimation.hasBeenRun = true;
1469
+ if (options && options.tempClasses) {
1470
+ forEach(options.tempClasses, function(className) {
1471
+ $$jqLite.removeClass(element, className);
1472
+ });
1473
+ }
1474
+
1475
+ var data = element.data(NG_ANIMATE_STATE);
1476
+ if (data) {
1477
+
1478
+ /* only structural animations wait for reflow before removing an
1479
+ animation, but class-based animations don't. An example of this
1480
+ failing would be when a parent HTML tag has a ng-class attribute
1481
+ causing ALL directives below to skip animations during the digest */
1482
+ if (runner && runner.isClassBased) {
1483
+ cleanup(element, className);
1484
+ } else {
1485
+ $$asyncCallback(function() {
1486
+ var data = element.data(NG_ANIMATE_STATE) || {};
1487
+ if (localAnimationCount == data.index) {
1488
+ cleanup(element, className, animationEvent);
1489
+ }
1490
+ });
1491
+ element.data(NG_ANIMATE_STATE, data);
1492
+ }
1493
+ }
1494
+ fireDoneCallbackAsync();
1495
+ }
1496
+ }
1497
+ }
1498
+
1499
+ function cancelChildAnimations(element) {
1500
+ var node = extractElementNode(element);
1501
+ if (node) {
1502
+ var nodes = angular.isFunction(node.getElementsByClassName) ?
1503
+ node.getElementsByClassName(NG_ANIMATE_CLASS_NAME) :
1504
+ node.querySelectorAll('.' + NG_ANIMATE_CLASS_NAME);
1505
+ forEach(nodes, function(element) {
1506
+ element = angular.element(element);
1507
+ var data = element.data(NG_ANIMATE_STATE);
1508
+ if (data && data.active) {
1509
+ forEach(data.active, function(runner) {
1510
+ runner.cancel();
1511
+ });
1512
+ }
1513
+ });
1514
+ }
1515
+ }
1516
+
1517
+ function cleanup(element, className) {
1518
+ if (isMatchingElement(element, $rootElement)) {
1519
+ if (!rootAnimateState.disabled) {
1520
+ rootAnimateState.running = false;
1521
+ rootAnimateState.structural = false;
1522
+ }
1523
+ } else if (className) {
1524
+ var data = element.data(NG_ANIMATE_STATE) || {};
1525
+
1526
+ var removeAnimations = className === true;
1527
+ if (!removeAnimations && data.active && data.active[className]) {
1528
+ data.totalActive--;
1529
+ delete data.active[className];
1530
+ }
1531
+
1532
+ if (removeAnimations || !data.totalActive) {
1533
+ $$jqLite.removeClass(element, NG_ANIMATE_CLASS_NAME);
1534
+ element.removeData(NG_ANIMATE_STATE);
1535
+ }
1536
+ }
1537
+ }
1538
+
1539
+ function animationsDisabled(element, parentElement) {
1540
+ if (rootAnimateState.disabled) {
1541
+ return true;
1542
+ }
1543
+
1544
+ if (isMatchingElement(element, $rootElement)) {
1545
+ return rootAnimateState.running;
1546
+ }
1547
+
1548
+ var allowChildAnimations, parentRunningAnimation, hasParent;
1549
+ do {
1550
+ //the element did not reach the root element which means that it
1551
+ //is not apart of the DOM. Therefore there is no reason to do
1552
+ //any animations on it
1553
+ if (parentElement.length === 0) break;
1554
+
1555
+ var isRoot = isMatchingElement(parentElement, $rootElement);
1556
+ var state = isRoot ? rootAnimateState : (parentElement.data(NG_ANIMATE_STATE) || {});
1557
+ if (state.disabled) {
1558
+ return true;
1559
+ }
1560
+
1561
+ //no matter what, for an animation to work it must reach the root element
1562
+ //this implies that the element is attached to the DOM when the animation is run
1563
+ if (isRoot) {
1564
+ hasParent = true;
1565
+ }
1566
+
1567
+ //once a flag is found that is strictly false then everything before
1568
+ //it will be discarded and all child animations will be restricted
1569
+ if (allowChildAnimations !== false) {
1570
+ var animateChildrenFlag = parentElement.data(NG_ANIMATE_CHILDREN);
1571
+ if (angular.isDefined(animateChildrenFlag)) {
1572
+ allowChildAnimations = animateChildrenFlag;
1573
+ }
1574
+ }
1575
+
1576
+ parentRunningAnimation = parentRunningAnimation ||
1577
+ state.running ||
1578
+ (state.last && !state.last.isClassBased);
1579
+ }
1580
+ while (parentElement = parentElement.parent());
1581
+
1582
+ return !hasParent || (!allowChildAnimations && parentRunningAnimation);
1583
+ }
1584
+ }]);
1585
+
1586
+ $animateProvider.register('', ['$window', '$sniffer', '$timeout', '$$animateReflow',
1587
+ function($window, $sniffer, $timeout, $$animateReflow) {
1588
+ // Detect proper transitionend/animationend event names.
1589
+ var CSS_PREFIX = '', TRANSITION_PROP, TRANSITIONEND_EVENT, ANIMATION_PROP, ANIMATIONEND_EVENT;
1590
+
1591
+ // If unprefixed events are not supported but webkit-prefixed are, use the latter.
1592
+ // Otherwise, just use W3C names, browsers not supporting them at all will just ignore them.
1593
+ // Note: Chrome implements `window.onwebkitanimationend` and doesn't implement `window.onanimationend`
1594
+ // but at the same time dispatches the `animationend` event and not `webkitAnimationEnd`.
1595
+ // Register both events in case `window.onanimationend` is not supported because of that,
1596
+ // do the same for `transitionend` as Safari is likely to exhibit similar behavior.
1597
+ // Also, the only modern browser that uses vendor prefixes for transitions/keyframes is webkit
1598
+ // therefore there is no reason to test anymore for other vendor prefixes: http://caniuse.com/#search=transition
1599
+ if (window.ontransitionend === undefined && window.onwebkittransitionend !== undefined) {
1600
+ CSS_PREFIX = '-webkit-';
1601
+ TRANSITION_PROP = 'WebkitTransition';
1602
+ TRANSITIONEND_EVENT = 'webkitTransitionEnd transitionend';
1603
+ } else {
1604
+ TRANSITION_PROP = 'transition';
1605
+ TRANSITIONEND_EVENT = 'transitionend';
1606
+ }
1607
+
1608
+ if (window.onanimationend === undefined && window.onwebkitanimationend !== undefined) {
1609
+ CSS_PREFIX = '-webkit-';
1610
+ ANIMATION_PROP = 'WebkitAnimation';
1611
+ ANIMATIONEND_EVENT = 'webkitAnimationEnd animationend';
1612
+ } else {
1613
+ ANIMATION_PROP = 'animation';
1614
+ ANIMATIONEND_EVENT = 'animationend';
1615
+ }
1616
+
1617
+ var DURATION_KEY = 'Duration';
1618
+ var PROPERTY_KEY = 'Property';
1619
+ var DELAY_KEY = 'Delay';
1620
+ var ANIMATION_ITERATION_COUNT_KEY = 'IterationCount';
1621
+ var ANIMATION_PLAYSTATE_KEY = 'PlayState';
1622
+ var NG_ANIMATE_PARENT_KEY = '$$ngAnimateKey';
1623
+ var NG_ANIMATE_CSS_DATA_KEY = '$$ngAnimateCSS3Data';
1624
+ var ELAPSED_TIME_MAX_DECIMAL_PLACES = 3;
1625
+ var CLOSING_TIME_BUFFER = 1.5;
1626
+ var ONE_SECOND = 1000;
1627
+
1628
+ var lookupCache = {};
1629
+ var parentCounter = 0;
1630
+ var animationReflowQueue = [];
1631
+ var cancelAnimationReflow;
1632
+ function clearCacheAfterReflow() {
1633
+ if (!cancelAnimationReflow) {
1634
+ cancelAnimationReflow = $$animateReflow(function() {
1635
+ animationReflowQueue = [];
1636
+ cancelAnimationReflow = null;
1637
+ lookupCache = {};
1638
+ });
1639
+ }
1640
+ }
1641
+
1642
+ function afterReflow(element, callback) {
1643
+ if (cancelAnimationReflow) {
1644
+ cancelAnimationReflow();
1645
+ }
1646
+ animationReflowQueue.push(callback);
1647
+ cancelAnimationReflow = $$animateReflow(function() {
1648
+ forEach(animationReflowQueue, function(fn) {
1649
+ fn();
1650
+ });
1651
+
1652
+ animationReflowQueue = [];
1653
+ cancelAnimationReflow = null;
1654
+ lookupCache = {};
1655
+ });
1656
+ }
1657
+
1658
+ var closingTimer = null;
1659
+ var closingTimestamp = 0;
1660
+ var animationElementQueue = [];
1661
+ function animationCloseHandler(element, totalTime) {
1662
+ var node = extractElementNode(element);
1663
+ element = angular.element(node);
1664
+
1665
+ //this item will be garbage collected by the closing
1666
+ //animation timeout
1667
+ animationElementQueue.push(element);
1668
+
1669
+ //but it may not need to cancel out the existing timeout
1670
+ //if the timestamp is less than the previous one
1671
+ var futureTimestamp = Date.now() + totalTime;
1672
+ if (futureTimestamp <= closingTimestamp) {
1673
+ return;
1674
+ }
1675
+
1676
+ $timeout.cancel(closingTimer);
1677
+
1678
+ closingTimestamp = futureTimestamp;
1679
+ closingTimer = $timeout(function() {
1680
+ closeAllAnimations(animationElementQueue);
1681
+ animationElementQueue = [];
1682
+ }, totalTime, false);
1683
+ }
1684
+
1685
+ function closeAllAnimations(elements) {
1686
+ forEach(elements, function(element) {
1687
+ var elementData = element.data(NG_ANIMATE_CSS_DATA_KEY);
1688
+ if (elementData) {
1689
+ forEach(elementData.closeAnimationFns, function(fn) {
1690
+ fn();
1691
+ });
1692
+ }
1693
+ });
1694
+ }
1695
+
1696
+ function getElementAnimationDetails(element, cacheKey) {
1697
+ var data = cacheKey ? lookupCache[cacheKey] : null;
1698
+ if (!data) {
1699
+ var transitionDuration = 0;
1700
+ var transitionDelay = 0;
1701
+ var animationDuration = 0;
1702
+ var animationDelay = 0;
1703
+
1704
+ //we want all the styles defined before and after
1705
+ forEach(element, function(element) {
1706
+ if (element.nodeType == ELEMENT_NODE) {
1707
+ var elementStyles = $window.getComputedStyle(element) || {};
1708
+
1709
+ var transitionDurationStyle = elementStyles[TRANSITION_PROP + DURATION_KEY];
1710
+ transitionDuration = Math.max(parseMaxTime(transitionDurationStyle), transitionDuration);
1711
+
1712
+ var transitionDelayStyle = elementStyles[TRANSITION_PROP + DELAY_KEY];
1713
+ transitionDelay = Math.max(parseMaxTime(transitionDelayStyle), transitionDelay);
1714
+
1715
+ var animationDelayStyle = elementStyles[ANIMATION_PROP + DELAY_KEY];
1716
+ animationDelay = Math.max(parseMaxTime(elementStyles[ANIMATION_PROP + DELAY_KEY]), animationDelay);
1717
+
1718
+ var aDuration = parseMaxTime(elementStyles[ANIMATION_PROP + DURATION_KEY]);
1719
+
1720
+ if (aDuration > 0) {
1721
+ aDuration *= parseInt(elementStyles[ANIMATION_PROP + ANIMATION_ITERATION_COUNT_KEY], 10) || 1;
1722
+ }
1723
+ animationDuration = Math.max(aDuration, animationDuration);
1724
+ }
1725
+ });
1726
+ data = {
1727
+ total: 0,
1728
+ transitionDelay: transitionDelay,
1729
+ transitionDuration: transitionDuration,
1730
+ animationDelay: animationDelay,
1731
+ animationDuration: animationDuration
1732
+ };
1733
+ if (cacheKey) {
1734
+ lookupCache[cacheKey] = data;
1735
+ }
1736
+ }
1737
+ return data;
1738
+ }
1739
+
1740
+ function parseMaxTime(str) {
1741
+ var maxValue = 0;
1742
+ var values = isString(str) ?
1743
+ str.split(/\s*,\s*/) :
1744
+ [];
1745
+ forEach(values, function(value) {
1746
+ maxValue = Math.max(parseFloat(value) || 0, maxValue);
1747
+ });
1748
+ return maxValue;
1749
+ }
1750
+
1751
+ function getCacheKey(element) {
1752
+ var parentElement = element.parent();
1753
+ var parentID = parentElement.data(NG_ANIMATE_PARENT_KEY);
1754
+ if (!parentID) {
1755
+ parentElement.data(NG_ANIMATE_PARENT_KEY, ++parentCounter);
1756
+ parentID = parentCounter;
1757
+ }
1758
+ return parentID + '-' + extractElementNode(element).getAttribute('class');
1759
+ }
1760
+
1761
+ function animateSetup(animationEvent, element, className, styles) {
1762
+ var structural = ['ng-enter','ng-leave','ng-move'].indexOf(className) >= 0;
1763
+
1764
+ var cacheKey = getCacheKey(element);
1765
+ var eventCacheKey = cacheKey + ' ' + className;
1766
+ var itemIndex = lookupCache[eventCacheKey] ? ++lookupCache[eventCacheKey].total : 0;
1767
+
1768
+ var stagger = {};
1769
+ if (itemIndex > 0) {
1770
+ var staggerClassName = className + '-stagger';
1771
+ var staggerCacheKey = cacheKey + ' ' + staggerClassName;
1772
+ var applyClasses = !lookupCache[staggerCacheKey];
1773
+
1774
+ applyClasses && $$jqLite.addClass(element, staggerClassName);
1775
+
1776
+ stagger = getElementAnimationDetails(element, staggerCacheKey);
1777
+
1778
+ applyClasses && $$jqLite.removeClass(element, staggerClassName);
1779
+ }
1780
+
1781
+ $$jqLite.addClass(element, className);
1782
+
1783
+ var formerData = element.data(NG_ANIMATE_CSS_DATA_KEY) || {};
1784
+ var timings = getElementAnimationDetails(element, eventCacheKey);
1785
+ var transitionDuration = timings.transitionDuration;
1786
+ var animationDuration = timings.animationDuration;
1787
+
1788
+ if (structural && transitionDuration === 0 && animationDuration === 0) {
1789
+ $$jqLite.removeClass(element, className);
1790
+ return false;
1791
+ }
1792
+
1793
+ var blockTransition = styles || (structural && transitionDuration > 0);
1794
+ var blockAnimation = animationDuration > 0 &&
1795
+ stagger.animationDelay > 0 &&
1796
+ stagger.animationDuration === 0;
1797
+
1798
+ var closeAnimationFns = formerData.closeAnimationFns || [];
1799
+ element.data(NG_ANIMATE_CSS_DATA_KEY, {
1800
+ stagger: stagger,
1801
+ cacheKey: eventCacheKey,
1802
+ running: formerData.running || 0,
1803
+ itemIndex: itemIndex,
1804
+ blockTransition: blockTransition,
1805
+ closeAnimationFns: closeAnimationFns
1806
+ });
1807
+
1808
+ var node = extractElementNode(element);
1809
+
1810
+ if (blockTransition) {
1811
+ blockTransitions(node, true);
1812
+ if (styles) {
1813
+ element.css(styles);
1814
+ }
1815
+ }
1816
+
1817
+ if (blockAnimation) {
1818
+ blockAnimations(node, true);
1819
+ }
1820
+
1821
+ return true;
1822
+ }
1823
+
1824
+ function animateRun(animationEvent, element, className, activeAnimationComplete, styles) {
1825
+ var node = extractElementNode(element);
1826
+ var elementData = element.data(NG_ANIMATE_CSS_DATA_KEY);
1827
+ if (node.getAttribute('class').indexOf(className) == -1 || !elementData) {
1828
+ activeAnimationComplete();
1829
+ return;
1830
+ }
1831
+
1832
+ var activeClassName = '';
1833
+ var pendingClassName = '';
1834
+ forEach(className.split(' '), function(klass, i) {
1835
+ var prefix = (i > 0 ? ' ' : '') + klass;
1836
+ activeClassName += prefix + '-active';
1837
+ pendingClassName += prefix + '-pending';
1838
+ });
1839
+
1840
+ var style = '';
1841
+ var appliedStyles = [];
1842
+ var itemIndex = elementData.itemIndex;
1843
+ var stagger = elementData.stagger;
1844
+ var staggerTime = 0;
1845
+ if (itemIndex > 0) {
1846
+ var transitionStaggerDelay = 0;
1847
+ if (stagger.transitionDelay > 0 && stagger.transitionDuration === 0) {
1848
+ transitionStaggerDelay = stagger.transitionDelay * itemIndex;
1849
+ }
1850
+
1851
+ var animationStaggerDelay = 0;
1852
+ if (stagger.animationDelay > 0 && stagger.animationDuration === 0) {
1853
+ animationStaggerDelay = stagger.animationDelay * itemIndex;
1854
+ appliedStyles.push(CSS_PREFIX + 'animation-play-state');
1855
+ }
1856
+
1857
+ staggerTime = Math.round(Math.max(transitionStaggerDelay, animationStaggerDelay) * 100) / 100;
1858
+ }
1859
+
1860
+ if (!staggerTime) {
1861
+ $$jqLite.addClass(element, activeClassName);
1862
+ if (elementData.blockTransition) {
1863
+ blockTransitions(node, false);
1864
+ }
1865
+ }
1866
+
1867
+ var eventCacheKey = elementData.cacheKey + ' ' + activeClassName;
1868
+ var timings = getElementAnimationDetails(element, eventCacheKey);
1869
+ var maxDuration = Math.max(timings.transitionDuration, timings.animationDuration);
1870
+ if (maxDuration === 0) {
1871
+ $$jqLite.removeClass(element, activeClassName);
1872
+ animateClose(element, className);
1873
+ activeAnimationComplete();
1874
+ return;
1875
+ }
1876
+
1877
+ if (!staggerTime && styles) {
1878
+ if (!timings.transitionDuration) {
1879
+ element.css('transition', timings.animationDuration + 's linear all');
1880
+ appliedStyles.push('transition');
1881
+ }
1882
+ element.css(styles);
1883
+ }
1884
+
1885
+ var maxDelay = Math.max(timings.transitionDelay, timings.animationDelay);
1886
+ var maxDelayTime = maxDelay * ONE_SECOND;
1887
+
1888
+ if (appliedStyles.length > 0) {
1889
+ //the element being animated may sometimes contain comment nodes in
1890
+ //the jqLite object, so we're safe to use a single variable to house
1891
+ //the styles since there is always only one element being animated
1892
+ var oldStyle = node.getAttribute('style') || '';
1893
+ if (oldStyle.charAt(oldStyle.length - 1) !== ';') {
1894
+ oldStyle += ';';
1895
+ }
1896
+ node.setAttribute('style', oldStyle + ' ' + style);
1897
+ }
1898
+
1899
+ var startTime = Date.now();
1900
+ var css3AnimationEvents = ANIMATIONEND_EVENT + ' ' + TRANSITIONEND_EVENT;
1901
+ var animationTime = (maxDelay + maxDuration) * CLOSING_TIME_BUFFER;
1902
+ var totalTime = (staggerTime + animationTime) * ONE_SECOND;
1903
+
1904
+ var staggerTimeout;
1905
+ if (staggerTime > 0) {
1906
+ $$jqLite.addClass(element, pendingClassName);
1907
+ staggerTimeout = $timeout(function() {
1908
+ staggerTimeout = null;
1909
+
1910
+ if (timings.transitionDuration > 0) {
1911
+ blockTransitions(node, false);
1912
+ }
1913
+ if (timings.animationDuration > 0) {
1914
+ blockAnimations(node, false);
1915
+ }
1916
+
1917
+ $$jqLite.addClass(element, activeClassName);
1918
+ $$jqLite.removeClass(element, pendingClassName);
1919
+
1920
+ if (styles) {
1921
+ if (timings.transitionDuration === 0) {
1922
+ element.css('transition', timings.animationDuration + 's linear all');
1923
+ }
1924
+ element.css(styles);
1925
+ appliedStyles.push('transition');
1926
+ }
1927
+ }, staggerTime * ONE_SECOND, false);
1928
+ }
1929
+
1930
+ element.on(css3AnimationEvents, onAnimationProgress);
1931
+ elementData.closeAnimationFns.push(function() {
1932
+ onEnd();
1933
+ activeAnimationComplete();
1934
+ });
1935
+
1936
+ elementData.running++;
1937
+ animationCloseHandler(element, totalTime);
1938
+ return onEnd;
1939
+
1940
+ // This will automatically be called by $animate so
1941
+ // there is no need to attach this internally to the
1942
+ // timeout done method.
1943
+ function onEnd() {
1944
+ element.off(css3AnimationEvents, onAnimationProgress);
1945
+ $$jqLite.removeClass(element, activeClassName);
1946
+ $$jqLite.removeClass(element, pendingClassName);
1947
+ if (staggerTimeout) {
1948
+ $timeout.cancel(staggerTimeout);
1949
+ }
1950
+ animateClose(element, className);
1951
+ var node = extractElementNode(element);
1952
+ for (var i in appliedStyles) {
1953
+ node.style.removeProperty(appliedStyles[i]);
1954
+ }
1955
+ }
1956
+
1957
+ function onAnimationProgress(event) {
1958
+ event.stopPropagation();
1959
+ var ev = event.originalEvent || event;
1960
+ var timeStamp = ev.$manualTimeStamp || ev.timeStamp || Date.now();
1961
+
1962
+ /* Firefox (or possibly just Gecko) likes to not round values up
1963
+ * when a ms measurement is used for the animation */
1964
+ var elapsedTime = parseFloat(ev.elapsedTime.toFixed(ELAPSED_TIME_MAX_DECIMAL_PLACES));
1965
+
1966
+ /* $manualTimeStamp is a mocked timeStamp value which is set
1967
+ * within browserTrigger(). This is only here so that tests can
1968
+ * mock animations properly. Real events fallback to event.timeStamp,
1969
+ * or, if they don't, then a timeStamp is automatically created for them.
1970
+ * We're checking to see if the timeStamp surpasses the expected delay,
1971
+ * but we're using elapsedTime instead of the timeStamp on the 2nd
1972
+ * pre-condition since animations sometimes close off early */
1973
+ if (Math.max(timeStamp - startTime, 0) >= maxDelayTime && elapsedTime >= maxDuration) {
1974
+ activeAnimationComplete();
1975
+ }
1976
+ }
1977
+ }
1978
+
1979
+ function blockTransitions(node, bool) {
1980
+ node.style[TRANSITION_PROP + PROPERTY_KEY] = bool ? 'none' : '';
1981
+ }
1982
+
1983
+ function blockAnimations(node, bool) {
1984
+ node.style[ANIMATION_PROP + ANIMATION_PLAYSTATE_KEY] = bool ? 'paused' : '';
1985
+ }
1986
+
1987
+ function animateBefore(animationEvent, element, className, styles) {
1988
+ if (animateSetup(animationEvent, element, className, styles)) {
1989
+ return function(cancelled) {
1990
+ cancelled && animateClose(element, className);
1991
+ };
1992
+ }
1993
+ }
1994
+
1995
+ function animateAfter(animationEvent, element, className, afterAnimationComplete, styles) {
1996
+ if (element.data(NG_ANIMATE_CSS_DATA_KEY)) {
1997
+ return animateRun(animationEvent, element, className, afterAnimationComplete, styles);
1998
+ } else {
1999
+ animateClose(element, className);
2000
+ afterAnimationComplete();
2001
+ }
2002
+ }
2003
+
2004
+ function animate(animationEvent, element, className, animationComplete, options) {
2005
+ //If the animateSetup function doesn't bother returning a
2006
+ //cancellation function then it means that there is no animation
2007
+ //to perform at all
2008
+ var preReflowCancellation = animateBefore(animationEvent, element, className, options.from);
2009
+ if (!preReflowCancellation) {
2010
+ clearCacheAfterReflow();
2011
+ animationComplete();
2012
+ return;
2013
+ }
2014
+
2015
+ //There are two cancellation functions: one is before the first
2016
+ //reflow animation and the second is during the active state
2017
+ //animation. The first function will take care of removing the
2018
+ //data from the element which will not make the 2nd animation
2019
+ //happen in the first place
2020
+ var cancel = preReflowCancellation;
2021
+ afterReflow(element, function() {
2022
+ //once the reflow is complete then we point cancel to
2023
+ //the new cancellation function which will remove all of the
2024
+ //animation properties from the active animation
2025
+ cancel = animateAfter(animationEvent, element, className, animationComplete, options.to);
2026
+ });
2027
+
2028
+ return function(cancelled) {
2029
+ (cancel || noop)(cancelled);
2030
+ };
2031
+ }
2032
+
2033
+ function animateClose(element, className) {
2034
+ $$jqLite.removeClass(element, className);
2035
+ var data = element.data(NG_ANIMATE_CSS_DATA_KEY);
2036
+ if (data) {
2037
+ if (data.running) {
2038
+ data.running--;
2039
+ }
2040
+ if (!data.running || data.running === 0) {
2041
+ element.removeData(NG_ANIMATE_CSS_DATA_KEY);
2042
+ }
2043
+ }
2044
+ }
2045
+
2046
+ return {
2047
+ animate: function(element, className, from, to, animationCompleted, options) {
2048
+ options = options || {};
2049
+ options.from = from;
2050
+ options.to = to;
2051
+ return animate('animate', element, className, animationCompleted, options);
2052
+ },
2053
+
2054
+ enter: function(element, animationCompleted, options) {
2055
+ options = options || {};
2056
+ return animate('enter', element, 'ng-enter', animationCompleted, options);
2057
+ },
2058
+
2059
+ leave: function(element, animationCompleted, options) {
2060
+ options = options || {};
2061
+ return animate('leave', element, 'ng-leave', animationCompleted, options);
2062
+ },
2063
+
2064
+ move: function(element, animationCompleted, options) {
2065
+ options = options || {};
2066
+ return animate('move', element, 'ng-move', animationCompleted, options);
2067
+ },
2068
+
2069
+ beforeSetClass: function(element, add, remove, animationCompleted, options) {
2070
+ options = options || {};
2071
+ var className = suffixClasses(remove, '-remove') + ' ' +
2072
+ suffixClasses(add, '-add');
2073
+ var cancellationMethod = animateBefore('setClass', element, className, options.from);
2074
+ if (cancellationMethod) {
2075
+ afterReflow(element, animationCompleted);
2076
+ return cancellationMethod;
2077
+ }
2078
+ clearCacheAfterReflow();
2079
+ animationCompleted();
2080
+ },
2081
+
2082
+ beforeAddClass: function(element, className, animationCompleted, options) {
2083
+ options = options || {};
2084
+ var cancellationMethod = animateBefore('addClass', element, suffixClasses(className, '-add'), options.from);
2085
+ if (cancellationMethod) {
2086
+ afterReflow(element, animationCompleted);
2087
+ return cancellationMethod;
2088
+ }
2089
+ clearCacheAfterReflow();
2090
+ animationCompleted();
2091
+ },
2092
+
2093
+ beforeRemoveClass: function(element, className, animationCompleted, options) {
2094
+ options = options || {};
2095
+ var cancellationMethod = animateBefore('removeClass', element, suffixClasses(className, '-remove'), options.from);
2096
+ if (cancellationMethod) {
2097
+ afterReflow(element, animationCompleted);
2098
+ return cancellationMethod;
2099
+ }
2100
+ clearCacheAfterReflow();
2101
+ animationCompleted();
2102
+ },
2103
+
2104
+ setClass: function(element, add, remove, animationCompleted, options) {
2105
+ options = options || {};
2106
+ remove = suffixClasses(remove, '-remove');
2107
+ add = suffixClasses(add, '-add');
2108
+ var className = remove + ' ' + add;
2109
+ return animateAfter('setClass', element, className, animationCompleted, options.to);
2110
+ },
2111
+
2112
+ addClass: function(element, className, animationCompleted, options) {
2113
+ options = options || {};
2114
+ return animateAfter('addClass', element, suffixClasses(className, '-add'), animationCompleted, options.to);
2115
+ },
2116
+
2117
+ removeClass: function(element, className, animationCompleted, options) {
2118
+ options = options || {};
2119
+ return animateAfter('removeClass', element, suffixClasses(className, '-remove'), animationCompleted, options.to);
2120
+ }
2121
+ };
2122
+
2123
+ function suffixClasses(classes, suffix) {
2124
+ var className = '';
2125
+ classes = isArray(classes) ? classes : classes.split(/\s+/);
2126
+ forEach(classes, function(klass, i) {
2127
+ if (klass && klass.length > 0) {
2128
+ className += (i > 0 ? ' ' : '') + klass + suffix;
2129
+ }
2130
+ });
2131
+ return className;
2132
+ }
2133
+ }]);
2134
+ }]);
2135
+
2136
+
2137
+ })(window, window.angular);