Flutter动画切换插件animated_switcher_transitions的使用

插件简介

animated_switcher_transitions 是一个为 AnimatedSwitcher 提供预构建布局和过渡效果的插件。这些过渡效果定义了在 AnimatedSwitcher 内部切换小部件时的动画效果，提供了多种视觉效果以增强用户体验，使小部件之间的切换更加生动有趣。

使用方法

要使用 animated_switcher_transitions 插件，首先需要在 pubspec.yaml 文件中添加依赖：

dependencies:
  animated_switcher_transitions: ^latest_version

然后，在 Dart 代码中导入插件：

import 'package:animated_switcher_transitions/animated_switcher_transitions.dart';

接下来，可以通过以下方式使用 AnimatedSwitcher 和 animated_switcher_transitions 提供的过渡效果：

完整示例 Demo

以下是一个完整的示例，展示了如何使用 animated_switcher_transitions 插件来创建带有不同过渡效果的 AnimatedSwitcher：

import 'package:flutter/material.dart';
import 'package:animated_switcher_transitions/animated_switcher_transitions.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Animated Switcher Transitions Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: false,
      ),
      home: const MyHomePage(title: 'Animated Switcher Transitions Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.primary,
        title: Text(widget.title),
      ),
      body: Padding(
        padding: const EdgeInsets.all(20.0),
        child: Center(
          child: SizedBox(
            width: 200,
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: <Widget>[
                // 第一组过渡效果
                GridView.count(
                  shrinkWrap: true,
                  crossAxisCount: 3,
                  children: [
                    Wrapper(_counter), // 默认淡入淡出效果
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.flipX, // 水平翻转
                      layout: AnimatedSwitcherLayouts.inOut,
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.flipY, // 垂直翻转
                      layout: AnimatedSwitcherLayouts.inOut,
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.rotate(), // 旋转
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.rotate(clockwise: false), // 反向旋转
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.shakeX, // 水平摇晃
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.shake(direction: Axis.vertical), // 垂直摇晃
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.zoomIn, // 放大进入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.zoomOut, // 缩小退出
                    ),
                  ],
                ),
                const SizedBox(height: 40),
                // 第二组过渡效果
                GridView.count(
                  shrinkWrap: true,
                  crossAxisCount: 3,
                  children: [
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideTopLeft, // 左上滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideTop, // 顶部滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideTopRight, // 右上滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideLeft, // 左侧滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.fade, // 淡入淡出
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideRight, // 右侧滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideBottomLeft, // 左下滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideBottom, // 底部滑入
                    ),
                    Wrapper(
                      _counter,
                      transition: AnimatedSwitcherTransitions.slideBottomRight, // 右下滑入
                    ),
                  ],
                )
              ],
            ),
          ),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

class Wrapper extends StatelessWidget {
  const Wrapper(
    this.counter, {
    super.key,
    this.transition = AnimatedSwitcherTransitions.fade, // 默认淡入淡出
    this.layout = AnimatedSwitcherLayouts.outIn, // 默认先移除旧小部件再添加新小部件
  });

  final int counter;
  final AnimatedSwitcherTransitionBuilder transition;
  final AnimatedSwitcherLayoutBuilder layout;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return AnimatedSwitcher(
      duration: const Duration(milliseconds: 500), // 动画持续时间
      switchInCurve: Curves.linear, // 进入动画曲线
      switchOutCurve: Curves.linear, // 退出动画曲线
      transitionBuilder: transition, // 自定义过渡效果
      layoutBuilder: layout, // 自定义布局效果
      child: PhysicalShape(
        key: ValueKey(counter), // 使用 counter 作为唯一标识
        elevation: 2, // 阴影高度
        color: Colors.red, // 背景颜色
        clipper: const ShapeBorderClipper(shape: CircleBorder()), // 圆形剪裁
        child: Padding(
          padding: const EdgeInsets.all(10.0),
          child: Text(
            '$counter', // 显示计数
            style: Theme.of(context).textTheme.titleLarge?.copyWith(
                  color: Colors.white, // 文字颜色
                  height: 1.15, // 行高
                ),
          ),
        ),
      ),
    );
  }
}