Flutter iOS返回过渡动画插件ios_willpop_transition_theme的使用

发布于 1周前 作者 eggper 来自 Flutter

Flutter iOS返回过渡动画插件 ios_willpop_transition_theme 的使用

ios_willpop_transition_theme 是一个用于解决 iOS 滑动返回与 WillPopScope 冲突的 Flutter 插件。本文将介绍如何全局或局部应用此插件,并提供完整的示例代码。

相关资源

全局效果设置

通过覆盖 MaterialApppageTransitionsTheme 属性来实现全局效果:

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Example',
      theme: ThemeData(
        pageTransitionsTheme: const PageTransitionsTheme(
          builders: {
            TargetPlatform.iOS: IOSWillPopTransitionsBuilder(),
            TargetPlatform.android: IOSWillPopTransitionsBuilder(),
            TargetPlatform.macOS: IOSWillPopTransitionsBuilder(),
          },
        ),
        primarySwatch: Colors.blue,
      ),
      home: const Home(),
    );
  }
}

局部效果设置

对于特定页面,可以使用 WillPopPageRoute 来应用局部效果:

Navigator.of(context).push(WillPopPageRoute(
   builder: (_) => const TestPage(),
));

示例 Demo

以下是一个完整的示例 demo,展示了如何在应用中集成 ios_willpop_transition_theme

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Example',
      theme: ThemeData(
        pageTransitionsTheme: const PageTransitionsTheme(
          builders: {
            TargetPlatform.iOS: IOSWillPopTransitionsBuilder(),
            TargetPlatform.android: IOSWillPopTransitionsBuilder(),
            TargetPlatform.macOS: IOSWillPopTransitionsBuilder(),
          },
        ),
        primarySwatch: Colors.blue,
      ),
      home: const Home(),
    );
  }
}

class Home extends StatelessWidget {
  const Home({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Example')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).push(WillPopPageRoute(
                  builder: (_) => const TestPage(),
                ));
              },
              child: const Text('Push will pop dialog'),
            ),
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).push(MaterialPageRoute(
                  builder: (_) => const TestPage(returnTrue: true),
                ));
              },
              child: const Text('Push will pop return true'),
            ),
          ],
        ),
      ),
    );
  }
}

class TestPage extends StatefulWidget {
  const TestPage({Key? key, this.returnTrue = false}) : super(key: key);

  final bool returnTrue;

  @override
  State<TestPage> createState() => _TestPageState();
}

class _TestPageState extends State<TestPage> {
  @override
  Widget build(BuildContext context) {
    return WillPopScope(
      onWillPop: () async {
        if (widget.returnTrue) return true;

        final bool? result = await showDialog(
          context: context,
          builder: (_) => Center(
            widthFactor: 1,
            child: Container(
              color: Colors.white,
              padding: const EdgeInsets.all(10),
              child: Row(
                mainAxisSize: MainAxisSize.min,
                children: <bool>[false, true]
                    .map((value) => TextButton(
                          onPressed: () => Navigator.pop(context, value),
                          child: Text(value.toString()),
                        ))
                    .toList(),
              ),
            ),
          ),
        );

        return result == true;
      },
      child: Scaffold(
        appBar: AppBar(title: const Text('TestPage')),
        body: const Center(child: Text('TestPage')),
      ),
    );
  }
}

通过上述步骤和示例代码,您可以轻松地在您的 Flutter 应用中集成 ios_willpop_transition_theme 插件,以实现更自然的 iOS 返回过渡动画。


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

1 回复

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


当然,下面是一个关于如何在Flutter中使用ios_willpop_transition_theme插件来实现iOS风格的返回过渡动画的示例代码。这个插件允许你在用户点击iOS设备上的返回按钮时,自定义返回的过渡动画。

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

dependencies:
  flutter:
    sdk: flutter
  ios_willpop_transition_theme: ^latest_version # 请替换为最新版本号

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

