用途:在 Flutter 中构建带校验的表单,适用于登录界面、数据录入表单以及任何多字段用户输入场景。
主要能力:使用 Form 组件将多个输入字段分组并统一校验;使用 TextFormField 渲染 Material Design 文本输入并内置校验支持;通过 validator 回调返回错误信息或 null 表示通过。
使用方式:将 Form 放在 StatefulWidget 中;在 State 类中以 final 变量形式一次性实例化 GlobalKey<FormState>,不要放在 build 方法内;把该 key 绑定到 Form 的 key 属性;在 Form 下添加 TextFormField 并为每个字段编写 validator;添加提交按钮,在 onPressed 中调用 _formKey.currentState!.validate()。若组件树复杂不便传 key,可用 Form.of(context) 从后代组件访问 FormState。
校验逻辑:validate() 返回 true 表示所有 validator 均返回 null,可继续提交并显示成功提示;返回 false 表示存在错误,FormState 会自动重建界面显示错误信息,用户需修改后重新提交。
限制:资料未提供其他平台、收费或性能方面的说明。