Flutter页面过渡动画插件flutter_page_transition的使用

Flutter页面过渡动画插件flutter_page_transition的使用

简介

flutter_page_transition 是一个功能丰富、方便易用的 Flutter 页面过渡动画包。它提供了多种预定义的页面过渡效果,能够帮助开发者快速实现复杂的页面切换动画。

Pub 版本 语言 许可证

README 中文版


部分演示

以下是 flutter_page_transition 提供的一些过渡动画效果:

动画类型 效果展示
fadeIn fadeIn
slideInLeft slideInLeft
slideLeft slideLeft
slideParallaxLeft slideParallaxLeft
slideZoomLeft slideZoomLeft
transferRight transferRight
rippleRightUp rippleRightUp

安装

pubspec.yaml 文件中添加依赖:

dependencies:
  flutter_page_transition: ^0.1.0

或者直接从 Git 仓库安装:

flutter_page_transition:
  git:
    url: git://github.com/handoing/flutter_page_transition.git

然后运行以下命令更新依赖:

flutter packages upgrade

过渡类型

flutter_page_transition 提供了多种预定义的过渡类型,以下是部分支持的过渡类型及其方向:

过渡类型 方向
slideInLeft 左侧滑入
slideInRight 右侧滑入
slideInUp 上方滑入
slideInDown 下方滑入
slideLeft 左侧滑动
slideRight 右侧滑动
slideUp 上方滑动
slideDown 下方滑动
slideParallaxLeft 左侧视差滑动
slideZoomLeft 左侧缩放滑动

示例代码

以下是一个完整的示例代码,展示了如何使用 flutter_page_transition 实现页面过渡动画。

import 'package:flutter/material.dart';

import 'package:flutter_page_transition/flutter_page_transition.dart';
import './page/home_page.dart';
import './page/other_page.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Page Transition Demo',
      theme: ThemeData(primarySwatch: Colors.blue),
      initialRoute: HomePage.tag,
      onGenerateRoute: (RouteSettings routeSettings) {
        return PageRouteBuilder<dynamic>(
          settings: routeSettings,
          pageBuilder: (BuildContext context, Animation<double> animation, Animation<double> secondaryAnimation) {
            switch (routeSettings.name) {
              case HomePage.tag:
                return HomePage();
              case OtherPage.tag:
                return OtherPage();
              default:
                return null;
            }
          },
          transitionDuration: const Duration(milliseconds: 600), // 设置过渡时间为 600 毫秒
          transitionsBuilder: (BuildContext context, Animation<double> animation, Animation<double> secondaryAnimation, Widget child) {
            // 使用 slideInLeft 的过渡效果
            return effectMap[PageTransitionType.slideInLeft](Curves.linear, animation, secondaryAnimation, child);
          },
        );
      },
    );
  }
}

自定义过渡效果

如果内置的过渡效果无法满足需求,可以创建自定义的过渡效果。以下是如何创建并应用自定义过渡效果的示例:

import 'package:flutter_page_transition/flutter_page_transition.dart';

void createCustomEffect() {
  transitionEffect.createCustomEffect(
    handle: (Curve curve, Animation<double> animation, Animation<double> secondaryAnimation, Widget child) {
      return SlideTransition(
        position: Tween<Offset>(
          begin: const Offset(1.0, 0.0), // 从右侧开始
          end: const Offset(0.0, 0.0),   // 移动到当前位置
        ).animate(CurvedAnimation(parent: animation, curve: curve)),
        child: child,
      );
    },
  );
}

// 使用自定义过渡效果
effectMap[PageTransitionType.custom](Curves.linear, animation, secondaryAnimation, child);

测试

运行单元测试:

flutter test

运行驱动测试(Driver Test):

cd example/
flutter drive --target=test_driver/app.dart

更多关于Flutter页面过渡动画插件flutter_page_transition的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter页面过渡动画插件flutter_page_transition的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


flutter_page_transition 是一个用于在 Flutter 应用中实现页面过渡动画的插件。它提供了多种内置的过渡效果,如淡入淡出、滑动、缩放等,并且可以自定义过渡动画。以下是如何使用 flutter_page_transition 插件的步骤:

1. 添加依赖

首先,你需要在 pubspec.yaml 文件中添加 flutter_page_transition 插件的依赖:

dependencies:
  flutter:
    sdk: flutter
  flutter_page_transition: ^1.1.7+6

然后运行 flutter pub get 来安装依赖。

2. 导入包

在你的 Dart 文件中导入 flutter_page_transition 包:

import 'package:flutter_page_transition/flutter_page_transition.dart';

3. 使用 PageTransition 组件

PageTransition 是一个包装器组件,用于在页面之间应用过渡动画。你可以通过 PageTransition 组件来包裹你的页面,并指定过渡类型、持续时间等参数。

以下是一个简单的示例,展示了如何在两个页面之间使用滑动过渡动画:

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.push(
              context,
              PageTransition(
                type: PageTransitionType.rightToLeft,
                child: SecondPage(),
              ),
            );
          },
          child: Text('Go to Second Page'),
        ),
      ),
    );
  }
}

class SecondPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Second Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.pop(context);
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}

4. 过渡类型

PageTransitionType 提供了多种内置的过渡类型,例如:

  • rightToLeft: 从右到左滑动
  • leftToRight: 从左到右滑动
  • topToBottom: 从上到下滑动
  • bottomToTop: 从下到上滑动
  • fade: 淡入淡出
  • scale: 缩放
  • rotate: 旋转
  • size: 大小变化

你可以根据需要选择合适的过渡类型。

5. 自定义过渡动画

如果你需要更复杂的过渡动画,可以通过 PageTransitioncurveduration 参数来自定义动画的曲线和持续时间。

PageTransition(
  type: PageTransitionType.rightToLeft,
  child: SecondPage(),
  curve: Curves.easeInOut,
  duration: Duration(milliseconds: 500),
);

6. 其他功能

flutter_page_transition 还支持其他功能,如反向动画、页面堆栈管理等。你可以参考插件的文档和示例来了解更多高级用法。

7. 示例代码

以下是一个完整的示例代码,展示了如何使用 flutter_page_transition 插件实现页面过渡动画:

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.push(
              context,
              PageTransition(
                type: PageTransitionType.rightToLeft,
                child: SecondPage(),
                curve: Curves.easeInOut,
                duration: Duration(milliseconds: 500),
              ),
            );
          },
          child: Text('Go to Second Page'),
        ),
      ),
    );
  }
}

class SecondPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Second Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.pop(context);
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}
回到顶部