搜索插件、代码仓与 APP 分类

插件详情v5.1.0

animate_do

受 Animate.css 启发的精美动画,提供可自定义的基于小部件的动画,无需外部依赖。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
11万
喜欢数
4920
Pub 分数
160

安装插件

flutter pub add animate_do

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Animate_do 是一个 Flutter 包,提供受 Animate.css 启发的视觉上吸引人的基于小部件的动画。它使开发者能够轻松地为 UI 元素应用流畅且可自定义的动画,而无需依赖外部依赖项。凭借简单的 API 和对所有主要平台(包括 Android、iOS、Web、macOS、Windows 和 Linux)的支持,它通过动态过渡提升了用户体验。该包可无缝集成到 Flutter 应用中,为小部件添加引人入胜的动态效果提供了轻量级解决方案。

适合场景

  • 为UI元素添加进入动画
  • 创建交互式按钮反馈
  • 通过动态效果增强启动画面
  • 滚动时动画列表或卡片
  • 改进入职体验

主要特点

  • 受 Animate.css 启发
  • 无外部依赖
  • 完全基于组件
  • 可自定义的动画持续时间和延迟
  • 支持所有 Flutter 平台
  • 易于使用的 API

适合对象

  • Flutter 初学者寻求简单的动画
  • 开发交互式 UI 的开发者
  • 需要引人入胜的引导流程的应用程序
  • 专注于视觉精修的项目
  • 希望轻量级动画解决方案的团队

使用建议

  • 如果过度使用,可能会影响性能
  • 限于预定义的动画类型
  • 不适合复杂的自定义动画
  • 需要仔细调整以获得最佳用户体验
  • 建议谨慎使用,以避免分散注意力

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

animate_do

A Flutter animation package inspired by Animate.css, built with zero external dependencies.

Dart 3 Null Safety Platforms pub.dev

Animate_do demo animation


Getting Started

Every animation widget ships with sensible defaults and is fully customizable. Drop it around any widget and you're done.


Properties

Property Type Description
key Key Optional widget key reference
child Widget Required widget to animate
duration Duration Duration of the animation
delay Duration Delay before the animation starts
from double Initial or final value for more pronounced slide/fade effects
animate bool Toggle false → true to trigger; works with setState, Bloc, Provider, Redux, etc.
infinite bool Loops the animation indefinitely
spins double Number of rotations — applies to Spin, Roulette, SpinPerfect
manualTrigger bool Disables auto-play; requires the controller callback to drive the animation
controller Function Exposes the AnimationController for advanced control
onFinish Function Callback fired when the animation completes; receives an AnimateDoDirection (forward / backward)
curve Curve Custom easing curve

Available Animations

Fade In
FadeIn FadeInDown FadeInDownBig FadeInUp
FadeInUpBig FadeInLeft FadeInLeftBig FadeInRight
FadeInRightBig
Fade Out
FadeOut FadeOutDown FadeOutDownBig FadeOutUp
FadeOutUpBig FadeOutLeft FadeOutLeftBig FadeOutRight
FadeOutRightBig
Bounce In
BounceInDown BounceInUp BounceInLeft BounceInRight
Elastic In
ElasticIn ElasticInDown ElasticInUp ElasticInLeft
ElasticInRight
Slide In
SlideInDown SlideInUp SlideInLeft SlideInRight
Back In / Back Out
BackInDown BackInUp BackInLeft BackInRight
BackOutDown BackOutUp BackOutLeft BackOutRight
Flip In
FlipInX FlipInY
Zoom
ZoomIn ZoomOut
Attention Seekers

All attention seekers support the infinite property to loop indefinitely.

Bounce Dance Flash Pulse
Flip Roulette ShakeX ShakeY
Spin SpinPerfect Swing HeartBeat
Wobble Jello Tada RubberBand
Custom Animations

These widgets let you move widgets around the screen and chain them with any other animation.

MoveTo MoveToArc

Two Syntaxes

Both syntaxes are fully supported. Use whichever feels more natural to you.

Sugar Syntax
Row(
  mainAxisAlignment: MainAxisAlignment.spaceAround,
  children: [
    const Square().fadeInLeft(),
    const Square().fadeInUp(),
    const Square().fadeInDown(),
    const Square().fadeInRight(),
  ],
)
Class Syntax
Row(
  mainAxisAlignment: MainAxisAlignment.spaceAround,
  children: [
    FadeInLeft(child: Square()),
    FadeInUp(child: Square()),
    FadeInDown(child: Square()),
    FadeInRight(child: Square()),
  ],
)

Animation Chaining

Chain multiple animations sequentially using the sugar syntax:

Square()
  .tada()
  .wobble()
  .fadeIn()
Chaining with custom animations
const Square()
  .moveTo(top: 30)
  .moveTo(
    left: 30,
    delay: const Duration(seconds: 1),
  )
  .moveToArc(
    bottom: 30,
    right: 30,
    delay: const Duration(seconds: 2),
  )
  .fadeOut(
    delay: const Duration(seconds: 2),
  )

Triggering Animations

Toggle with animate

Set animate: true to play forward, animate: false to reverse. Works with any state management solution.

Animate_do animate property

FadeIn(animate: animate, child: const Square())
FadeInUp(animate: animate, child: const Square())
FadeInDown(animate: animate, child: const Square())
FadeInLeft(animate: animate, child: const Square())
FadeInRight(animate: animate, child: const Square())

Events — onFinish

The onFinish callback fires when an animation completes, passing an AnimateDoDirection value (forward or backward).

Sugar syntax

const Square().fadeIn(
  animate: animate,
  delay: const Duration(milliseconds: 100),
  onFinish: (direction) => print('$direction'),
),

Class syntax

FadeIn(
  animate: animate,
  delay: const Duration(milliseconds: 100),
  onFinish: (direction) => print('$direction'),
  child: const Square(),
),

Manual Trigger

Use manualTrigger: true together with the controller callback to drive the animation yourself — useful when you need full control over playback.

Note: When using manualTrigger, you are responsible for calling controller.forward() and controller.reverse() explicitly.

class _MyWidgetState extends State<MyWidget> {
  late AnimationController animateController;

  @override
  Widget build(BuildContext context) {
    return FadeInUp(
      manualTrigger: true,
      controller: (controller) => animateController = controller,
      child: YourWidget(),
    );
  }
}

Demos

Animate_do demo

Animate_do demo

Animate_do demo

Animate_do demo

For complete runnable examples, see the example folder.


If you find this package useful, consider leaving a like on pub.dev. Feedback and suggestions are always welcome.

所属分类

源码仓库

使用此插件的项目