【Flutter 专题】57 图解页面小跳转 (三)

      小菜在去年刚接触 Flutter 时学习了一下页面跳转路由的基本用法，随着逐渐的学习和场景的使用，对一些特殊场景下路由使用进行尝试；

Pop / Push

pushReplacementNamed / pushReplacement

      pushReplacementNamed / pushReplacement 可以将新的页面替换掉旧的页面，旧的页面被销毁；

      如 A -> B -> C 在 B 页面采用 pushReplacementNamed / pushReplacement 方式到 C 时，B 被 C 所替换，由 C 返回页面时直接到 A，其中 B 在替换时被销毁；使用场景可用于 SplashActivity -> MainActivity;

@optionalTypeArgs
Future<T> pushReplacement <T extends Object, TO extends Object>(
    BuildContext context,   // 上下文环境
    Route<T> newRoute,      // 预跳转页
    { TO result }           // 设置返回信息
)

FlatButton(
    color: Colors.green,
    child: btnText('PushReplacementNamed -> ForthPage'),
    onPressed: () {
      Navigator.pushReplacementNamed(context, 'forthPage',
          result: '{result: pushReplacementNamed}');
    }),
FlatButton(
    color: Colors.greenAccent,
    child: btnText('PushReplacement -> ForthPage'),
    onPressed: () {
      Navigator.pushReplacement(context,
          MaterialPageRoute(builder: (BuildContext context) {
        return ForthPage();
      }), result: '{result: pushReplacement}');
    }),

popAndPushNamed

      popAndPushNamed 可以将本页面销毁并打开新的页面，旧的页面会被销毁；

      如 A -> B -> C 在 B 页面采用 popAndPushNamed 方式到 C 时，B 优先销毁，再打开 C；

@optionalTypeArgs
Future<T> pushReplacement <T extends Object, TO extends Object>(
    BuildContext context,           // 上下文环境
    Route<T> newRoute,              // 预跳转页
    { TO result, Object arguments } // 设置返回信息和参数
)

FlatButton(
    color: Colors.redAccent,
    child: btnText('PopAndPushNamed -> ForthPage'),
    onPressed: () {
      Navigator.popAndPushNamed(context, 'forthPage',
          result: '{result: popAndPushNamed}');
    }),

对比一：

      小菜为了区分测试，在 SecondPage -> ThirdPage 时设置了左进左出的路由动效；在 ThirdPage -> ForthPage 时设置了右进右出的路由动效；

      上述两种方式的区别是：pushReplacementNamed / pushReplacement 直接打开 ForthPage 不会展示 ThirdPage 退出的动画效果；而 popAndPushNamed 会展示 ThirdPage 退出的动画效果；

pushNamedAndRemoveUntil / pushAndRemoveUntil

      采用 pushNamedAndRemoveUntil/pushAndRemoveUntil 时，若 predicate 为 false 可以到达预展示页面，并销毁栈内其他所有页面；若为 true 则跟普通开启新的页面无异；

      如 A -> B -> C 在 C 页面采用 pushNamedAndRemoveUntil / pushAndRemoveUntil 方式启动新页面 D，则优先启动 D 并将 C -> B -> A 全部销毁；

      如 A -> B -> C -> D 在 D 页面采用 pushNamedAndRemoveUntil / pushAndRemoveUntil 方式到达 B，则优先启动新页面 B 并将栈中已存在的 D -> C -> B -> A 全部销毁；

@optionalTypeArgs
Future < T > pushNamedAndRemoveUntil < T extends Object >（
    BuildContext context，          // 上下文环境
    String newRouteName，           // 预跳转页
    RoutePredicate predicate，{     // 页面状态
        Object arguments
    }
）

FlatButton(
    color: Colors.teal,
    child: btnText('PushAndRemoveUntil -> SecondPage/false'),
    onPressed: () {
      Navigator.pushAndRemoveUntil(context,
          MaterialPageRoute(builder: (BuildContext context) {
        return SecondPage();
      }), (route) => false);
    }),
FlatButton(
    color: Colors.pinkAccent,
    child: btnText('PushAndRemoveUntil -> SecondPage/true'),
    onPressed: () {
      Navigator.pushNamedAndRemoveUntil(context, 'secondPage', (route) => true);
    }),

