快捷導(dǎo)航

Flutter開發(fā)中的路由參數(shù)處理

更新時(shí)間：2021年06月17日 16:11:07 作者：島上碼農(nóng)

在實(shí)際開發(fā)中，我們經(jīng)常會(huì)需要在頁(yè)面跳轉(zhuǎn)的時(shí)候攜帶路由參數(shù)，典型的例子就是從列表到詳情頁(yè)的時(shí)候，需要攜帶詳情的 id，以便詳情頁(yè)獲取對(duì)應(yīng)的數(shù)據(jù)。同時(shí)，有些時(shí)候還需要返回時(shí)攜帶參數(shù)返回上一級(jí)，以便上級(jí)頁(yè)面根據(jù)返回結(jié)果更新。本篇將介紹這兩種情形的實(shí)現(xiàn)。

Navigator 的 push 和 pop方法

Navigator 導(dǎo)航器的 push 和 pop 方法可以攜帶參數(shù)在頁(yè)面間傳遞，其他變形的方法也一樣。pushNamed 方法原型如下：

Future<T?> pushNamed<T extends Object?>(
  String routeName, {
  Object? arguments,
}) {
  return push<T>(_routeNamed<T>(routeName, arguments: arguments)!);
}

除了 routeName 的命名路由以外，還有個(gè)可選參數(shù) arguments 用于在路由頁(yè)面?zhèn)鬟f參數(shù)。pop 方法也一樣：

void pop<T extends Object?>([ T? result ]) {
  //...
}

可以攜帶一個(gè) result 回傳到上級(jí)頁(yè)面。

代碼實(shí)現(xiàn)

我們使用一個(gè)列表跳轉(zhuǎn)到詳情頁(yè)來(lái)演示路由參數(shù)獲取（列表構(gòu)建文章請(qǐng)看//www.dbjr.com.cn/article/213052.htm）。點(diǎn)擊列表行時(shí)攜帶列表數(shù)據(jù)項(xiàng)的 id 跳轉(zhuǎn)到詳情頁(yè)。從詳情頁(yè)返回時(shí)再把該 id 回傳。列表項(xiàng)的 Widget 新增了一個(gè) id屬性，由構(gòu)建列表時(shí)初始化得到。

class DynamicItem extends StatelessWidget {
  final int id;
  final String title;
  final String imageUrl;
  final int viewCount;
  static const double ITEM_HEIGHT = 100;
  static const double TITLE_HEIGHT = 80;
  static const double MARGIN_SIZE = 10;
  const DynamicItem(this.id, this.title, this.imageUrl, this.viewCount,
      {Key key})
      : super(key: key);
  //...
}

列表的容器使用 GestureDetector 包裹，以便響應(yīng)點(diǎn)擊事件。 onTap 方法定義為一個(gè) async 方法，以便使用 await 獲取導(dǎo)航返回時(shí)的參數(shù)，并使用一個(gè) SnackBar 顯示返回的 id。這里 pushNamed 攜帶了一個(gè) Map 對(duì)象將列表的 id傳遞到詳情頁(yè)。

@override
Widget build(BuildContext context) {
  return GestureDetector(
    child: Container(
      margin: EdgeInsets.all(MARGIN_SIZE),
      child: Row(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          _imageWrapper(this.imageUrl),
          Expanded(
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                _titleWrapper(context, this.title),
                _viewCountWrapper(this.viewCount.toString()),
              ],
            ),
          )
        ],
      ),
    ),
    onTap: () async {
      Map<String, dynamic> routeParams = {'id': id};
      var arguments = await Navigator.of(context)
          .pushNamed(RouterTable.dynamicDetail, arguments: routeParams);
      ScaffoldMessenger.of(context).showSnackBar(SnackBar(
        content: Text("從動(dòng)態(tài)${(arguments as Map<String, dynamic>)['id']}返回"),
      ));
    },
  );
}

這里還使用了一個(gè) arguments變量接收導(dǎo)航返回的參數(shù)，導(dǎo)航若有返回參數(shù)，會(huì)返回一個(gè) Future 對(duì)象，使用 await 即可接收。然后在使用 as 轉(zhuǎn)換為實(shí)際的類型進(jìn)行使用。在詳情頁(yè)中，F(xiàn)lutter 提供了一個(gè)ModalRoute的類從當(dāng)前上下文獲取路由配置參數(shù)，代碼如下所示：

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

  @override
  Widget build(BuildContext context) {
    Map<String, dynamic> routeParams =
        ModalRoute.of(context).settings?.arguments;

    return WillPopScope(
      child: Scaffold(
        appBar: AppBar(
          title: Text('動(dòng)態(tài)詳情'),
          brightness: Brightness.dark,
        ),
        body: Center(
          child: Text("產(chǎn)品 id: ${routeParams['id']}"),
        ),
      ),
      onWillPop: () async {
        Navigator.of(context).pop({'id': routeParams['id']});
        return true;
      },
    );
  }
}

實(shí)際上這個(gè)ModalRoute.of(context).settings就是我們上一篇路由攔截中的onGenerateRoute的 settings 參數(shù)，因此假設(shè)我們需要增加額外的路由參數(shù)（例如全局參數(shù)），則可以在 onGenerateRoute 方法中重新組裝路由參數(shù)。這里有個(gè)地方需要注意，因?yàn)榉祷貢r(shí)要攜帶參數(shù)，因此我們需要攔截返回響應(yīng)事件，這時(shí)候整個(gè)組件可以使用 WillPopScope 包裹，該方法帶有兩個(gè)參數(shù)：

child：子組件，即原有的頁(yè)面組件；
onWillPop：返回前攔截處理，返回一個(gè) Future<bool>對(duì)象，若為 false，則不會(huì)返回。若為 true，則返回上一級(jí)。這里我們調(diào)用了攜帶參數(shù)的 pop 方法以便將參數(shù)回傳。實(shí)際這里往往做一些其他處理，例如表單沒有保存詢問是否確認(rèn)李可，還有廣大電商的活動(dòng)頁(yè)詢問你是“忍痛離開”或是“再看一會(huì)”的處理。