跨平台开发 / 系统课时

用 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 返回了空字符串而不是明确错误信息。

表单设计时,应让客户端校验负责快速反馈,让服务端校验负责最终安全判断。两者不能互相替代。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Form 完成输入校验

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

登录哪都通