跨平台开发 / 系统课时

接收页面返回结果

接收页面返回结果

本篇解决 Flutter 页面跳转后的结果回传问题,学习如何等待一个页面关闭后的返回值,让选择页、编辑页或设置页把用户操作结果交回上一层页面。

学习目标

  • 理解 Navigator 返回值的工作机制
  • 掌握通过 Future 接收页面返回结果的方法
  • 能够实现选择页面向调用页面返回数据

页面返回值的使用场景

很多交互不是单向跳转。例如设置页面修改完成后需要告诉上一页保存成功;选择城市页面需要把用户选择的城市交回搜索页。

Flutter 中 Navigator.push 会返回一个 Future。当目标页面调用 Navigator.pop 时,可以把结果作为参数传递给这个 Future。

Flutter 页面跳转返回值流程示意图

使用 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 返回值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接收页面返回结果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通