Angular LAB：动画列表并使用 AnimationBuilder 实现命令式动画-js教程-PHP中文网

Angular LAB: animating lists and using AnimationBuilder for imperative animations

您知道 Angular 包含一个复杂的动画系统吗？当我想要在元素进入屏幕或被破坏时为其设置动画时，我发现它特别有用！

此外，您还可以使用 AnimationBuilder 来强制播放、暂停或停止一些自定义动画！让我们看看它是如何完成的。

创建列表

在本练习中，我们首先创建一个列表，如下所示：

@Component({
  selector: 'app-root',
  standalone: true,
  template: `
    <button (click)="addUser()">Add user</button>
    <ul>
    @for (user of users(); track user.id) {
      <li>{{ user.name }}</li>
    }
    </ul>
  `,
})
export class AppComponent {
  users = signal<User[]>([
    { id: Math.random(), name: 'Michele' }
  ]);

  addUser() {
    this.users.update(users => [...users, { id: Math.random(), name: 'New user' }]);
  }
}

登录后复制

请注意，我们添加了一个将用户添加到列表中的按钮！

动画列表

现在，如果我们想要为要添加的新用户设置动画该怎么办？首先，我们想通过在主配置中提供它来告诉 Angular 我们想要使用它的动画系统：

import { provideAnimationsAsync } from '@angular/platform-browser/animations/async';

bootstrapApplication(AppComponent, {
  providers: [
    provideAnimationsAsync(),
  ]
});

登录后复制

然后，我们可以创建我们的动画：

import { trigger, transition, style, animate } from '@angular/animations';

const fadeInAnimation = trigger('fadeIn', [
  transition(':enter', [
    style({ transform: 'scale(0.5)', opacity: 0 }),
    animate(
      '.3s cubic-bezier(.8, -0.6, 0.2, 1.5)', 
      style({ transform: 'scale(1)', opacity: 1 })
    )
  ])
])

登录后复制

有了这些帮助者，我们：

创建了一个名为 fadeIn 的动画触发器
添加了元素进入屏幕时的过渡
应用了初始样式
立即开始动画，这将导致新的样式应用于元素

更多关于如何编写动画的信息，可以参考官方指南，非常棒！

现在让我们将此动画应用到列表中的每个元素：

@Component({
  ...,
  template: `
    <button (click)="addUser()">Add user</button>
    <ul>
    @for (user of users(); track user.id) {
      <li @fadeIn>{{ user.name }}</li> <!-- Notice here -->
    }
    </ul>
  `,
  // Also, add the animation to the metadata of the component
  animations: [fadeInAnimation]
})

登录后复制

现在，当添加新项目时，它会变得动画！我们的第一步已经完成。

请注意，为了让我们的动画正常工作，Angular 必须跟踪 for 中的每个元素，因为否则它最终可能会在更新模板时重新创建相同的元素，从而导致不必要的结果动画。这是免费的新控制流语法，因为 track 属性是强制性的，但如果您使用旧版本的 Angular 和 *ngFor 指令，则必须使用 trackBy 选项，如下所示：

<li
  *ngFor="let user of users; trackBy: trackByUserId"
  @fadeIn
>{{ user.name }}</li>

登录后复制

// A class method in your component:
trackByUserId(index, user: User) {
  return user.id;
}

登录后复制

现在，让我们向列表中添加另一种类型的动画。

动画生成器

让我们为列表的每个元素添加一个按钮：

<li @fadeIn>
  {{ user.name }}
  <button>Make me blink</button>
</li>

登录后复制

想象一下：我们想让元素在按下按钮时闪烁。那就太酷了！这就是 AnimationBuilder 服务的用武之地。

首先，让我们创建一个将应用于每个元素的指令。在此指令中，我们将注入 ElementRef 和 AnimationBuilder：

import { AnimationBuilder, style, animate } from '@angular/animations';

@Directive({
  selector: '[blink]',
  exportAs: 'blink', // <--- Notice
  standalone: true
})
export class BlinkDirective {

  private animationBuilder = inject(AnimationBuilder);
  private el = inject(ElementRef);
}

登录后复制

请注意，我们导出了指令：我们将在几秒钟内找到原因。

然后，我们可以创建一个像这样的自定义动画：

export class BlinkDirective {

  ...

