Animations transitions and triggers


You learned the basics of Angular animations in the introduction page.

你已经在简介页学习了 Angular 动画的基础知识。

In this guide, we go into greater depth on special transition states such as * (wildcard) and void, and show how these special states are used for elements entering and leaving a view. The chapter also explores on multiple animation triggers, animation callbacks and sequence-based animation using keyframes.

本章,我们将深入讲解特殊的转场状态,如 *(通配符)和 void,并说明这些特殊状态如何作用于进入或离开视图的元素。本章还探讨了多重触发器、动画回调,以及使用关键帧技术的序列动画。

Predefined states and wildcard matching


In Angular, transition states can be defined explicitly through the state() function, or using the predefined * (wildcard) and void states.

在 Angular 中,转场状态可以通过 state() 函数进行显式定义,或使用预定义的 *(通配符)状态和 void 状态。

Wildcard state


An asterisk * or wildcard matches any animation state. This is useful for defining transitions that apply regardless of the HTML element's start or end state.

星号 * 或者叫通配符可以匹配任何一个动画状态。它可用来定义那些不用在乎 HTML 元素的起始状态或结束状态的转场动画。

For example, a transition of open => * applies when the element's state changes from open to anything else.

比如,一个 open => * 转场可应用在当元素的状态从 open 变成任何其它状态时。

wildcard state expressions

Here's another code sample using the wildcard state together with our previous example using the open and closed states. Instead of defining each state-to-state transition pair, we're now saying that any transition to closed takes 1 second, and any transition to open takes 0.5 seconds.

下面是通配符状态的另一个代码范例,以及我们以前使用 openclosed 状态的实例。但这次,对于每个状态到状态的转换对,我们这次规定从任何状态转场到 closed 状态时要花 1 秒钟,而从任何状态转场到 open 状态时要花 0.5 秒。

This allows us to add new states without having to include separate transitions for each one.


