跨平台开发 / 系统课时

向目标页面传递参数

向目标页面传递参数

本篇解决 Flutter 多页面导航中的数据传递问题,学习如何在打开详情页时把列表项、ID 或业务对象传入目标页面,让页面之间保持清晰的数据流。

学习目标

  • 理解 Flutter 页面参数传递的基本方式和适用场景
  • 掌握通过路由构造函数传递数据的实现方法
  • 能够设计简单、可维护的详情页面参数模型

为什么页面需要接收参数

在实际应用中,页面通常不是孤立存在的。例如商品列表点击某个商品后,需要打开详情页并展示对应商品信息;用户列表点击某个用户后,需要进入个人详情页。

Flutter 中页面本质上是 Widget,创建页面时可以通过构造函数传入外部数据。相比依赖全局变量或状态查询,显式传参能够让页面依赖关系更加清晰,也方便测试和复用。

使用构造函数传递页面数据

最常见的方式是在目标页面定义需要的数据字段,并通过构造函数接收。

下面示例实现一个商品列表跳转到详情页的场景。

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 MaterialApp(
      home: ProductListPage(),
    );
  }
}

class ProductListPage extends StatelessWidget {
  ProductListPage({super.key});

  final products = const [
    {'id': 1, 'name': 'Flutter 入门'},
    {'id': 2, 'name': 'Dart 进阶'},
  ];

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('商品列表')),
      body: ListView.builder(
        itemCount: products.length,
        itemBuilder: (context, index) {
          final product = products[index];
          return ListTile(
            title: Text(product['name'] as String),
            onTap: () {
              Navigator.push(
                context,
                MaterialPageRoute(
                  builder: (context) => ProductDetailPage(
                    id: product['id'] as int,
                    name: product['name'] as String,
                  ),
                ),
              );
            },
          );
        },
      ),
    );
  }
}

class ProductDetailPage extends StatelessWidget {
  final int id;
  final String name;

  const ProductDetailPage({
    super.key,
    required this.id,
    required this.name,
  });

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(name)),
      body: Center(
        child: Text('商品 ID: $id'),
      ),
    );
  }
}

预期结果

text
运行应用后显示商品列表。
点击“Flutter 入门”后进入详情页,页面标题显示“Flutter 入门”,正文显示“商品 ID: 1”。

设计页面参数模型

简单页面可以直接传递多个字段,但业务页面通常包含更多数据。此时建议使用独立的数据模型,避免构造函数参数越来越长。

例如商品详情可以定义:

dart
class Product {
  final int id;
  final String name;

  const Product({
    required this.id,
    required this.name,
  });
}

页面只接收一个 Product 对象,可以降低页面和调用方之间的耦合。

路由传参时的常见选择

不同场景可以选择不同方式:

场景 推荐方式
页面数量少、结构简单 构造函数直接传参
参数较多且属于同一业务对象 传递模型对象
需要统一管理命名路由 使用路由参数机制

需要注意的是,页面参数应该描述页面展示所需的数据,而不是把整个应用状态全部传入页面。过大的参数对象会让页面难以维护。

什么时候不应该直接传递对象

如果页面展示的数据需要实时更新,或者多个页面共享同一份状态,单纯传递对象可能不是最佳方案。此时可以结合状态管理方案,让页面读取统一的数据源。

页面参数传递解决的是“打开页面时需要什么数据”的问题,而不是完整的应用状态管理问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

向目标页面传递参数

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

登录哪都通