用途:在 Flutter 应用中构建带校验功能的表单,处理多字段用户输入,适用于登录界面、数据录入表单等场景。
主要能力:以 Form 组件集中分组并校验多个输入字段;用 TextFormField 渲染带内置校验支持的 Material Design 文本输入;通过 validator 回调返回错误信息或 null,自动在字段下方显示错误提示。
必要用法:将 Form 放在 StatefulWidget 中。在 State 类中仅实例化一次 final _formKey = GlobalKey<FormState>();,不要放进 build 方法,否则每次重建都生成新 key,开销大且会破坏表单状态。把该 key 传给 Form 的 key 属性,以获得 FormState。复杂组件树中可改用 Form.of(context) 从后代组件访问 FormState。为每个 TextFormField 提供 validator:输入无效时返回具体错误字符串,通过时返回 null。提交流程为:创建 StatefulWidget 与 State;在 State 中实例化 _formKey;build 中返回 Form 并赋值 key: _formKey;添加 TextFormField;为每个字段写 validator;添加提交按钮(如 ElevatedButton);在 onPressed 中调用 _formKey.currentState!.validate()。validate() 返回 true 时执行提交(保存数据、发起 API 调用并显示成功提示,如 SnackBar);返回 false 时 FormState 自动重建并显示错误信息,用户需修改输入后重新提交直至通过。
限制:资料未提供安装命令、依赖版本、平台范围和收费信息。