跨平台开发 / 系统课时
用 Form 完成输入校验
用 Form 完成输入校验
本篇将解决 Flutter 表单输入可靠校验的问题,学习如何组合 Form、TextFormField 和 validator,在用户提交数据前发现无效输入,并通过代码完成一个可运行的校验流程。
学习目标
- 理解 Form 在 Flutter 表单管理中的作用。
- 掌握 TextFormField 与 validator 的组合方式。
- 能够实现提交前统一校验并读取表单数据。
使用 Form 管理表单状态
在简单输入场景中,TextField 可以直接接收用户内容,但当页面包含多个输入项时,需要统一管理校验状态和提交逻辑。Form 提供了一个表单容器,可以协调内部多个 FormField 控件的校验行为。
TextFormField 是专门用于 Form 场景的输入组件,它继承了 TextField 的输入能力,同时增加了 validator、保存值等表单功能。
典型流程是:用户填写内容,点击提交按钮,调用 FormState 的 validate 方法,所有字段依次执行 validator。如果全部通过,再继续执行提交逻辑。
编写带校验的输入表单
下面示例实现一个简单登录表单,要求用户名不能为空,密码长度不少于 6 位。
dart
import 'package:flutter/material.dart';
class LoginFormPage extends StatefulWidget {
const LoginFormPage({super.key});
@override
State<LoginFormPage> createState() => _LoginFormPageState();
}
class _LoginFormPageState extends State<LoginFormPage> {
final _formKey = GlobalKey<FormState>();
final _usernameController = TextEditingController();
void _submit() {
// validate 会触发所有 TextFormField 的 validator
if (_formKey.currentState!.validate()) {
debugPrint('提交用户: ${_usernameController.text}');
}
}
@override
Widget build(BuildContext context) {
return Form(
key: _formKey,
child: Column(
children: [
TextFormField(
controller: _usernameController,
validator: (value) {
if (value == null || value.trim().isEmpty) {
return '请输入用户名';
}
return null;
},
),
TextFormField(
obscureText: true,
validator: (value) {
if (value == null || value.length < 6) {
return '密码至少 6 位';
}
return null;
},
),
ElevatedButton(
onPressed: _submit,
child: const Text('登录'),
),
],
),
);
}
}预期结果
text
用户输入为空时,点击登录按钮后显示“请输入用户名”。
密码长度不足 6 位时显示“密码至少 6 位”。
所有字段通过校验后,控制台输出提交用户信息。validator 的设计边界
validator 返回 String 时表示校验失败,返回 null 表示通过。实际项目中,validator 通常只负责当前字段规则,不应该直接执行网络请求或复杂业务逻辑。
常见校验内容包括:
- 是否为空。
- 字符长度是否符合要求。
- 格式是否正确,例如邮箱、手机号。
- 输入值之间是否存在依赖关系。
如果校验需要访问服务器,例如检查用户名是否已经注册,应在表单通过基础校验后,再执行异步业务检查。
Form 使用中的常见问题
如果调用 validate 后没有任何提示,通常是因为:
- TextFormField 没有放在 Form 内部。
- Form 没有绑定 GlobalKey。
- validator 返回了空字符串而不是明确错误信息。
表单设计时,应让客户端校验负责快速反馈,让服务端校验负责最终安全判断。两者不能互相替代。
按自己的节奏,确认真正理解。