Flutter中TextFormField组件的重要属性/特性有哪些？

TextFormField是Flutter中面向表单场景的文本输入组件，继承自TextField并扩展了表单相关能力，以下是它的核心属性与特性：

基础配置属性 #

• controller: 关联TextEditingController实例，用于主动控制输入文本、监听内容变化，比如获取实时输入值、设置默认文本或清空输入框。
• initialValue: 初始化输入框的默认文本，适合无需动态控制输入内容的简单场景。
• keyboardType: 指定弹出的键盘类型，例如TextInputType.emailAddress适配邮箱输入、TextInputType.number适配数字输入，提升用户输入效率。

交互与表单验证属性 #

• validator: 输入内容校验回调，返回null表示校验通过，返回字符串则为错误提示信息，配合Form组件可实现表单整体校验。
• onChanged: 输入内容发生变化时触发的回调，可用于实时监听输入、联动更新其他UI组件或做即时校验。
• onSaved: 表单提交时触发的回调，通常用于将输入值同步到业务模型中，需配合FormState.save()调用。
• autovalidateMode: 控制自动校验的时机，可选值包括AutovalidateMode.onUserInteraction（用户交互后自动校验）、AutovalidateMode.always（始终校验）等。

外观定制属性 #

• decoration: 通过InputDecoration配置输入框的装饰样式，支持设置提示文本（hintText）、标签（labelText）、错误提示文本（errorText）、边框（border）、前缀/后缀图标（prefixIcon/suffixIcon）等，完全自定义输入框视觉效果。
• style: 使用TextStyle定义输入文本的样式，包括字体大小、颜色、字重、字体家族等。
• obscureText: 布尔值，设置是否隐藏输入内容（如密码输入场景），还可通过obscuringCharacter自定义隐藏时显示的字符。

行为控制特性 #

• enabled: 控制输入框是否可编辑，设为false时输入框处于禁用状态，无法获取焦点和输入内容。
• autofocus: 页面加载完成后自动获取输入焦点，适合需要用户直接输入的场景。
• maxLength: 设置输入文本的最大长度，配合maxLengthEnforced可控制是否严格限制输入长度（超过后无法继续输入）。
• textInputAction: 配置键盘右下角的操作按钮类型，例如TextInputAction.next（跳转到下一个输入框）、TextInputAction.done（完成输入），优化键盘交互流程。
• inputFormatters: 添加输入格式器集合，例如FilteringTextInputFormatter.digitsOnly限制仅输入数字、LengthLimitingTextInputFormatter限制输入长度，规范输入内容格式。

表单集成特性 #

TextFormField天然支持与Form组件集成，通过FormState可实现表单的整体校验、保存、重置操作，是Flutter表单开发的核心组件之一。

内容的提问来源于stack exchange，提问作者Hammad Ali