一个FormField包含TextField,它将TextField小部件包装在FormField中。
表单(From)使一次进行保存、重置或验证多个字段变得更容易。要在没有表单(From)的情况下使用,请将GlobalKey传递给构造函数,并使用GlobalKey.currentState保存或重置表单字段。
指定控制器时,initialValue必须为null(默认值)。如果controller为null,那么TextEditingController将被自动构造,其文本将初始化为initalValue或空字符串。如果这个FormField是滚动容器的一部分,该容器懒加载它的子对象,比如ListView或CustomScrollView,那么应该指定一个控制器。控制器的生命周期应该由滚动容器的有状态小部件祖先来管理。
类型 名称 | 解释 |
---|---|
Key key | |
this.controller | 控制正在编辑的文本。如果为空,这个小部件将创建自己的TextEditingController并使用initialValue初始化它的TextEditingController.text |
String initialValue | 初始值 |
FocusNode focusNode | 见TextFile |
InputDecoration decoration = const InputDecoration() | 见TextFile |
TextInputType keyboardType | 见TextFile |
TextCapitalization textCapitalization = TextCapitalization.none | 见TextFile |
TextInputAction textInputAction | 见TextFile |
TextStyle style | 见TextFile |
TextAlign textAlign = TextAlign.start | 见TextFile |
bool autofocus = false | 见TextFile |
bool obscureText = false | 见TextFile |
bool autocorrect = true | 见TextFile |
bool autovalidate = false | 见TextFile |
bool maxLengthEnforced = true | 见TextFile |
int maxLines = 1 | 见TextFile |
int maxLength | 见TextFile |
VoidCallback onEditingComplete | 见TextFile |
ValueChanged<String> onFieldSubmitted | 见TextFile |
FormFieldSetter<String> onSaved | 见TextFile |
FormFieldValidator<String> validator | 见TextFile |
List<TextInputFormatter> inputFormatters | 见TextFile |
bool enabled = true | 见TextFile |
Brightness keyboardAppearance | 见TextFile |
EdgeInsets scrollPadding = const EdgeInsets.all(20.0) | 见TextFile |
bool enableInteractiveSelection = true | 见TextFile |