一個FormField包含TextField,它將TextField小部件包裝在FormField中。
表單(From)使一次進行保存芭逝、重置或驗證多個字段變得更容易。要在沒有表單(From)的情況下使用渊胸,請將GlobalKey傳遞給構(gòu)造函數(shù)旬盯,并使用GlobalKey.currentState保存或重置表單字段。
指定控制器時翎猛,initialValue必須為null(默認(rèn)值)胖翰。如果controller為null,那么TextEditingController將被自動構(gòu)造切厘,其文本將初始化為initalValue或空字符串萨咳。如果這個FormField是滾動容器的一部分,該容器懶加載它的子對象疫稿,比如ListView或CustomScrollView培他,那么應(yīng)該指定一個控制器∫抛控制器的生命周期應(yīng)該由滾動容器的有狀態(tài)小部件祖先來管理舀凛。
類型 名稱 | 解釋 |
---|---|
Key key | |
this.controller | 控制正在編輯的文本。如果為空员萍,這個小部件將創(chuàng)建自己的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 |