接下来,在你的Flutter应用中,你可以使用以下代码来实现自定义的返回过渡动画:

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
      navigatorObservers: [
        // 使用自定义的 WillPopScopeObserver 来处理返回事件
        WillPopScopeObserver(
          onWillPop: (Route<dynamic> route, WillPopScopeFuture future) async {
            // 这里可以添加你的自定义逻辑,比如显示一个Snackbar
            // 这里我们直接返回 true 来允许返回操作
            return true;
          },
        ),
      ],
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return WillPopScope(
      onWillPop: () async => true, // 这里也需要处理返回事件,但实际逻辑在上面的 observer 中
      child: IosWillPopTransitionTheme(
        data: IosWillPopTransitionThemeData(
          // 自定义过渡动画的曲线和持续时间
          transitionCurve: Curves.easeInOut,
          transitionDuration: Duration(milliseconds: 300),
          // 自定义背景颜色和透明度
          backgroundColor: Colors.black.withOpacity(0.5),
          screenOpacity: 0.5,
        ),
        child: Scaffold(
          appBar: AppBar(
            title: Text('Flutter Demo Home Page'),
          ),
          body: Center(
            child: ElevatedButton(
              onPressed: () {
                Navigator.push(
                  context,
                  MaterialPageRoute(builder: (context) => SecondPage()),
                );
              },
              child: Text('Go to Second Page'),
            ),
          ),
        ),
      ),
    );
  }
}

class SecondPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Second Page'),
      ),
      body: Center(
        child: Text('This is the second page'),
      ),
    );
  }
}

// 自定义的 WillPopScopeObserver 类,用于处理返回事件
class WillPopScopeObserver extends NavigatorObserver {
  final Future<bool> Function(Route<dynamic>, WillPopScopeFuture) onWillPop;

  WillPopScopeObserver({required this.onWillPop});

  @override
  void didPop(Route<dynamic> route, Route<dynamic>? previousRoute) {
    // 这里可以添加你的逻辑,当路由已经弹出时执行
  }

  @override
  Future<bool> didStartUserGesture(Route<dynamic> route, Route<dynamic>? previousRoute) async {
    // 当用户开始返回手势时调用
    if (onWillPop != null) {
      final future = onWillPop!(route, WillPopScopeFuture());
      if (future != null) {
        return await future;
      }
    }
    return true;
  }
}

// 一个简单的 WillPopScopeFuture 类,用于模拟 WillPopScope 的 Future
class WillPopScopeFuture implements Future<bool> {
  @override
  bool get isCompleted => false;

  @override
  CompletionState get completion => CompletionState.pending;

  @override
  Future<R> then<R, E>(
    FutureOr<R> Function(bool) onValue, {
    Function? onError,
    Function? onDone,
  }) {
    // 这里不实现实际的 then 逻辑,因为我们只是模拟
    throw UnimplementedError();
  }

  @override
  Future<R> then<R>(FutureOr<R> Function(bool) onValue, {Function? onError}) {
    // 同上
    throw UnimplementedError();
  }

  @override
  Future<void> catchError(Function onError, {Function? onDone}) {
    // 同上
    throw UnimplementedError();
  }

  @override
  Future<T> asFuture<T>() {
    // 同上
    throw UnimplementedError();
  }

  @override
  bool get isError => false;

  @override
  bool get hasError => false;

  @override
  Object? get error => null;

  @override
  StackTrace? get stackTrace => null;

  @override
  Future<bool> whenComplete(FutureOr<void> Function() onComplete) {
    // 同上
    throw UnimplementedError();
  }

  @override
  Future<bool> timeout(Duration timeLimit, {FutureOr<bool> Function(TimeoutException) onTimeout}) {
    // 同上
    throw UnimplementedError();
  }

  @override
  Type get runtimeType => Future<bool>.runtimeType;
}

注意

  1. ios_willpop_transition_theme 插件的最新版本和具体用法可能有所不同,请参考其官方文档和示例代码进行调整。
  2. 在上面的代码中,WillPopScopeObserver 类和 WillPopScopeFuture 类是用于演示目的,实际使用中可能不需要这样的自定义实现。ios_willpop_transition_theme 插件可能已经处理了相关的返回事件和动画。
  3. 上面的代码示例中,onWillPop 回调在两个地方被调用,但实际上你只需要在一个地方处理返回逻辑即可。这里的示例是为了展示如何在 NavigatorObserversWillPopScope 中处理返回事件。在实际应用中,你可以根据自己的需求选择其中一种方式。

希望这个示例代码能够帮助你理解如何在Flutter中使用ios_willpop_transition_theme插件来实现iOS风格的返回过渡动画。

回到顶部