animations: [ trigger('openClose', [ // ... state('open', style({ height: '200px', opacity: 1, backgroundColor: 'yellow' })), state('closed', style({ height: '100px', opacity: 0.5, backgroundColor: 'green' })), transition('* => closed', [ animate('1s') ]), transition('* => open', [ animate('0.5s') ]), ]), ],

Use a double arrow syntax to specify state-to-state transitions in both directions.


transition('open <=> closed', [ animate('0.5s') ]),

Using wildcard state with multiple transition states


In our two-state button example, the wildcard isn't that useful because there are only two possible states, open and closed. Wildcard states are better when an element in one particular state has multiple potential states that it can change to. If our button can change from open to either closed or something like inProgress, using a wildcard state could reduce the amount of coding needed.

在这个双态按钮的例子中,通配符不是很有用,因为只有两种可能的状态:openclosed。当一个特定状态下的元素可能变更为多个潜在状态时,通配符状态会更好用。如果我们的按钮可以从 open 编程 closed 或类似 inProgress 的状态,则可以使用通配符状态来减少所需的编码量。

wildcard state with 3 states
animations: [ trigger('openClose', [ // ... state('open', style({ height: '200px', opacity: 1, backgroundColor: 'yellow' })), state('closed', style({ height: '100px', opacity: 0.5, backgroundColor: 'green' })), transition('open => closed', [ animate('1s') ]), transition('closed => open', [ animate('0.5s') ]), transition('* => closed', [ animate('1s') ]), transition('* => open', [ animate('0.5s') ]), transition('open <=> closed', [ animate('0.5s') ]), transition ('* => open', [ animate ('1s', style ({ opacity: '*' }), ), ]), transition('* => *', [ animate('1s') ]),

The * => * transition applies when any change between two states takes place.

当在任意两个状态之间切换时,* => * 转场都会生效。

Transitions are matched in the order in which they are defined. Thus, you can apply other transitions on top of the * => * (any-to-any) transition. For example, define style changes or animations that would apply just to open => closed, or just to closed => open, and then use * => * as a fallback for state pairings that aren't otherwise called out.

转场会按照其定义的顺序进行匹配。因此,你可以在 * => * 转场的前面定义其它转场。比如,定义只针对 open => closed 的状态变更或动画,或 closed => open,而使用 * => * 作为匹配不上其它状态对时的后备。

To do this, list the more specific transitions before * => *.

要这么做,只要把那些更特殊的转场放在 * => * 前面就行了。

Using wildcards with styles


Use the wildcard * with a style to tell the animation to use whatever the current style value is, and animate with that. Wildcard is a fallback value that's used if the state being animated isn't declared within the trigger.

使用带样式的 * 通配符来告诉动画使用当前的状态值,并用它进行动画处理。通配符是一个后备值,如果未在触发器中声明动画状态,就会使用这个值。

transition ('* => open', [ animate ('1s', style ({ opacity: '*' }), ), ]),

Void state

void 状态

You can use the void state to configure transitions for an element that is entering or leaving a page. See Animating entering and leaving a view.

你可以使用 void 状态来为进入或离开页面的元素配置转场。参见进入和离开视图的动画

Combining wildcard and void states

组合使用通配符和 void 状态

You can combine wildcard and void states in a transition to trigger animations that enter and leave the page:

你可以在转场中组合使用通配符和 void 状态,以触发那些进入和离开页面的动画:

  • A transition of * => void applies when the element leaves a view, regardless of what state it was in before it left.

    当元素离开视图时,就会触发 * => void 转场,而不管它离开前处于什么状态。

  • A transition of void => * applies when the element enters a view, regardless of what state it assumes when entering.

    当元素进入视图时,就会触发 void => * 转场,而不管它进入时处于什么状态。

  • The wildcard state * matches to any state, including void.

    通配符状态 * 会匹配任何状态 —— 包括 void

Animating entering and leaving a view


This section shows how to animate elements entering or leaving a page.


Note: For our purposes, an element entering or leaving a view is equivalent to being inserted or removed from the DOM.

注意:出于我们的目的,我们把元素进入或离开视图等价于从 DOM 中插入或删除。

Now we'll add a new behavior:


  • When you add a hero to the list of heroes, it appears to fly onto the page from the left.


  • When you remove a hero from the list, it appears to fly out to the right.


animations: [ trigger('flyInOut', [ state('in', style({ transform: 'translateX(0)' })), transition('void => *', [ style({ transform: 'translateX(-100%)' }), animate(100) ]), transition('* => void', [ animate(100, style({ transform: 'translateX(100%)' })) ]) ]) ]

In the above code, we applied the void state when the HTML element isn't attached to a view.

在上述代码中,当 HTML 元素没有附着在视图中时,我们就会应用 void 状态。

:enter and :leave aliases

:enter 和 :leave 别名

:enter and :leave are aliases for the void => * and * => void transitions. These aliases are used by several animation functions.

:enter:leave 分别是 void => ** => void 的别名。 这些别名供多个动画函数使用。

transition ( ':enter', [ ... ] ); // alias for void => * transition ( ':leave', [ ... ] ); // alias for * => void

It's harder to target an element that is entering a view because it isn't in the DOM yet. So, use the aliases :enter and :leave to target HTML elements that are inserted or removed from a view.

定位进入视图的元素更难,因为它不在 DOM 中。 因此,使用别名 :enter:leave 来定位要从视图中插入或删除的 HTML 元素。

Use of *ngIf and *ngFor with :enter and :leave

:enter:leave 一起使用 *ngIf*ngFor

The :enter transition runs when any *ngIf or *ngFor views are placed on the page, and :leave runs when those views are removed from the page.

当任何 *ngIf*ngFor 中的视图放进页面中时,会运行 :enter 转场;当移除这些视图时,就会运行 :leave 转场。

In this example, we have a special trigger for the enter and leave animation called myInsertRemoveTrigger. The HTML template contains the following code.

在这个例子中,我们有一个名叫 myInsertRemoveTrigger 的触发器,来表示进入和离开动画。 其 HTML 模板包含下列代码。

<div @myInsertRemoveTrigger *ngIf="isShown" class="insert-remove-container"> <p>The box is inserted</p> </div>

In the component file, the :enter transition sets an initial opacity of 0, and then animates it to change that opacity to 1 as the element is inserted into the view.

在组件文件中,:enter 转场会将初始透明度设置为 0,然后设置动画,当该元素已经插入视图中之后,把这个透明度设置为 1。

trigger('myInsertRemoveTrigger', [ transition(':enter', [ style({ opacity: 0 }), animate('5s', style({ opacity: 1 })), ]), transition(':leave', [ animate('5s', style({ opacity: 0 })) ]) ]),

Note that this example doesn't need to use state().

注意,这个例子并不需要使用 state()

:increment and :decrement in transitions

转场中的 :increment:decrement

The transition() function takes additional selector values, :increment and :decrement. Use these to kick off a transition when a numeric value has increased or decreased in value.

transition() 函数还能接受额外的选择器值::increment:decrement。当数值增加或减小时,使用这些来启动转场。

Note: The following example uses query() and stagger() methods, which is discussed in the complex sequences page.

注意:下面的例子使用 query()stagger() 方法,它们会在复杂序列中讨论。

trigger('filterAnimation', [ transition(':enter, * => 0, * => -1', []), transition(':increment', [ query(':enter', [ style({ opacity: 0, width: '0px' }), stagger(50, [ animate('300ms ease-out', style({ opacity: 1, width: '*' })), ]), ], { optional: true }) ]), transition(':decrement', [ query(':leave', [ stagger(50, [ animate('300ms ease-out', style({ opacity: 0, width: '0px' })), ]), ]) ]), ]),

Boolean values in transitions


If a trigger contains a boolean value as a binding value, then this value can be matched using a transition() expression that compares true and false, or 1 and 0.

如果某个触发器以逻辑型的值作为绑定值,那么就可以使用能与 truefalse10 相比较的 transition() 表达式来匹配这个值。

<div [@openClose]="isOpen ? true : false" class="open-close-container"> </div>

In the code snippet above, the HTML template binds a <div> element to a trigger named openClose with a status expression of isOpen, and with possible values of true and false. This is an alternative to the practice of creating two named states of open and close.

在上述代码片段中,HTML 模板将 <div> 元素绑定到名为 openClose 的触发器,其状态表达式是 isOpen,可能的值为 truefalse。这种方式可以代替创建两个命名状态 openclose 的方式。

In the component code, in the @Component metadata under the animations: property, when the state evaluates to true (meaning "open" here), the associated HTML element's height is a wildcard style or default. In this case, use whatever height the element already had before the animation started. When the element is "closed," the element animates to a height of 0, which makes it invisible.

在组件代码中,@Component 元数据下的 animations: 属性中,当该状态求值为 true 时(这里表示 "open"),相关 HTML 元素的高度值为通配符样式 * 或某个默认值。在这种情况下,它会使用此元素开始动画前的现有高度。当该元素是 "closed" 时,它的高度会从指定的高度运动到 0,这会让它不可见。

animations: [ trigger('openClose', [ state('true', style({ height: '*' })), state('false', style({ height: '0px' })), transition('false <=> true', animate(500)) ]) ],

Multiple animation triggers


You can define more than one animation trigger for a component. You can attach animation triggers to different elements, and the parent-child relationships among the elements affect how and when the animations run.


Parent-child animations


Each time an animation is triggered in Angular, the parent animation always get priority and child animations are blocked. In order for a child animation to run, the parent animation must query each of the elements containing child animations and then allow the animations to run using the animateChild()function.

每次在 Angular 中触发动画时,父动画始终会优先,而子动画会被阻塞。为了运行子动画,父动画必须查询出包含子动画的每个元素,然后使用 animateChild()函数来运行它们。

Disabling an animation on an HTML element

在某个 HTML 元素上禁用动画

A special animation control binding called @.disabled can be placed on an HTML element to disable animations on that element, as well as any nested elements. When true, the @.disabled binding prevents all animations from rendering.

可以把一个名叫 @.disabled 的动画控制绑定放在 HTML 元素上,以禁用该元素及其子元素上的动画。当 @.disabled 绑定为 true 时,就会禁止渲染所有动画。

The code sample below shows how to use this feature.


<div [@.disabled]="isDisabled"> <div [@childAnimation]="isOpen ? 'open' : 'closed'" class="open-close-container"> <p>The box is now {{ isOpen ? 'Open' : 'Closed' }}!</p> </div> </div>@Component({ animations: [ trigger('childAnimation', [ // ... ]), ], }) export class OpenCloseChildComponent { isDisabled = false; isOpen = false; }

When the @.disabled binding is true, the @childAnimation trigger doesn't kick off.

@.disabled 绑定为 true 时,@childAnimation 触发器就不会启动。

When an element within an HTML template has animations disabled using the @.disabled host binding, animations are disabled on all inner elements as well. You can't selectively disable multiple animations on a single element.

当 HTML 模板中的某个元素使用 @.disabled 禁止了动画时,也会同时禁止其所有内部元素的动画。你无法有选择的单独禁用单个元素上的多个动画。

However, selective child animations can still be run on a disabled parent in one of the following ways:


  • A parent animation can use the query()function to collect inner elements located in disabled areas of the HTML template. Those elements can still animate.

    父动画可以使用 query()函数来收集 HTML 模板中位于禁止动画区域内部的元素。这些元素仍然可以播放动画。

  • A subanimation can be queried by a parent and then later animated with the animateChild() function.

    子动画可以被父动画查询,并且稍后使用 animateChild() 来播放它。

Disabling all animations


To disable all animations for an Angular app, place the @.disabled host binding on the topmost Angular component.

要禁用 Angular 应用中的所有动画,只要把 @.disabled 绑定放在顶级的 Angular 组件上即可。

@Component({ selector: 'app-root', templateUrl: 'app.component.html', styleUrls: ['app.component.css'], animations: [ slideInAnimation // animation triggers go here ] }) export class AppComponent { @HostBinding('@.disabled') public animationsDisabled = false; }

Note: Disabling animations application-wide is useful during end-to-end (E2E) testing.


Animation callbacks


The animation trigger() function emits callbacks when it starts and when it finishes. In the example below we have a component that contains an openClose trigger.

当动画启动和终止时,trigger() 函数会发出一些回调。在下面的例子中,我们有一个包含 openClose 触发器的组件。

@Component({ selector: 'app-open-close', animations: [ trigger('openClose', [ // ... ]), ], templateUrl: 'open-close.component.html', styleUrls: ['open-close.component.css'] }) export class OpenCloseComponent { onAnimationEvent ( event: AnimationEvent ) { } }

In the HTML template, the animation event is passed back via $event, as @trigger.start and @trigger.done, where trigger is the name of the trigger being used. In our example, the trigger openClose appears as follows.

在 HTML 模板中,动画事件可以通过 $event 传递回来,比如 @trigger.start@trigger.done ,这里的 trigger 表示所使用的触发器名字。在我们的例子中,openClose 触发器将会是这样的:

<div [@openClose]="isOpen ? 'open' : 'closed'" (@openClose.start)="onAnimationEvent($event)" (@openClose.done)="onAnimationEvent($event)" class="open-close-container"> </div>

A potential use for animation callbacks could be to cover for a slow API call, such as a database lookup. For example, you could set up the InProgress button to have its own looping animation where it pulsates or does some other visual motion while the backend system operation finishes.

动画回调的潜在用途之一,是用来覆盖比较慢的 API 调用,比如查阅数据库。例如,你可以建立一个 InProgress 按钮,让它拥有自己的循环动画。当后端系统操作完成时,它会播放脉动效果或其它一些视觉动作。

Then, another animation can be called when the current animation finishes. For example, the button goes from the inProgress state to the closed state when the API call is completed.

然后,在当前动画结束时,可以调用另一个动画。比如,当 API 调用完成时,按钮会从 inProgress 状态编程 closed 状态。

An animation can influence an end user to perceive the operation as faster, even when it isn't. Thus, a simple animation can be a cost-effective way to keep users happy, rather than seeking to improve the speed of a server call and having to compensate for circumstances beyond your control, such as an unreliable network connection.

动画可以影响最终用户,让他觉得操作更快 —— 虽然并没有。因此,简单的动画是保持用户满意的一种经济有效的手段,而不必寻求提高服务器调用的速度或被迫补救那些你无法控制的情况,比如不可靠的网络连接。

Callbacks can serve as a debugging tool, for example in conjunction with console.warn() to view the application's progress in a browser's Developer JavaScript Console. The following code snippet creates console log output for our original example, a button with the two states of open and closed.

回调可以作为调试工具,例如与 console.warn() 结合使用,以便在浏览器的开发者控制台中查看应用的进度。下列代码片段为我们原始的双态按钮(openclosed)范例创建了控制台输出。

export class OpenCloseComponent { onAnimationEvent ( event: AnimationEvent ) { // openClose is trigger name in this example console.warn(`Animation Trigger: ${event.triggerName}`); // phaseName is start or done console.warn(`Phase: ${event.phaseName}`); // in our example, totalTime is 1000 or 1 second console.warn(`Total time: ${event.totalTime}`); // in our example, fromState is either open or closed console.warn(`From: ${event.fromState}`); // in our example, toState either open or closed console.warn(`To: ${event.toState}`); // the HTML element itself, the button in this case console.warn(`Element: ${event.element}`); } }



In the previous section, we saw a simple two-state transition. Now we'll create an animation with multiple steps run in sequence using keyframes.


Angular's keyframe() function is similar to keyframes in CSS. Keyframes allow several style changes within a single timing segment. For example, our button, instead of fading, could change color several times over a single 2-second timespan.

Angular 的 keyframe() 函数类似于 CSS 中的关键帧。关键帧允许在单个时间段内进行多种样式更改。例如,我们的按钮可以在单个的 2 秒时间段内多次改变颜色,而不是渐隐掉。


The code for this color change might look like this.


transition('* => active', [ animate('2s', keyframes([ style({ backgroundColor: 'blue' }), style({ backgroundColor: 'red' }), style({ backgroundColor: 'orange' }) ]))



Keyframes include an offset that defines the point in the animation where each style change occurs. Offsets are relative measures from zero to one, marking the beginning and end of the animation, respectively.

关键帧包括一个用来定义动画中每个样式何时开始更改的偏移(offset)属性。偏移是个 0 到 1 之间的相对值,分别标记动画的开始和结束时间。

Defining offsets for keyframes is optional. If you omit them, evenly spaced offsets are automatically assigned. For example, three keyframes without predefined offsets receive offsets of 0, 0.5, and 1. Specifying an offset of 0.8 for the middle transition in the above example might look like this.

定义关键帧的偏移量是可选的。如果省略它们,就会自动分配均匀间隔的偏移。例如,三个没有预定义偏移的关键帧会分别使用 0、0.5、1 作为偏移。在上面的例子中,还可以为中间的转场指定偏移量 0.8。代码如下:

keyframes with offset

The code with offsets specified would be as follows.


transition('* => active', [ animate('2s', keyframes([ style({ backgroundColor: 'blue', offset: 0}), style({ backgroundColor: 'red', offset: 0.8}), style({ backgroundColor: 'orange', offset: 1.0}) ])), ]), transition('* => inactive', [ animate('2s', keyframes([ style({ backgroundColor: 'orange', offset: 0}), style({ backgroundColor: 'red', offset: 0.2}), style({ backgroundColor: 'blue', offset: 1.0}) ])) ]),

You can combine keyframes with duration, delay, and easing within a single animation.

你可以在单个动画中组合使用 durationdelayeasing 来定义关键帧。

Keyframes with a pulsation


Use keyframes to create a pulse effect in your animations by defining styles at specific offset throughout the animation.


Here's an example of using keyframes to create a pulse effect:


  • The original open and closed states, with the original changes in height, color, and opacity, occurring over a timeframe of 1 second

    原始的 openclosed 状态会从其原始的高度、颜色和透明度开始,在一秒钟内逐渐发生变化。

  • A keyframes sequence inserted in the middle that causes the button to appear to pulsate irregularly over the course of that same 1-second timeframe


keyframes with irregular pulsation

The code snippet for this animation might look like this.


trigger('openClose', [ state('open', style({ height: '200px', opacity: 1, backgroundColor: 'yellow' })), state('close', style({ height: '100px', opacity: 0.5, backgroundColor: 'green' })), // ... transition('* => *', [ animate('1s', keyframes ( [ style({ opacity: 0.1, offset: 0.1 }), style({ opacity: 0.6, offset: 0.2 }), style({ opacity: 1, offset: 0.5 }), style({ opacity: 0.2, offset: 0.7 }) ])) ]) ])

Animatable properties and units


Angular's animation support builds on top of web animations, so you can animate any property that the browser considers animatable. This includes positions, sizes, transforms, colors, borders, and more. The W3C maintains a list of animatable properties on its CSS Transitions page.

Angular 的动画支持是基于 Web 动画的,所以你可以动浏览器认为可动(animatable)的任意属性。包括位置、大小、变形、颜色、边框等。W3C 在 CSS 转场页也维护了一个可动属性的列表。

For positional properties with a numeric value, define a unit by providing the value as a string, in quotes, with the appropriate suffix:


  • 50 pixels: '50px'

    50 像素:'50px'

  • Relative font size: '3em'


  • Percentage: '100%'


If you don't provide a unit when specifying dimension, Angular assumes a default unit of pixels, or px. Expressing 50 pixels as 50 is the same as saying '50px'.

如果在指定尺寸时未提供单位,则 Angular 将使用默认单位像素(px)。把 50 像素表示为 50'50px' 是一样的。

Automatic property calculation with wildcards


Sometimes you don't know the value of a dimensional style property until runtime. For example, elements often have widths and heights that depend on their content and the screen size. These properties are often challenging to animate using CSS.

有时你在运行之前并不知道某个样式的属性值。比如,元素的宽度和高度通常取决于其内容和屏幕大小。在使用 CSS 动画时,这些属性通常会具有挑战性(译注:因为 CSS 动画不支持自动确定宽高)。

In these cases, you can use a special wildcard * property value under style(), so that the value of that particular style property is computed at runtime and then plugged into the animation.

这种情况下,你可以在 style() 中指定通配符 * 属性,以便在运行期间计算该属性的值,然后把它插入到动画中。

In this example, we have a trigger called shrinkOut, used when an HTML element leaves the page. The animation takes whatever height the element has before it leaves, and animates from that height to zero.

在这个例子中,我们有一个名叫 shrinkOut 的触发器,它会在 HTML 元素离开页面时使用。该动画会使用它离开之前的任意高度,并从该高度动画到 0。

animations: [ trigger('shrinkOut', [ state('in', style({ height: '*' })), transition('* => void', [ style({ height: '*' }), animate(250, style({ height: 0 })) ]) ]) ]

Keyframes summary


The keyframes() function in Angular allows you to specify multiple interim styles within a single transition, with an optional offset to define the point in the animation where each style change occurs.

Angular 中的 keyframes() 函数允许你在单个转场中指定多个临时样式,并使用可选的偏移量来定义动画中每次样式变化的发生时机。

More on Angular animations

Angular 动画的更多知识

You may also be interested in the following: