跨平台开发 / 系统课时

在父子组件之间传递数据

在父子组件之间传递数据

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 的职责更加清晰,也方便后续替换和测试组件。

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

目录与阅读设置

阅读设置

17

记录一个想法

在父子组件之间传递数据

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

登录哪都通