跨平台开发 / 系统课时
完成新增和编辑表单
完成新增和编辑表单
本节将为任务应用加入数据修改能力,通过 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:加载已有数据并更新。
当表单字段增加时,应继续使用模型对象承载数据,避免在页面之间传递大量独立参数。这样可以让页面职责保持清晰,也方便后续接入数据库或接口。
完成表单功能后,任务应用已经具备完整的创建和修改流程,可以进一步接入持久化存储保存用户数据。
按自己的节奏,确认真正理解。