258 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			258 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
| /**
 | |
|  * @license
 | |
|  * Copyright Google Inc. All Rights Reserved.
 | |
|  *
 | |
|  * Use of this source code is governed by an MIT-style license that can be
 | |
|  * found in the LICENSE file at https://angular.io/license
 | |
|  */
 | |
| 
 | |
| import {AnimationOptions, animate, state, style, transition} from '@angular/animations';
 | |
| import {AnimationTransitionInstruction} from '@angular/animations/browser/src/dsl/animation_transition_instruction';
 | |
| import {AnimationTrigger} from '@angular/animations/browser/src/dsl/animation_trigger';
 | |
| 
 | |
| import {ENTER_CLASSNAME, LEAVE_CLASSNAME} from '../../src/util';
 | |
| import {MockAnimationDriver} from '../../testing';
 | |
| import {makeTrigger} from '../shared';
 | |
| 
 | |
| {
 | |
|   describe('AnimationTrigger', () => {
 | |
|     // these tests are only mean't to be run within the DOM (for now)
 | |
|     if (typeof Element == 'undefined') return;
 | |
| 
 | |
|     let element: any;
 | |
|     beforeEach(() => {
 | |
|       element = document.createElement('div');
 | |
|       document.body.appendChild(element);
 | |
|     });
 | |
| 
 | |
|     afterEach(() => { document.body.removeChild(element); });
 | |
| 
 | |
|     describe('trigger validation', () => {
 | |
|       it('should group errors together for an animation trigger', () => {
 | |
|         expect(() => {
 | |
|           makeTrigger('myTrigger', [transition('12345', animate(3333))]);
 | |
|         }).toThrowError(/Animation parsing for the myTrigger trigger have failed/);
 | |
|       });
 | |
| 
 | |
|       it('should throw an error when a transition within a trigger contains an invalid expression',
 | |
|          () => {
 | |
|            expect(
 | |
|                () => { makeTrigger('name', [transition('somethingThatIsWrong', animate(3333))]); })
 | |
|                .toThrowError(
 | |
|                    /- The provided transition expression "somethingThatIsWrong" is not supported/);
 | |
|          });
 | |
| 
 | |
|       it('should throw an error if an animation alias is used that is not yet supported', () => {
 | |
|         expect(() => {
 | |
|           makeTrigger('name', [transition(':angular', animate(3333))]);
 | |
|         }).toThrowError(/- The transition alias value ":angular" is not supported/);
 | |
|       });
 | |
|     });
 | |
| 
 | |
|     describe('trigger usage', () => {
 | |
|       it('should construct a trigger based on the states and transition data', () => {
 | |
|         const result = makeTrigger('name', [
 | |
|           state('on', style({width: 0})),
 | |
|           state('off', style({width: 100})),
 | |
|           transition('on => off', animate(1000)),
 | |
|           transition('off => on', animate(1000)),
 | |
|         ]);
 | |
| 
 | |
|         expect(result.states['on'].buildStyles({}, [])).toEqual({width: 0});
 | |
|         expect(result.states['off'].buildStyles({}, [])).toEqual({width: 100});
 | |
|         expect(result.transitionFactories.length).toEqual(2);
 | |
|       });
 | |
| 
 | |
|       it('should allow multiple state values to use the same styles', () => {
 | |
|         const result = makeTrigger('name', [
 | |
|           state('on, off', style({width: 50})), transition('on => off', animate(1000)),
 | |
|           transition('off => on', animate(1000))
 | |
|         ]);
 | |
| 
 | |
| 
 | |
|         expect(result.states['on'].buildStyles({}, [])).toEqual({width: 50});
 | |
|         expect(result.states['off'].buildStyles({}, [])).toEqual({width: 50});
 | |
|       });
 | |
| 
 | |
|       it('should find the first transition that matches', () => {
 | |
|         const result = makeTrigger(
 | |
|             'name', [transition('a => b', animate(1234)), transition('b => c', animate(5678))]);
 | |
| 
 | |
|         const trans = buildTransition(result, element, 'b', 'c') !;
 | |
|         expect(trans.timelines.length).toEqual(1);
 | |
|         const timeline = trans.timelines[0];
 | |
|         expect(timeline.duration).toEqual(5678);
 | |
|       });
 | |
| 
 | |
|       it('should find a transition with a `*` value', () => {
 | |
|         const result = makeTrigger('name', [
 | |
|           transition('* => b', animate(1234)), transition('b => *', animate(5678)),
 | |
|           transition('* => *', animate(9999))
 | |
|         ]);
 | |
| 
 | |
|         let trans = buildTransition(result, element, 'b', 'c') !;
 | |
|         expect(trans.timelines[0].duration).toEqual(5678);
 | |
| 
 | |
|         trans = buildTransition(result, element, 'a', 'b') !;
 | |
|         expect(trans.timelines[0].duration).toEqual(1234);
 | |
| 
 | |
|         trans = buildTransition(result, element, 'c', 'c') !;
 | |
|         expect(trans.timelines[0].duration).toEqual(9999);
 | |
|       });
 | |
| 
 | |
|       it('should null when no results are found', () => {
 | |
|         const result = makeTrigger('name', [transition('a => b', animate(1111))]);
 | |
| 
 | |
|         const trigger = result.matchTransition('b', 'a', {}, {});
 | |
|         expect(trigger).toBeFalsy();
 | |
|       });
 | |
| 
 | |
|       it('should support bi-directional transition expressions', () => {
 | |
|         const result = makeTrigger('name', [transition('a <=> b', animate(2222))]);
 | |
| 
 | |
|         const t1 = buildTransition(result, element, 'a', 'b') !;
 | |
|         expect(t1.timelines[0].duration).toEqual(2222);
 | |
| 
 | |
|         const t2 = buildTransition(result, element, 'b', 'a') !;
 | |
|         expect(t2.timelines[0].duration).toEqual(2222);
 | |
|       });
 | |
| 
 | |
|       it('should support multiple transition statements in one string', () => {
 | |
|         const result = makeTrigger('name', [transition('a => b, b => a, c => *', animate(1234))]);
 | |
| 
 | |
|         const t1 = buildTransition(result, element, 'a', 'b') !;
 | |
|         expect(t1.timelines[0].duration).toEqual(1234);
 | |
| 
 | |
|         const t2 = buildTransition(result, element, 'b', 'a') !;
 | |
|         expect(t2.timelines[0].duration).toEqual(1234);
 | |
| 
 | |
|         const t3 = buildTransition(result, element, 'c', 'a') !;
 | |
|         expect(t3.timelines[0].duration).toEqual(1234);
 | |
|       });
 | |
| 
 | |
|       describe('params', () => {
 | |
|         it('should support transition-level animation variable params', () => {
 | |
|           const result = makeTrigger(
 | |
|               'name',
 | |
|               [transition(
 | |
|                   'a => b', [style({height: '{{ a }}'}), animate(1000, style({height: '{{ b }}'}))],
 | |
|                   buildParams({a: '100px', b: '200px'}))]);
 | |
| 
 | |
|           const trans = buildTransition(result, element, 'a', 'b') !;
 | |
|           const keyframes = trans.timelines[0].keyframes;
 | |
|           expect(keyframes).toEqual([{height: '100px', offset: 0}, {height: '200px', offset: 1}]);
 | |
|         });
 | |
| 
 | |
|         it('should substitute variable params provided directly within the transition match',
 | |
|            () => {
 | |
|              const result = makeTrigger(
 | |
|                  'name',
 | |
|                  [transition(
 | |
|                      'a => b',
 | |
|                      [style({height: '{{ a }}'}), animate(1000, style({height: '{{ b }}'}))],
 | |
|                      buildParams({a: '100px', b: '200px'}))]);
 | |
| 
 | |
|              const trans =
 | |
|                  buildTransition(result, element, 'a', 'b', {}, buildParams({a: '300px'})) !;
 | |
| 
 | |
|              const keyframes = trans.timelines[0].keyframes;
 | |
|              expect(keyframes).toEqual(
 | |
|                  [{height: '300px', offset: 0}, {height: '200px', offset: 1}]);
 | |
|            });
 | |
|       });
 | |
| 
 | |
|       it('should match `true` and `false` given boolean values', () => {
 | |
|         const result = makeTrigger('name', [
 | |
|           state('false', style({color: 'red'})), state('true', style({color: 'green'})),
 | |
|           transition('true <=> false', animate(1234))
 | |
|         ]);
 | |
| 
 | |
|         const trans = buildTransition(result, element, false, true) !;
 | |
|         expect(trans.timelines[0].duration).toEqual(1234);
 | |
|       });
 | |
| 
 | |
|       it('should match `1` and `0` given boolean values', () => {
 | |
|         const result = makeTrigger('name', [
 | |
|           state('0', style({color: 'red'})), state('1', style({color: 'green'})),
 | |
|           transition('1 <=> 0', animate(4567))
 | |
|         ]);
 | |
| 
 | |
|         const trans = buildTransition(result, element, false, true) !;
 | |
|         expect(trans.timelines[0].duration).toEqual(4567);
 | |
|       });
 | |
| 
 | |
|       it('should match `true` and `false` state styles on a `1 <=> 0` boolean transition given boolean values',
 | |
|          () => {
 | |
|            const result = makeTrigger('name', [
 | |
|              state('false', style({color: 'red'})), state('true', style({color: 'green'})),
 | |
|              transition('1 <=> 0', animate(4567))
 | |
|            ]);
 | |
| 
 | |
|            const trans = buildTransition(result, element, false, true) !;
 | |
|            expect(trans.timelines[0].keyframes).toEqual([
 | |
|              {offset: 0, color: 'red'}, {offset: 1, color: 'green'}
 | |
|            ]);
 | |
|          });
 | |
| 
 | |
|       it('should match `1` and `0` state styles on a `true <=> false` boolean transition given boolean values',
 | |
|          () => {
 | |
|            const result = makeTrigger('name', [
 | |
|              state('0', style({color: 'orange'})), state('1', style({color: 'blue'})),
 | |
|              transition('true <=> false', animate(4567))
 | |
|            ]);
 | |
| 
 | |
|            const trans = buildTransition(result, element, false, true) !;
 | |
|            expect(trans.timelines[0].keyframes).toEqual([
 | |
|              {offset: 0, color: 'orange'}, {offset: 1, color: 'blue'}
 | |
|            ]);
 | |
|          });
 | |
| 
 | |
|       it('should treat numeric values (disguised as strings) as proper state values', () => {
 | |
|         const result = makeTrigger('name', [
 | |
|           state(1 as any as string, style({opacity: 0})),
 | |
|           state(0 as any as string, style({opacity: 0})), transition('* => *', animate(1000))
 | |
|         ]);
 | |
| 
 | |
|         expect(() => {
 | |
|           const trans = buildTransition(result, element, false, true) !;
 | |
|         }).not.toThrow();
 | |
|       });
 | |
| 
 | |
|       describe('aliases', () => {
 | |
|         it('should alias the :enter transition as void => *', () => {
 | |
|           const result = makeTrigger('name', [transition(':enter', animate(3333))]);
 | |
| 
 | |
|           const trans = buildTransition(result, element, 'void', 'something') !;
 | |
|           expect(trans.timelines[0].duration).toEqual(3333);
 | |
|         });
 | |
| 
 | |
|         it('should alias the :leave transition as * => void', () => {
 | |
|           const result = makeTrigger('name', [transition(':leave', animate(3333))]);
 | |
| 
 | |
|           const trans = buildTransition(result, element, 'something', 'void') !;
 | |
|           expect(trans.timelines[0].duration).toEqual(3333);
 | |
|         });
 | |
|       });
 | |
|     });
 | |
|   });
 | |
| }
 | |
| 
 | |
| function buildTransition(
 | |
|     trigger: AnimationTrigger, element: any, fromState: any, toState: any,
 | |
|     fromOptions?: AnimationOptions, toOptions?: AnimationOptions): AnimationTransitionInstruction|
 | |
|     null {
 | |
|   const params = toOptions && toOptions.params || {};
 | |
|   const trans = trigger.matchTransition(fromState, toState, element, params) !;
 | |
|   if (trans) {
 | |
|     const driver = new MockAnimationDriver();
 | |
|     return trans.build(
 | |
|         driver, element, fromState, toState, ENTER_CLASSNAME, LEAVE_CLASSNAME, fromOptions,
 | |
|         toOptions) !;
 | |
|   }
 | |
|   return null;
 | |
| }
 | |
| 
 | |
| function buildParams(params: {[name: string]: any}): AnimationOptions {
 | |
|   return <AnimationOptions>{params};
 | |
| }
 |