popUntil

      采用 popUntil 时，若预到达页面已在页面栈中，则从自身开始逐个销毁预到达页面的上级栈页面；很像 Android 中 SingleTask 栈内复用模式；若预到达页面不在页面栈中，则不可用该方法，普通 Push 方法即可；

      如 A -> B -> C -> D 在 D 页面采用 popUntil 方式到达 A 时，则 D -> C -> B 按顺序销毁并到达 A；

void popUntil （
    BuildContext context,       // 上下文环境
    RoutePredicate predicate    // 预跳转页
）

      使用 popUntil 时不可传递返回值，对于返回首页 firsPage 时不可用 ModalRoute.withName(‘firstPage’) 小菜整理了其他几种方式获取根目录首页路径；

// 跳转 SecondPage
FlatButton(
    color: Colors.teal,
    child: btnText('PopUntil To -> SecondPage'),
    onPressed: () {
      Navigator.popUntil(context, ModalRoute.withName('secondPage'));
    }),
    
// 跳转首页 FirstPage
FlatButton(
    color: Colors.orange,
    child: btnText('PopUntil To -> FirstPage'),
    onPressed: () {
      Navigator.popUntil(context, ModalRoute.withName(Navigator.defaultRouteName));
//    Navigator.popUntil(context, (route) => route.isFirst);
//    Navigator.popUntil(context, ModalRoute.withName('/'));
    }),

对比二：

      上述两种方式的区别是：pushNamedAndRemoveUntil / pushAndRemoveUntil 方式不管栈中是否存在，均会启动新的页面并清空原来的栈；而 popUntil 只是在回退到栈中所存在的页面，及循环 pop() 直到所展示页面；

仿 popUntil 传参

      popUntil 方式是不支持 result 内容回调的，但在日常开发中会有很多情况需要传递 result；小菜尝试了如下两种方式；

尝试一：

      小菜分析 popUntil 源码，确实是在循环执行 pop() 方法，且没有 result 方法，小菜验证了各页面 then 中接收到 null；

void popUntil(RoutePredicate predicate) {
   while (!predicate(_history.last))
      pop();
}

      这样我们可以用最直接的方法手动调用 pop(result) 传递一个状态码，在各页面的 then 方法中接收判断，再调用 pop(result) 等直到目标页面；小菜认为这种方式的优点是实现简单，思路清晰；缺点是每个页面均需要接收回调判断；

      小菜查询网上 nguyentuanhung 自定义的 flutter_popuntil 也是同样的实现方法；

// 定义一个 Result
class PopWithResults<T> {
  /// poped from this page
  final String fromPage;
  /// pop until this page
  final String toPage;
  /// results
  final Map<String, T> results;
  /// constructor
  PopWithResults({@required this.fromPage, @required this.toPage, this.results});
}
// 调用传参
class Page4 extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold( body: Center(
            child: RaisedButton( child: Text("back to page 2"),
                onPressed: () {
                  Navigator.of(context).pop(PopWithResults(
                      fromPage: 'page4', toPage: 'page2',
                      results: {"pop_result": "this is the pop's result"}));
                })));}
}
class Page3 extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold( body: Center( child: RaisedButton(
                child: Text("to page 4"),
                onPressed: () {
                  Navigator.of(context).pushNamed('page4').then((results) {
                    if (results is PopWithResults) {
                      PopWithResults popResult = results;
                      if (popResult.toPage == 'page3') {
                        // TODO do stuff
                      } else {
                        Navigator.of(context).pop(results);
                      }
                    }
                  });
                })));}
}
class Page2 extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold( body: Center( child: RaisedButton(
                child: Text("to page 3"),
                onPressed: () {
                  Navigator.of(context).pushNamed('page3').then((results) {
                    if (results is PopWithResults) {
                      PopWithResults popResult = results;
                      if (popResult.toPage == 'page2') {
                        print('结果是--->${popResult.results.values.toList()[0]}');
                      }}
                  });
                })));}
}

