跨平台开发 / 系统课时
在父子组件之间传递数据
在父子组件之间传递数据
Flutter 的组件通信主要依靠数据向下传递、事件向上传递的模式。本篇将学习如何通过构造参数让父组件控制子组件显示内容,并通过回调让子组件通知父组件发生的操作。
学习目标
- 掌握通过构造参数向子组件传递数据的方法
- 理解回调函数在父子组件通信中的作用
- 使用单向数据流设计简单 Flutter 页面
父组件向子组件传递数据
Flutter 推荐使用单向数据流:父组件拥有状态,通过构造参数把当前数据传递给子组件。子组件只负责展示数据,不直接修改父组件状态。
下面示例中,父组件保存用户名,子组件通过参数接收并显示:
dart
import 'package:flutter/material.dart';
class UserPage extends StatelessWidget {
const UserPage({super.key});
@override
Widget build(BuildContext context) {
const name = 'Flutter 用户';
return UserCard(name: name);
}
}
class UserCard extends StatelessWidget {
final String name;
const UserCard({super.key, required this.name});
@override
Widget build(BuildContext context) {
return Text('你好,$name');
}
}预期结果
text
页面显示:你好,Flutter 用户UserCard 不关心用户名来自哪里,只负责根据参数构建界面,因此组件可以更容易复用。
子组件通过回调通知父组件
当子组件产生用户操作时,例如点击按钮、提交表单或选择列表项,通常不直接修改父组件数据,而是调用父组件传入的回调函数。
下面示例展示按钮组件通知父组件点击事件:
dart
import 'package:flutter/material.dart';
class ActionButton extends StatelessWidget {
final VoidCallback onPressed;
const ActionButton({super.key, required this.onPressed});
@override
Widget build(BuildContext context) {
return ElevatedButton(
onPressed: onPressed,
child: const Text('提交'),
);
}
}
class FormPage extends StatefulWidget {
const FormPage({super.key});
@override
State<FormPage> createState() => _FormPageState();
}
class _FormPageState extends State<FormPage> {
int count = 0;
void increase() {
setState(() {
count++;
});
}
@override
Widget build(BuildContext context) {
return Column(
children: [
Text('次数:$count'),
ActionButton(onPressed: increase),
],
);
}
}预期结果
text
初始显示:次数:0
点击提交后显示:次数:1子组件只发送事件,状态变化仍由父组件控制。
设计清晰的数据流
父子组件通信可以总结为两个方向:
| 方向 | 方式 | 作用 |
|---|---|---|
| 父到子 | 构造参数 | 提供显示所需数据 |
| 子到父 | 回调函数 | 通知用户操作 |
这种模式避免了子组件直接修改外部状态,使组件之间的关系更加明确。
当页面只有一层或两层组件时,构造参数和回调已经可以解决大部分通信问题。如果组件嵌套过深,需要跨越多个层级传递数据,再考虑使用 Provider、Riverpod 等状态管理方案。
常见通信错误
一个常见问题是在子组件内部保存本应属于父组件的数据。例如,列表选中项由子列表自己维护,父页面却需要知道当前选择结果,就会产生同步困难。
另一个问题是通过全局变量共享数据。这会绕过 Flutter 的 Widget 数据流,使依赖关系隐藏,后期调试更加困难。
保持“数据向下、事件向上”的原则,可以让每个 Widget 的职责更加清晰,也方便后续替换和测试组件。
按自己的节奏,确认真正理解。