跨平台开发 / 系统课时

完成新增和编辑表单

完成新增和编辑表单

本节将为任务应用加入数据修改能力,通过 Flutter 表单组件完成输入、校验和提交,并学习如何利用页面返回值通知列表页刷新数据。

学习目标

  • 掌握 Form、TextFormField 和校验器的组合方式。
  • 实现新增任务和编辑任务共用的表单页面。
  • 理解页面返回值在 Flutter 导航中的使用方式。

设计任务编辑流程

新增和编辑本质上都是修改任务数据,因此可以复用同一个表单页面。区别在于:新增时表单为空,编辑时需要提前填充已有任务内容。

表单页面通常包含以下职责:

  • 管理输入框状态。
  • 校验用户输入。
  • 创建或更新任务对象。
  • 提交后返回修改结果。

使用 Form 完成输入校验

Flutter 中可以使用 Form 管理多个输入组件,并通过 GlobalKey<FormState> 触发表单校验。

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

class TaskFormPage extends StatefulWidget {
  final Task? task;

  const TaskFormPage({super.key, this.task});

  @override
  State<TaskFormPage> createState() => _TaskFormPageState();
}

class _TaskFormPageState extends State<TaskFormPage> {
  final _formKey = GlobalKey<FormState>();
  late final TextEditingController _titleController;

  @override
  void initState() {
    super.initState();
    _titleController = TextEditingController(
      text: widget.task?.title ?? '',
    );
  }

  void saveTask() {
    if (_formKey.currentState!.validate()) {
      Navigator.pop(context, _titleController.text);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('编辑任务')),
      body: Form(
        key: _formKey,
        child: Column(
          children: [
            TextFormField(
              controller: _titleController,
              decoration: const InputDecoration(labelText: '任务标题'),
              validator: (value) {
                if (value == null || value.trim().isEmpty) {
                  return '请输入任务标题';
                }
                return null;
              },
            ),
            ElevatedButton(
              onPressed: saveTask,
              child: const Text('保存'),
            ),
          ],
        ),
      ),
    );
  }
}

预期结果

text
打开表单页面后可以输入任务标题。
输入为空时显示校验提示。
输入有效内容后点击保存,页面返回输入结果。

使用导航返回值更新列表

Navigator.pop 不仅可以关闭页面,还可以返回数据。列表页面可以等待返回结果,根据结果更新任务集合。

dart
final result = await Navigator.push(
  context,
  MaterialPageRoute(
    builder: (_) => const TaskFormPage(),
  ),
);

if (result != null) {
  setState(() {
    tasks.add(
      Task(
        title: result,
        description: '新创建任务',
        completed: false,
      ),
    );
  });
}

预期结果

text
用户保存任务后返回列表页面。
列表页面新增一条刚创建的任务数据。

处理新增与编辑的边界

真实应用中,编辑任务通常需要区分新增和修改两个状态。可以通过传入可选任务对象判断当前模式:

  • task == null:创建新任务。
  • task != null:加载已有数据并更新。

当表单字段增加时,应继续使用模型对象承载数据,避免在页面之间传递大量独立参数。这样可以让页面职责保持清晰,也方便后续接入数据库或接口。

完成表单功能后,任务应用已经具备完整的创建和修改流程,可以进一步接入持久化存储保存用户数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成新增和编辑表单

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

登录哪都通