パッケージ、リポジトリ、アプリカテゴリを検索

animated_to のカバー
パッケージ詳細v0.9.1

animated_to

AnimateTo は、子要素を新しい位置にアニメーションさせるが、計算は必要ありません。

AndroidiOSWebmacOSWindowsLinux
30日間ダウンロード
2930
いいね数
211
Pub ポイント
160

パッケージをインストール

flutter pub add animated_to

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

AnimatedTo は、アニメーション値を手動で計算する必要なく、ウィジェットを新しい位置にアニメーションさせるのを簡単にするFlutterパッケージです。Flutterのアニメーションシステムを活用して、自動的に遷移を処理するため、UI要素のスムーズで宣言的な移動に最適です。このパッケージは軽量であり、既存のFlutterプロジェクトにシームレスに統合できます。モバイル、Web、デスクトップを含むすべての主要プラットフォームをサポートしており、デバイス間で一貫した動作を保証します。要素が動的に再配置が必要なインタラクティブなインターフェースに最適です。

用途

  • スムーズなUI要素の再配置
  • 動的な動きを伴うインタラクティブレイアウト
  • フォーム内の自動アニメーション遷移
  • レスポンシブデザインの調整
  • スクリーンエレメントのハイライト
  • ドラッグアンドドロップインターフェースの強化

主な機能

  • 手動でのアニメーション計算なし
  • 自動位置補間
  • クロスプラットフォーム互換性
  • シンプルな宣言型 API
  • 組み込みのアニメーションコントローラー管理
  • すべての Flutter プラットフォームをサポートしています

適している対象

  • シンプルなアニメーションを探している開発者
  • モーションを実装するUI/UXデザイナー
  • 動的なレイアウト変更を持つアプリ
  • 視覚フィードバック付きの教育アプリ
  • 迅速なプロトタイピングインタラクション

注意事項

  • アニメーションカーブの制御が限定的
  • 複雑なマルチステップアニメーションには適していません
  • 子ウィジェットをレイアウトコンテキスト内に配置する必要があります
  • 大きなリストで過剰に使用するとパフォーマンスに影響する可能性があります
  • 複雑なシーケンスではなく、単一で集中した動きに最適です

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

animated_to

animated_to provides a widget named AnimatedTo which enables its child widget to change its position with animation when its position is updated for any reason, typically for rebuilding.

AnimatedTo Preview

No calculation is required. Because every calculation is RenderObject's business in the Flutter framework, AnimatedTo just hires the calculated position and starts animation there.

Usage

First, place whatever widget you want to animate when its position changes.

Container(
  width: 60,
  height: 60,
  color: Colors.blue,
)

Then, wrap the widget with AnimatedTo.curve or AnimatedTo.spring passing GlobalKey.

AnimatedTo.curve(
  globalKey: _globalKey,
  child: Container(
    width: 60,
    height: 60,
    color: Colors.blue,
  ),
)

Note that GlobalKey is necessary to keep its RenderObject alive even when the widget's depth or position changes.

And, that's it!

All what you need to do is causing rebuilds using whatever state management packages or just setState and change its position. AnimatedTo will automatically leads the child to the new position with animation.

Spring animation

animated_to provides AnimatedTo.spring which animates its child using SpringSimulation.

https://api.flutter.dev/flutter/physics/SpringSimulation-class.html

This simulates its position transition based on the physical simulation, which make the animations smooth and natural.

What you have to do is just switch AnimatedTo.curve into AnimatedTo.spring to activate spring simulation. You can also configure your own SpringDescription using description argument, or you can use pre-defined configuration using @timcreatedit's motor package.

https://pub.dev/packages/motor

AnimatedTo.spring(
  globalKey: _globalKey,
  // you can retrieve SpringDescription from CupertinoMotion like below
  description: CupertinoMotion.smooth().description,
),

As motor is also used inside animated_to package(thanks @timcreatedit!), make sure you may have potential risk of dependency conflicts when directly depending on the package on your app side.

spring demo

Some more features

appearingFrom lets you specify the start position of the animation in the first frame. By providing an absolute position in the global coordinate system, the widget will appear there and then animate to the original position.

appearingFrom demo

slidingFrom lets you specify the start position of the animation in the first frame as well. By providing a relative position to the child's intrinsic position, the widget will slide from the specified position and then animate to the original position.