  private animation = this.animationBuilder.build([
    style({ transform: 'scale(1)', opacity: 1 }),
    animate(150, style({ transform: 'scale(1.1)', opacity: .5 })),
    animate(150, style({ transform: 'scale(1)', opacity: 1 }))
  ]);
}

登录后复制

我们使用的函数与之前的动画中使用的函数相同，只是样式不同。

现在我们要创建一个播放器，它将在我们的元素上执行动画：

export class BlinkDirective {

  ...

  private player = this.animation.create(this.el.nativeElement);
}

登录后复制

现在让我们公开一个真正启动动画的方法！

export class BlinkDirective {

  ...

  start() {
    this.player.play();
  }
}

登录后复制

只剩下一步了：我们必须导入指令，将其应用到我们的元素，使用模板变量获取它，并在按下按钮时调用该方法！

@Component({
  selector: 'app-root',
  standalone: true,
  template: `
    <button (click)="addUser()">Add user</button>
    <ul>
    @for (user of users(); track user.id) {
      <li @fadeIn blink #blinkDir="blink">
        {{ user.name }}
        <button (click)="blinkDir.start()">Make me blink</button>
      </li>
    }
    </ul>
  `,
  imports: [BlinkDirective],
  animations: [
    fadeInAnimation
  ]
})

登录后复制

我们可以获取指令的实例并将其放入局部变量中，因为我们之前使用exportAs导出了指令。这就是关键部分！

现在，尝试单击按钮：该元素应该正确动画！

练习已经完成，但这只是冰山一角！ AnimationPlayer 有很多命令可用于停止、暂停和恢复动画。非常酷！

interface AnimationPlayer {
  onDone(fn: () => void): void;
  onStart(fn: () => void): void;
  onDestroy(fn: () => void): void;
  init(): void;
  hasStarted(): boolean;
  play(): void;
  pause(): void;
  restart(): void;
  finish(): void;
  destroy(): void;
  reset(): void;
  setPosition(position: number): void;
  getPosition(): number;
  parentPlayer: AnimationPlayer;
  readonly totalTime: number;
  beforeDestroy?: () => any;
}

登录后复制

如果您想使用它，这是我们的完整示例：只需将其放入 main.ts 文件中并查看它的实际效果！

import { Component, signal, Directive, ElementRef, inject } from '@angular/core';
import { bootstrapApplication } from '@angular/platform-browser';
import { trigger, transition, style, animate, AnimationBuilder } from '@angular/animations';
import { provideAnimationsAsync } from '@angular/platform-browser/animations/async';

interface User {
  id: number;
  name: string;
}

@Directive({
  selector: '[blink]',
  exportAs: 'blink',
  standalone: true
})
export class BlinkDirective {

  private animationBuilder = inject(AnimationBuilder);
  private el = inject(ElementRef);

  private animation = this.animationBuilder.build([
    style({ transform: 'scale(1)', opacity: 1 }),
    animate(150, style({ transform: 'scale(1.1)', opacity: .5 })),
    animate(150, style({ transform: 'scale(1)', opacity: 1 }))
  ]);

  private player = this.animation.create(this.el.nativeElement);

  start() {
    this.player.play();
  }
}

const fadeInAnimation = trigger('fadeIn', [
  transition(':enter', [
    style({ transform: 'scale(0.5)', opacity: 0 }),
    animate(
      '.3s cubic-bezier(.8, -0.6, 0.2, 1.5)', 
      style({ transform: 'scale(1)', opacity: 1 })
    )
  ])
])

@Component({
  selector: 'app-root',
  standalone: true,
  template: `
    <button (click)="addUser()">Add user</button>
    <ul>
    @for (user of users(); track user.id) {
      <li @fadeIn blink #blinkDir="blink">
        {{ user.name }}
        <button (click)="blinkDir.start()">Make me blink</button>
      </li>
    }
    </ul>
  `,
  imports: [BlinkDirective],
  animations: [
    fadeInAnimation
  ]
})
export class App {
  users = signal([
    { id: Math.random(), name: 'Michele' }
  ]);

  addUser() {
    this.users.update(users => [...users, { id: Math.random(), name: 'New user' }]);
  }
}

bootstrapApplication(App, {
  providers: [
    provideAnimationsAsync()
  ]
});

登录后复制

以上是Angular LAB：动画列表并使用 AnimationBuilder 实现命令式动画的详细内容。更多信息请关注PHP中文网其他相关文章！