跨平台开发 / 系统课时

用 StatefulWidget 管理页面变化

用 StatefulWidget 管理页面变化

本篇解决 Flutter 页面需要保存并修改数据时如何组织代码的问题。你将理解 StatefulWidget 与 State 的职责划分,并通过一个简单计数页面掌握可变状态驱动界面更新的基本方式。

学习目标

  • 理解 StatefulWidget、State 和 Widget 重建之间的关系。
  • 掌握 State 对象保存页面可变数据的方法。
  • 能够编写一个包含用户交互和状态变化的简单页面。

为什么需要 StatefulWidget

Flutter 中普通的 Widget 通常被设计为不可变对象。Widget 描述的是界面配置,而不是长期保存的数据。当页面内容需要随着用户操作、网络结果或计时器发生变化时,就需要额外的状态管理机制。

StatefulWidget 提供了一种把界面描述和可变数据分开的方式。StatefulWidget 本身仍然保持不可变,真正保存变化数据的是对应的 State 对象。

例如,一个计数按钮页面中,当前数字属于页面状态,而按钮和文本属于界面描述。当数字变化时,Flutter 会根据新的状态重新构建相关 Widget。

StatefulWidget 与 State 的关系

StatefulWidget 负责创建 State,并描述这个页面属于哪一种组件。State 负责保存数据、响应事件以及通知 Flutter 页面需要重新构建。

StatefulWidget 与 State 生命周期关系示意图

常见职责划分如下:

对象 主要职责
StatefulWidget 保存初始化配置,创建 State
State 保存可变数据,执行状态变化逻辑
build 方法 根据当前状态生成 Widget 树

一个页面通常通过继承 StatefulWidget 创建组件,再通过 State 类保存需要变化的数据。

创建一个 StatefulWidget 页面

下面示例创建一个简单计数器。点击按钮时,状态中的数字增加,页面重新构建后显示最新结果。

dart
import 'package:flutter/material.dart';

class CounterPage extends StatefulWidget {
  const CounterPage({super.key});

  @override
  State<CounterPage> createState() => _CounterPageState();
}

class _CounterPageState extends State<CounterPage> {
  int count = 0;

  void increment() {
    setState(() {
      // 修改状态后通知 Flutter 重新执行 build。
      count++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Counter')),
      body: Center(
        child: Text('count: $count'),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: increment,
        child: const Icon(Icons.add),
      ),
    );
  }
}

预期结果

text
页面显示 count: 0。
每点击一次按钮,数字增加 1,页面显示最新 count 值。

这里的关键点不是数字累加本身,而是状态变化流程:用户操作修改 State 中的数据,然后 Flutter 根据新的状态重新执行 build。

State 管理中的常见边界

State 适合保存当前页面自身需要维护的数据,例如输入框内容、选中状态、动画进度或加载状态。但如果多个页面共享同一份数据,仅依赖单个 State 会让数据传递变得复杂。

当状态影响范围扩大时,可以考虑使用更高层的状态管理方案,例如 Provider、Riverpod 或其他架构方式。

同时需要注意,State 中保存的数据应该代表页面状态,而不是临时计算结果。能够通过其他数据直接计算出来的内容,通常不需要额外保存。

什么时候使用 StatefulWidget

当页面存在明确的变化来源时,可以优先考虑 StatefulWidget,例如:

  • 用户点击按钮改变页面内容。
  • 输入框内容需要实时显示。
  • 页面需要根据异步请求结果刷新。
  • 动画过程需要持续更新。

如果页面完全由固定数据生成,没有交互变化,则 StatelessWidget 会更简单,也更容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 StatefulWidget 管理页面变化

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

登录哪都通