slidingFrom demo

Hit Testing and Coordinate System

By default, AnimatedTo widgets can only receive gestures (taps, drags, etc.) at their layout position, not at their animated position. This is because Flutter's hit testing system checks widgets at their natural layout position, even though AnimatedTo visually paints them at a different location during animation.

AnimatedToBoundary

AnimatedToBoundary serves two important purposes:

1. Enable Hit Testing During Animation

To enable gesture detection at the animated position, wrap your widget tree with AnimatedToBoundary. This boundary intercepts hit tests and properly forwards them to animating widgets at their current animated positions.

void main() => runApp(
  AnimatedToBoundary( // Place near root
    child: MaterialApp(
      home: MyHomePage(),
    ),
  ),
);

AnimatedToBoundary is optional. If you don't need to detect gestures on your AnimatedTo widgets during animation, you can omit it completely. The animations will work perfectly fine without it.

2. Establish Stable Coordinate Origin

AnimatedToBoundary can be used to prevent AnimatedTo from unexpected behavior by clarifying the "origin" of the coordinate system. By wrapping a page widget (typically Scaffold) with AnimatedToBoundary, AnimatedTo is not affected by animations of the whole screen, such as Navigator.push().

Without this isolation, when you navigate to a new page, the entire screen slides (the navigation transition), and AnimatedTo would incorrectly interpret this screen movement as a position change. This causes unexpected animations when you want to start an animation during the navigation transition.

By establishing a coordinate boundary, AnimatedToBoundary ensures that AnimatedTo only responds to position changes within that boundary, ignoring ancestor animations like page transitions.

@override
Widget build(BuildContext context) {
  return AnimatedToBoundary(
    child: Scaffold(
      body: AnimatedTo.spring(
        globalKey: _key,
        slidingFrom: Offset(100, 100),
        child: _YourWidget(),
      ),
    ),
  )
}
Placement and Nesting

AnimatedToBoundary should be placed:

  • Near the root of your widget tree for global hit testing coverage
  • Around individual page widgets to isolate navigation transition effects

Note that AnimatedToBoundary can be nested, so you don't have to remove other AnimatedToBoundary widgets you placed at the root when adding a new one around a page.

Limitations

  • AnimatedTo doesn't work when it is on Sliver-related widgets, such as ListView, and the animation happens across slivers. It is because RenderSliver's layout system is totally different from RenderBox's and there is no way to detect the exact from/to. If the animation happened inside a single sliver, it works.

animation inside sliver

All arguments

Argument Type Description
globalKey GlobalKey A key to keep the widget alive even when its depth or position changes.
child Widget The widget you want to animate when its position changes.
duration Duration (curve only) The duration of the animation.
curve Curve (curve only) The curve of the animation.
description SpringDescription (spring only) The configuration of the spring simulation.
velocityBuilder Offset Function()? (spring only) A function to provide initial velocity to start spring animation.
verticalController AnimationController? Required if AnimatedTo is on the subtree of vertical SingleChildScrollView. Share the controller with the SingleChildScrollView to properly animate the widget. Don't provide one when AnimatedTo is on ListView.
horizontalController AnimationController? Required if AnimatedTo is on the subtree of horizontal SingleChildScrollView. Share the controller with the SingleChildScrollView to properly animate the widget. Don't provide one when AnimatedTo is on ListView.
appearingFrom` Offset? The start position of the animation in the first frame. This offset is an absolute position in the global coordinate system.
slidingFrom Offset? The start position of the animation in the first frame. This offset is a relative position to the child's intrinsic position.
enabled bool Whether the animation is enabled.
onEnd void Function(AnimationEndCause cause)? The callback when the animation is completed. cause shows the reason why the animation is completed.
sizeWidget Widget A widget for calculating desired size and position regardless of animations.

See example for more details.

Author's X account @tsuyoshi_chujo also posts some example screenshots.

Contact

If you have anything you want to inform me (@chooyan-eng), such as suggestions to enhance this package or functionalities you want etc, feel free to make issues on GitHub or send messages on X @tsuyoshi_chujo (Japanese @chooyan_i18n).

カテゴリー

依存関係

依存関係一覧 1 件

ソースリポジトリ

このパッケージを使用しているプロジェクト

データはまだありません。