跨平台开发 / 系统课时
接收页面返回结果
接收页面返回结果
本篇解决 Flutter 页面跳转后的结果回传问题,学习如何等待一个页面关闭后的返回值,让选择页、编辑页或设置页把用户操作结果交回上一层页面。
学习目标
- 理解 Navigator 返回值的工作机制
- 掌握通过 Future 接收页面返回结果的方法
- 能够实现选择页面向调用页面返回数据
页面返回值的使用场景
很多交互不是单向跳转。例如设置页面修改完成后需要告诉上一页保存成功;选择城市页面需要把用户选择的城市交回搜索页。
Flutter 中 Navigator.push 会返回一个 Future。当目标页面调用 Navigator.pop 时,可以把结果作为参数传递给这个 Future。

使用 Navigator.pop 返回数据
调用页面通过 await 等待结果,目标页面通过 pop 返回值。
dart
import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(
home: HomePage(),
);
}
}
class HomePage extends StatelessWidget {
const HomePage({super.key});
Future<void> openSelector(BuildContext context) async {
final result = await Navigator.push<String>(
context,
MaterialPageRoute(
builder: (context) => const CitySelectorPage(),
),
);
if (result != null) {
debugPrint('选择城市: $result');
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('首页')),
body: Center(
child: ElevatedButton(
onPressed: () => openSelector(context),
child: const Text('选择城市'),
),
),
);
}
}
class CitySelectorPage extends StatelessWidget {
const CitySelectorPage({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('城市选择')),
body: Center(
child: ElevatedButton(
onPressed: () {
Navigator.pop(context, 'Singapore');
},
child: const Text('选择 Singapore'),
),
),
);
}
}预期输出
text
选择城市按钮打开城市选择页。
点击“选择 Singapore”后返回首页。
控制台输出:选择城市: Singapore处理没有返回结果的情况
用户可能直接返回页面,例如点击系统返回键。这时 Future 收到的结果通常是 null,因此调用方需要判断结果是否存在。
dart
if (result == null) {
debugPrint('用户取消选择');
return;
}这种判断对于编辑页面尤其重要。用户取消编辑时,不应该覆盖原来的数据。
返回结果时的数据设计
简单场景可以返回字符串、数字或布尔值,例如选择状态:
| 返回类型 | 示例场景 |
|---|---|
| String | 选择城市、标签 |
| bool | 是否确认操作 |
| 自定义对象 | 编辑后的完整数据 |
如果返回的数据包含多个字段,建议定义模型对象,而不是返回多个零散值。
例如编辑用户资料后,可以返回一个 UserProfile 对象,让上一页直接刷新展示内容。
使用返回值时的边界
页面返回值适合描述一次页面交互产生的结果,例如“用户选择了什么”“用户是否确认”。
如果两个页面需要持续同步变化,例如购物车数量实时变化或登录状态全局共享,更适合使用状态管理方案,而不是依赖 Navigator 返回值。
按自己的节奏,确认真正理解。