跨平台开发 / 系统课时
向目标页面传递参数
向目标页面传递参数
本篇解决 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 对象,可以降低页面和调用方之间的耦合。
路由传参时的常见选择
不同场景可以选择不同方式:
| 场景 | 推荐方式 |
|---|---|
| 页面数量少、结构简单 | 构造函数直接传参 |
| 参数较多且属于同一业务对象 | 传递模型对象 |
| 需要统一管理命名路由 | 使用路由参数机制 |
需要注意的是,页面参数应该描述页面展示所需的数据,而不是把整个应用状态全部传入页面。过大的参数对象会让页面难以维护。
什么时候不应该直接传递对象
如果页面展示的数据需要实时更新,或者多个页面共享同一份状态,单纯传递对象可能不是最佳方案。此时可以结合状态管理方案,让页面读取统一的数据源。
页面参数传递解决的是“打开页面时需要什么数据”的问题,而不是完整的应用状态管理问题。
按自己的节奏,确认真正理解。