尝试二：

      上述方法简单有效，但对于很复杂的流程可能略显复杂；小菜举一个极端的例子，连续启动 10 个页面，若用上述方式，则需要在 10 个页面上进行 then 判断处理；

      小菜尝试了第二种方法，借助状态管理 Provider，在调用 popUntil 时给一个 Provider 赋值，在到达目的页面时获取 Provider 内容；有需要可以参考和整理的 Provider 基本用法；

class PopResult with ChangeNotifier {
  String _from = '', _result = '';
  
  String get from => _from;
  String get result => _result;

  void setFrom(from) {
    _from = from;
    notifyListeners();
  }

  void setResult(res) {
    _result = res;
    notifyListeners();
  }
}
class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MultiProvider(
        providers: [ ChangeNotifierProvider(builder: (_) => PopResult()) ],
        child: Consumer<PopResult>(builder: (context, counter, _) {
          return MaterialApp(
              home: FirstPage(),
              routes: {
                'firstPage': (BuildContext context) => FirstPage(),  'secondPage': (BuildContext context) => SecondPage(),
                'thirdPage': (BuildContext context) => ThirdPage(),  'forthPage': (BuildContext context) => ForthPage() });
        }));}
}
class FirstPage extends StatefulWidget {
  @override
  _FirstPageState createState() => new _FirstPageState();
}
class _FirstPageState extends State<FirstPage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
        body: Center( child: Column(mainAxisSize: MainAxisSize.min, children: <Widget>[
          FlatButton(
              color: Colors.pinkAccent,
              child: btnText('Push To -> SecondPage'),
              onPressed: () {
                Navigator.pushNamed(context, "secondPage").then((val) {
                  print('FirstPage-->$val');
                  if (Provider.of<PopResult>(context).from == 'forthPage') {
                    print('FirstPage.from---->${Provider.of<PopResult>(context).from}');
                    print('FirstPage.result---->${Provider.of<PopResult>(context).result}');
                    // 将来源置空，防止影响其他返回逻辑
                    Provider.of<PopResult>(context).setFrom('');
                  }
                });
              })
        ]))}
}
class ForthPage extends StatefulWidget {
  @override
  _ForthPageState createState() => new _ForthPageState();
}
class _ForthPageState extends State<ForthPage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
        body: Center( child: Column(mainAxisSize: MainAxisSize.min, children: <Widget>[
          FlatButton(
              color: Colors.blueAccent,
              child: btnText('PopUntil Provider -> FirstPage With Result'),
              onPressed: () {
                Provider.of<PopResult>(context, listen: false)..setFrom('forthPage')..setResult('I am from ForthPage');
                Navigator.popUntil(context, ModalRoute.withName('/'));
              })])));}
}

路由动效

      小菜实现一个简单的对话框：由底部弹出且透明度由 0.0 到 1.0；但小菜在测试时 barrierColor 进入时在对话框展示完成后展示，在退出时逐渐消失；仍有待研究；

FlatButton(
    color: Colors.green,
    child: Text('ShowDialog'),
    onPressed: () {
      Navigator.of(context).push(PageRouteBuilder(
          opaque: false,
          barrierDismissible: false,
          barrierColor: Colors.black12.withOpacity(0.5),
          maintainState: false,
          transitionDuration: const Duration(milliseconds: 1000),
          transitionsBuilder: (context, animation, secondaryAnimation, child) {
            return SlideTransition(
                position: Tween<Offset>(begin: Offset(0.0, 1.0), end: Offset(0.0, 0.0))
                    .animate(CurvedAnimation(
                        parent: animation, curve: Curves.fastOutSlowIn)),
                child: FadeTransition(
                    opacity: Tween(begin: 0.0, end: 1.0).animate(
                        CurvedAnimation(parent: animation, curve: Curves.linear)),
                    child: child));
          },
          pageBuilder: (context, animation, secondaryAnimation) {
            return Center(
                child: Container(
                    height: 200.0, width: 200.0,
                    decoration: BoxDecoration(color: Colors.greenAccent, borderRadius: BorderRadius.circular(5.0)),
                    child: Icon(Icons.ac_unit, color: Colors.white)));
          }));
    }),

      小菜对页面跳转路由底层的学习还不够深入，如有错误请多多指导！博文中设计代码均为核心代码，仅供参考！

来源：阿策小和尚