Material组件库中提供了输入框组件 TextField 和表单组件 Form。下面我们分别介绍一下。

TextField

TextField 用于文本输入,它提供了很多属性,我们先简单介绍一下主要属性的作用,然后通过几个示例来演示一下关键属性的用法。

  1. (new) TextField TextField({Key key,
  2. TextEditingController controller,
  3. FocusNode focusNode,
  4. InputDecoration decoration = const InputDecoration(),
  5. TextInputType keyboardType,
  6. TextInputAction textInputAction,
  7. TextCapitalization textCapitalization = TextCapitalization.none,
  8. TextStyle style,
  9. StrutStyle strutStyle,
  10. TextAlign textAlign = TextAlign.start,
  11. TextAlignVertical textAlignVertical,
  12. TextDirection textDirection,
  13. bool readOnly = false,
  14. ToolbarOptions toolbarOptions,
  15. bool showCursor,
  16. bool autofocus = false,
  17. bool obscureText = false,
  18. bool autocorrect = true,
  19. bool enableSuggestions = true,
  20. int maxLines = 1,
  21. int minLines,
  22. bool expands = false,
  23. int maxLength,
  24. bool maxLengthEnforced = true,
  25. void Function(String) onChanged,
  26. void Function() onEditingComplete,
  27. void Function(String) onSubmitted,
  28. List<TextInputFormatter> inputFormatters,
  29. bool enabled,
  30. double cursorWidth = 2.0,
  31. Radius cursorRadius,
  32. Color cursorColor,
  33. Brightness keyboardAppearance,
  34. EdgeInsets scrollPadding = const EdgeInsets.all(20.0),
  35. DragStartBehavior dragStartBehavior = DragStartBehavior.start,
  36. bool enableInteractiveSelection = true,
  37. void Function() onTap,
  38. Widget Function(BuildContext,
  39. {currentLength: int,
  40. isFocused: bool,
  41. maxLength: int}) buildCounter,
  42. ScrollController scrollController,
  43. ScrollPhysics scrollPhysics})
  • controller 编辑框的控制器,通过它可以设置/获取编辑框的内容、选择编辑内容、监听编辑文本改变事件。大多数情况下我们都需要显式提供一个controller来与文本框交互。如果没有提供controller,则TextField内部会自动创建一个。
  • focusNode 用于控制TextField是否占有当前键盘的输入焦点。它是我们和键盘交互的一个句柄(handle)。
  • decoration 用于控制TextField的外观显示,如提示文本、背景颜色、边框等。
    1. (new) InputDecoration InputDecoration({Widget icon,
    2. String labelText,
    3. TextStyle labelStyle,
    4. String helperText,
    5. TextStyle helperStyle,
    6. int helperMaxLines,
    7. String hintText,
    8. TextStyle hintStyle,
    9. int hintMaxLines,
    10. String errorText,
    11. TextStyle errorStyle,
    12. int errorMaxLines,
    13. bool hasFloatingPlaceholder = true,
    14. bool isDense,
    15. EdgeInsetsGeometry contentPadding,
    16. Widget prefixIcon,
    17. Widget prefix,
    18. String prefixText,
    19. TextStyle prefixStyle,
    20. Widget suffixIcon,
    21. Widget suffix,
    22. String suffixText,
    23. TextStyle suffixStyle,
    24. Widget counter,
    25. String counterText,
    26. TextStyle counterStyle,
    27. bool filled,
    28. Color fillColor,
    29. Color focusColor,
    30. Color hoverColor,
    31. InputBorder errorBorder,
    32. InputBorder focusedBorder,
    33. InputBorder focusedErrorBorder,
    34. InputBorder disabledBorder,
    35. InputBorder enabledBorder,
    36. InputBorder border,
    37. bool enabled = true, // 为false时候禁止交互
    38. String semanticCounterText,
    39. bool alignLabelWithHint})
    | InputDecoration类参数 | 含义 | | —- | —- | | labelText | 描述输入字段的文本,相当于html的 label | | hintText | 表示字段接受的输入类型的文本,相当于html的 placeholder | | prefixIcon | 出现在装饰容器中的[prefix]或[prefixText]前面和文本字段可编辑部分前面的图标 |
  • keyboardType 用于设置该输入框默认的键盘输入类型,取值如下: | TextInputType枚举值 | 含义 | | —- | —- | | text | 文本输入键盘 | | multiline | 多行文本,需和maxLines配合使用(设为null或大于1) | | number | 数字;会弹出数字键盘 | | phone | 优化后的电话号码输入键盘;会弹出数字键盘并显示“* #” | | datetime | 优化后的日期输入键盘;Android上会显示“: -” | | emailAddress | 优化后的电子邮件地址;会显示“@ .” | | url | 优化后的url输入键盘; 会显示“/ .” |

  • textInputAction 键盘动作按钮图标(即回车键位图标),它是一个枚举值,有多个可选值,全部的取值列表读者可以查看API文档,下面是当值为TextInputAction.search时,原生Android系统下键盘样式如图3-24所示:
    输入框及表单 - 图1

  • style:正在编辑的文本样式。
  • textAlign: 输入框内编辑文本在水平方向的对齐方式。
  • autofocus: 是否自动获取焦点。
  • obscureText:是否隐藏正在编辑的文本,如用于输入密码的场景等,文本内容会用“•”替换。
  • maxLines:输入框的最大行数,默认为1;如果为null,则无行数限制。
  • maxLength和maxLengthEnforced :maxLength代表输入框文本的最大长度,设置后输入框右下角会显示输入的文本计数。maxLengthEnforced决定当输入文本长度超过maxLength时是否阻止输入,为true时会阻止输入,为false时不会阻止输入但输入框会变红。
  • onChange:输入框内容改变时的回调函数;注:内容改变事件也可以通过controller来监听。
  • onEditingComplete和onSubmitted:这两个回调都是在输入框输入完成时触发,比如按了键盘的完成键(对号图标)或搜索键(🔍图标)。不同的是两个回调签名不同,onSubmitted回调是ValueChanged类型,它接收当前输入内容做为参数,而onEditingComplete不接收参数。
  • inputFormatters:用于指定输入格式;当用户输入内容改变时,会根据指定的格式来校验。
  • enable:如果为false,则输入框会被禁用,禁用状态不接收输入和事件,同时显示禁用态样式(在其decoration中定义)。
  • cursorWidth cursorRadius cursorColor :这三个属性是用于自定义输入框光标宽度、圆角和颜色的。

示例:登录输入框

布局

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(new MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. return MaterialApp(
  7. debugShowCheckedModeBanner: false,
  8. title: 'TextField 文本输入框',
  9. theme: ThemeData(primarySwatch: Colors.blue),
  10. home: Scaffold(
  11. appBar: AppBar(title: Text("TextField 文本输入框")),
  12. body: InputWidget()));
  13. }
  14. }
  15. class InputWidget extends StatelessWidget {
  16. @override
  17. Widget build(BuildContext context) {
  18. return Column(
  19. children: <Widget>[
  20. Padding(
  21. padding: EdgeInsets.only(left: 50, right: 50, top: 10),
  22. child: ConstrainedBox(
  23. constraints: BoxConstraints(
  24. maxHeight: 250,
  25. minWidth: 200,
  26. ),
  27. child: TextField(
  28. autofocus: true,
  29. maxLength: 11,
  30. keyboardType: TextInputType.datetime,
  31. textInputAction: TextInputAction.search,
  32. decoration: InputDecoration(
  33. contentPadding: const EdgeInsets.symmetric(vertical: 4.0),
  34. // labelText: "用户名",
  35. hintText: "用户名或邮箱",
  36. border: OutlineInputBorder(
  37. borderRadius: BorderRadius.circular(10.0),
  38. borderSide: BorderSide.none,
  39. // borderSide: BorderSide(color: Colors.red, width: 3.0, style: BorderStyle.solid)//没什么卵效果
  40. ),
  41. filled: true,
  42. fillColor: Color(0xffDCDCDC),
  43. prefixIcon: Icon(Icons.person)),
  44. onChanged: (val) {},
  45. ),
  46. )),
  47. Padding(
  48. padding: EdgeInsets.only(
  49. left: 50,
  50. right: 50,
  51. top: 10,
  52. ),
  53. child: ConstrainedBox(
  54. constraints: BoxConstraints(
  55. maxHeight: 250,
  56. minWidth: 200,
  57. ),
  58. child: TextField(
  59. style: TextStyle(),
  60. decoration: InputDecoration(
  61. contentPadding: EdgeInsets.fromLTRB(10, 0, 10, 15),
  62. labelText: "密码",
  63. hintText: "您的登录密码",
  64. border: OutlineInputBorder(
  65. borderRadius: BorderRadius.circular(10.0),
  66. //borderSide: BorderSide(color: Colors.red, width: 3.0, style: BorderStyle.solid)//没什么卵效果
  67. ),
  68. prefixIcon: Icon(Icons.lock)),
  69. obscureText: true,
  70. ),
  71. ),
  72. ),
  73. Padding(
  74. padding: EdgeInsets.only(
  75. left: 50,
  76. right: 50,
  77. top: 30,
  78. ),
  79. child: ConstrainedBox(
  80. constraints: BoxConstraints(
  81. maxHeight: 40,
  82. ),
  83. child: TextField(
  84. decoration: InputDecoration(
  85. contentPadding: EdgeInsets.fromLTRB(10, 0, 10, 15),
  86. labelText: "搜索",
  87. labelStyle: TextStyle(color:Colors.red),
  88. fillColor: Color(0XFFFFF8F4),
  89. filled: true,
  90. enabledBorder: OutlineInputBorder(
  91. /*边角*/
  92. borderRadius: BorderRadius.all(
  93. Radius.circular(5), //边角为5
  94. ),
  95. borderSide: BorderSide(
  96. color: Colors.green, //边线颜色为白色
  97. width: 1, //边线宽度为2
  98. ),
  99. ),
  100. focusedBorder: OutlineInputBorder(
  101. borderSide: BorderSide(
  102. color: Colors.red, //边框颜色为白色
  103. width: 1, //宽度为5
  104. ),
  105. borderRadius: BorderRadius.all(
  106. Radius.circular(5), //边角为30
  107. ),
  108. ),
  109. ),
  110. ),
  111. ),
  112. ),
  113. ],
  114. );
  115. }
  116. }

运行后,效果如图所示:
Screenshot_1586051312.png

获取输入内容

获取输入内容有两种方式:

  • 定义两个变量,用于保存用户名和密码,然后在onChange触发时,各自保存一下输入内容。
  • 通过controller直接获取。

第一种方式比较简单,不在举例,我们来重点看一下第二种方式,我们以用户名输入框举例:

  1. 定义一个controller:

    1. //定义一个controller
    2. TextEditingController _unameController = TextEditingController();
  2. 然后设置输入框controller:

    1. TextField(
    2. autofocus: true,
    3. controller: _unameController, //设置controller
    4. ...
    5. )
  3. 通过controller获取输入框内容

    1. print(_unameController.text)

    监听文本变化

    监听文本变化也有两种方式:

  4. 设置onChange回调,如:

    1. TextField(
    2. autofocus: true,
    3. onChanged: (v) {
    4. print("onChange: $v");
    5. }
    6. )
  5. 通过controller监听,如:

    1. @override
    2. void initState() {
    3. //监听输入改变
    4. _unameController.addListener((){
    5. print(_unameController.text);
    6. });
    7. }

    两种方式相比,onChanged是专门用于监听文本变化,而controller的功能却多一些,除了能监听文本变化外,它还可以设置默认值、选择文本,下面我们看一个例子:

  6. 创建一个controller:

    1. TextEditingController _selectionController = TextEditingController();
  7. 设置默认值,并从第三个字符开始选中后面的字符

    1. _selectionController.text="hello world!";
    2. _selectionController.selection=TextSelection(
    3. baseOffset: 2,
    4. extentOffset: _selectionController.text.length
    5. );

    设置controller:

    1. TextField(
    2. controller: _selectionController,
    3. )

    运行效果如图3-26所示:
    输入框及表单 - 图3

控制焦点

焦点可以通过FocusNode和FocusScopeNode来控制

默认情况下,焦点由FocusScope来管理,它代表焦点控制范围,可以在这个范围内可以通过FocusScopeNode在输入框之间移动焦点、设置默认焦点等。
我们可以通过FocusScope.of(context)来获取Widget树中默认的FocusScopeNode,然后通过FocusScope.of(context).requestFocus(“在TextField中focusNode绑定过的对象”)下面看一个示例,在此示例中创建两个TextField,第一个自动获取焦点,然后创建两个按钮:

  • 点击第一个按钮可以将焦点从第一个TextField挪到第二个TextField。
  • 点击第二个按钮可以关闭键盘。

我们要实现的效果如图3-27所示:
输入框及表单 - 图4

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(new MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. return MaterialApp(
  7. debugShowCheckedModeBanner: false,
  8. title: 'TextField 控制焦点',
  9. theme: ThemeData(primarySwatch: Colors.blue),
  10. home: Scaffold(
  11. appBar: AppBar(title: Text("TextField 控制焦点")),
  12. body: FocusTestRoute()));
  13. }
  14. }
  15. class FocusTestRoute extends StatefulWidget {
  16. @override
  17. _FocusTestRouteState createState() => new _FocusTestRouteState();
  18. }
  19. class _FocusTestRouteState extends State<FocusTestRoute> {
  20. FocusNode focusNode1 = new FocusNode();
  21. FocusNode focusNode2 = new FocusNode();
  22. FocusScopeNode focusScopeNode;
  23. @override
  24. Widget build(BuildContext context) {
  25. return Padding(
  26. padding: EdgeInsets.all(16.0),
  27. child: Column(
  28. children: <Widget>[
  29. TextField(
  30. autofocus: true,
  31. focusNode: focusNode1, //关联focusNode1
  32. decoration: InputDecoration(labelText: "input1"),
  33. ),
  34. TextField(
  35. focusNode: focusNode2, //关联focusNode2
  36. decoration: InputDecoration(labelText: "input2"),
  37. ),
  38. Builder(
  39. builder: (ctx) {
  40. return Column(
  41. children: <Widget>[
  42. RaisedButton(
  43. child: Text("移动焦点"),
  44. onPressed: () {
  45. //将焦点从第一个TextField移到第二个TextField
  46. // 这是一种写法 FocusScope.of(context).requestFocus(focusNode2);
  47. // 这是第二种写法
  48. if (null == focusScopeNode) {
  49. focusScopeNode = FocusScope.of(context);
  50. }
  51. focusScopeNode.requestFocus(focusNode2);
  52. },
  53. ),
  54. RaisedButton(
  55. child: Text("隐藏键盘"),
  56. onPressed: () {
  57. // 当所有编辑框都失去焦点时键盘就会收起
  58. focusNode1.unfocus();
  59. focusNode2.unfocus();
  60. },
  61. ),
  62. ],
  63. );
  64. },
  65. ),
  66. ],
  67. ),
  68. );
  69. }
  70. }

FocusNode和FocusScopeNode还有一些其它的方法,详情可以查看API文档。

监听焦点状态改变事件

FocusNode继承自ChangeNotifier,通过FocusNode可以监听焦点的改变事件,如:

  1. ...
  2. // 创建 focusNode
  3. FocusNode focusNode = new FocusNode();
  4. ...
  5. // focusNode绑定输入框
  6. TextField(focusNode: focusNode);
  7. ...
  8. // 监听焦点变化
  9. focusNode.addListener((){
  10. print(focusNode.hasFocus);
  11. });

获得焦点时focusNode.hasFocus值为true,失去焦点时为false

自定义样式

虽然我们可以通过decoration属性来定义输入框样式,下面以自定义输入框下划线颜色为例来介绍一下:

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(new MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. return MaterialApp(
  7. debugShowCheckedModeBanner: false,
  8. title: 'TextField 自定义样式',
  9. theme: ThemeData(primarySwatch: Colors.blue),
  10. home: Scaffold(
  11. appBar: AppBar(title: Text("TextField 自定义样式")),
  12. body: CustomInput()));
  13. }
  14. }
  15. class CustomInput extends StatelessWidget {
  16. const CustomInput({Key key}) : super(key: key);
  17. @override
  18. Widget build(BuildContext context) {
  19. return TextField(
  20. decoration: InputDecoration(
  21. labelText: "请输入用户名",
  22. prefixIcon: Icon(Icons.person),
  23. // 未获得焦点下划线设为灰色
  24. enabledBorder: UnderlineInputBorder(
  25. borderSide: BorderSide(color: Colors.grey),
  26. ),
  27. //获得焦点下划线设为蓝色
  28. focusedBorder: UnderlineInputBorder(
  29. borderSide: BorderSide(color: Colors.blue),
  30. ),
  31. ),
  32. );
  33. }
  34. }

上面代码我们直接通过InputDecoration的enabledBorder和focusedBorder来分别设置了输入框在未获取焦点和获得焦点后的下划线颜色。另外,我们也可以通过主题来自定义输入框的样式,下面我们探索一下如何在不使用enabledBorder和focusedBorder的情况下来自定义下滑线颜色。

由于TextField在绘制下划线时使用的颜色是主题色里面的hintColor,但提示文本颜色也是用的hintColor, 如果我们直接修改hintColor,那么下划线和提示文本的颜色都会变。值得高兴的是decoration中可以设置hintStyle,它可以覆盖hintColor,并且主题中可以通过inputDecorationTheme来设置输入框默认的decoration。所以我们可以通过主题来自定义,代码如下:

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(new MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. return MaterialApp(
  7. debugShowCheckedModeBanner: false,
  8. title: 'TextField 自定义样式',
  9. theme: ThemeData(
  10. primarySwatch: Colors.blue,
  11. ),
  12. home: Scaffold(
  13. appBar: AppBar(title: Text("TextField 自定义样式")),
  14. body: CustomInput()));
  15. }
  16. }
  17. class CustomInput extends StatelessWidget {
  18. const CustomInput({Key key}) : super(key: key);
  19. @override
  20. Widget build(BuildContext context) {
  21. return Theme(
  22. data: Theme.of(context).copyWith(
  23. hintColor: Colors.grey[200], //定义下划线颜色
  24. inputDecorationTheme: InputDecorationTheme(
  25. labelStyle: TextStyle(color: Colors.grey), //定义label字体样式
  26. hintStyle:
  27. TextStyle(color: Colors.grey, fontSize: 14.0) //定义提示文本样式
  28. )),
  29. child: Column(
  30. children: <Widget>[
  31. TextField(
  32. decoration: InputDecoration(
  33. labelText: "用户名",
  34. hintText: "用户名或邮箱",
  35. prefixIcon: Icon(Icons.person)),
  36. ),
  37. TextField(
  38. decoration: InputDecoration(
  39. prefixIcon: Icon(Icons.lock),
  40. labelText: "密码",
  41. hintText: "您的登录密码",
  42. hintStyle: TextStyle(color: Colors.grey, fontSize: 13.0)),
  43. obscureText: true,
  44. ),
  45. Container(
  46. child: TextField(
  47. keyboardType: TextInputType.emailAddress,
  48. decoration: InputDecoration(
  49. labelText: "Email",
  50. hintText: "电子邮件地址",
  51. prefixIcon: Icon(Icons.email),
  52. border: InputBorder.none //隐藏下划线
  53. )),
  54. decoration: BoxDecoration(
  55. // 下滑线浅灰色,宽度1像素
  56. border: Border(
  57. bottom: BorderSide(color: Colors.grey[200], width: 1.0))),
  58. )
  59. ],
  60. ));
  61. }
  62. }

输入框及表单 - 图5
我们成功的自定义了下划线颜色和提问文字样式,细心的读者可能已经发现,通过这种方式自定义后,输入框在获取焦点时,labelText不会高亮显示了,正如上图中的”用户名”本应该显示蓝色,但现在却显示为灰色,并且我们还是无法定义下划线宽度。另一种灵活的方式是直接隐藏掉TextField本身的下划线,然后通过Container去嵌套定义样式,如:

  1. Container(
  2. child: TextField(
  3. keyboardType: TextInputType.emailAddress,
  4. decoration: InputDecoration(
  5. labelText: "Email",
  6. hintText: "电子邮件地址",
  7. prefixIcon: Icon(Icons.email),
  8. border: InputBorder.none //隐藏下划线
  9. )
  10. ),
  11. decoration: BoxDecoration(
  12. // 下滑线浅灰色,宽度1像素
  13. border: Border(bottom: BorderSide(color: Colors.grey[200], width: 1.0))
  14. ),
  15. )

输入框及表单 - 图6
通过这种组件组合的方式,也可以定义背景圆角等。一般来说,优先通过decoration来自定义样式,如果decoration实现不了,再用widget组合的方式。

思考题:在这个示例中,下划线颜色是固定的,所以获得焦点后颜色仍然为灰色,如何实现点击后下滑线也变色呢?

表单Form

实际业务中,在正式向服务器提交数据前,都会对各个输入框数据进行合法性校验,但是对每一个TextField都分别进行校验将会是一件很麻烦的事。还有,如果用户想清除一组TextField的内容,除了一个一个清除有没有什么更好的办法呢?为此,Flutter提供了一个Form 组件,它可以对输入框进行分组,然后进行一些统一操作,如输入内容校验、输入框重置以及输入内容保存
image.png

Form

Form继承自StatefulWidget对象,它对应的状态类为FormState。我们先看看Form类的定义:

  1. Form({
  2. @required Widget child,
  3. bool autovalidate = false,
  4. WillPopCallback onWillPop,
  5. VoidCallback onChanged,
  6. })
  • autovalidate:是否自动校验输入内容;当为true时,每一个子FormField内容发生变化时都会自动校验合法性,并直接显示错误信息。否则,需要通过调用FormState.validate()来手动校验。
  • onWillPop:决定Form所在的路由是否可以直接返回(如点击返回按钮),该回调返回一个Future对象,如果Future的最终结果是false,则当前路由不会返回;如果为true,则会返回到上一个路由。此属性通常用于拦截返回按钮。
  • onChanged :Form的任意一个子FormField内容发生变化时会触发此回调。

FormField

Form的子孙元素必须是FormField类型,FormField是一个抽象类,定义几个属性,FormState内部通过它们来完成操作,FormField部分定义如下:

  1. const FormField({
  2. ...
  3. FormFieldSetter<T> onSaved, //保存回调
  4. FormFieldValidator<T> validator, //验证回调
  5. T initialValue, //初始值
  6. bool autovalidate = false, //是否自动校验。
  7. })

为了方便使用,Flutter提供了一个TextFormField组件,它继承自FormField类,也是TextField的一个包装类,所以除了FormField定义的属性之外,它还包括TextField的属性。

FormState

FormState为Form的State类,可以通过Form.of()或GlobalKey获得。我们可以通过它来对Form的子孙FormField进行统一操作。我们看看其常用的三个方法:

  • FormState.validate():调用此方法后,会调用Form子孙FormField的validate回调,如果有一个校验失败,则返回false,所有校验失败项都会返回用户返回的错误提示。
  • FormState.save():调用此方法后,会调用Form子孙FormField的save回调,用于保存表单内容
  • FormState.reset():调用此方法后,会将子孙FormField的内容清空。

示例

我们修改一下上面用户登录的示例,在提交之前校验:

  1. 用户名不能为空,如果为空则提示“用户名不能为空”。
  2. 密码不能小于6位,如果小于6为则提示“密码不能少于6位”。

完整代码:

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(new MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. return MaterialApp(
  7. debugShowCheckedModeBanner: false,
  8. title: 'TextField 自定义样式',
  9. theme: ThemeData(
  10. primarySwatch: Colors.blue,
  11. ),
  12. home: Scaffold(
  13. appBar: AppBar(title: Text("TextField 自定义样式")),
  14. body: FormTestRoute()));
  15. }
  16. }
  17. class FormTestRoute extends StatefulWidget {
  18. @override
  19. _FormTestRouteState createState() => new _FormTestRouteState();
  20. }
  21. class _FormTestRouteState extends State<FormTestRoute> {
  22. GlobalKey _formKey = new GlobalKey<FormState>();
  23. final Map<String, TextEditingController> nobleGases = {
  24. '_unameController': new TextEditingController(),
  25. '_pwdController': new TextEditingController(),
  26. };
  27. @override
  28. Widget build(BuildContext context) {
  29. return Padding(
  30. padding: const EdgeInsets.symmetric(vertical: 16.0, horizontal: 24.0),
  31. child: Form(
  32. key: _formKey, //设置globalKey,用于后面获取FormState
  33. autovalidate: true, //开启自动校验
  34. child: Column(
  35. children: <Widget>[
  36. TextFormField(
  37. autofocus: true,
  38. // controller: this.nobleGases['_unameController'],
  39. decoration: InputDecoration(
  40. labelText: "用户名",
  41. hintText: "用户名或邮箱",
  42. icon: Icon(Icons.person)),
  43. // 校验用户名
  44. validator: (v) {
  45. return v.trim().length > 0 ? null : "用户名不能为空";
  46. }),
  47. TextFormField(
  48. // controller: this.nobleGases['_pwdController'],
  49. decoration: InputDecoration(
  50. labelText: "密码",
  51. hintText: "您的登录密码",
  52. icon: Icon(Icons.lock)),
  53. obscureText: true,
  54. //校验密码
  55. validator: (v) {
  56. return v.trim().length > 5 ? null : "密码不能少于6位";
  57. }),
  58. // 登录按钮
  59. Padding(
  60. padding: const EdgeInsets.only(top: 28.0),
  61. child: Row(
  62. children: <Widget>[
  63. Expanded(
  64. child: RaisedButton(
  65. padding: EdgeInsets.all(15.0),
  66. child: Text("登录"),
  67. color: Theme.of(context).primaryColor,
  68. textColor: Colors.white,
  69. onPressed: () {
  70. //在这里不能通过此方式获取FormState,context不对
  71. //print(Form.of(context));
  72. // 通过_formKey.currentState 获取FormState后,
  73. // 调用validate()方法校验用户名密码是否合法,校验
  74. // 通过后再提交数据。
  75. if ((_formKey.currentState as FormState).validate()) {
  76. //验证通过提交数据
  77. // print(this.nobleGases['_unameController'].text);
  78. (_formKey.currentState as FormState).save();
  79. (_formKey.currentState as FormState).reset();
  80. }
  81. },
  82. ),
  83. ),
  84. ],
  85. ),
  86. )
  87. ],
  88. ),
  89. ));
  90. }
  91. }

输入框及表单 - 图8
注意,登录按钮的onPressed方法中不能通过Form.of(context)来获取,原因是,

  • 此处的context为FormTestRoute的context,而Form.of(context)是根据所指定context向根去查找
  • 而FormState是在FormTestRoute的子树中,所以不行
  • 正确的做法是通过Builder来构建登录按钮,Builder会将widget节点的context作为回调参数:
    1. Expanded(
    2. // 通过Builder来获取RaisedButton所在widget树的真正context(Element)
    3. child:Builder(builder: (context){
    4. return RaisedButton(
    5. ...
    6. onPressed: () {
    7. //由于本widget也是Form的子代widget,所以可以通过下面方式获取FormState
    8. if(Form.of(context).validate()){
    9. //验证通过提交数据
    10. }
    11. },
    12. );
    13. })
    14. )

    其实context正是操作Widget所对应的Element的一个接口,由于Widget树对应的Element都是不同的,所以context也都是不同的,有关context的更多内容会在后面高级部分详细讨论。Flutter中有很多“of(context)”这种方法,读者在使用时一定要注意context是否正确。

案例

常规的圆角矩形输入框

image.png

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter/rendering.dart';
import 'package:jmc_zx_ownerapp_flutter/router/router_tool.dart';
import 'package:provider/provider.dart';
import 'package:flutter_screenutil/flutter_screenutil.dart';
import 'package:jmc_zx_ownerapp_flutter/widgets/app_new_bar.dart';
import 'package:jmc_zx_ownerapp_flutter/utils/common_method.dart';
import 'package:jmc_zx_ownerapp_flutter/router/router_config.dart';
import 'vm.dart' show VM;

class IndexPage extends StatefulWidget {
  final isResidentReturnBtn;
  String scanText;

  IndexPage({
    required this.scanText,
    this.isResidentReturnBtn = true,
    Key? key,
  }) : super(key: key);

  @override
  State<StatefulWidget> createState() => ServicePackageState();
}

class ServicePackageState extends State<IndexPage>
    with TickerProviderStateMixin {
  bool _isCanClick = false;
  TextEditingController _textEditingController = TextEditingController();

  handleScanInput(VM vm, String text) {
    var inputText = _textEditingController.text;
    if (inputText.length > 0) {
      this.setState(() {
        _isCanClick = true;
      });
    } else {
      this.setState(() {
        _isCanClick = false;
      });
    }
  }

  // 事件:查询配件真伪
  void handleCheckAuthenticity(VM vm, BuildContext context) {
    // 002-C41-029B
    vm.onCheckAuthenticity(context, _textEditingController.text);
  }

  // 事件:查询价配件格
  void handlecheckPartsPrice(VM vm, BuildContext context) {
    // 002-C41-029B
    vm.onCheckPartsPrice(context, _textEditingController.text);
  }

  /// 扫描的窗口
  Widget _getScanView(VM vm) {
    var widget = Container(
      margin: EdgeInsets.symmetric(horizontal: 20.w),
      constraints: BoxConstraints(minWidth: 335.w, minHeight: 284.w),
      decoration: BoxDecoration(
          color: Colors.white,
          // border: Border(
          //   bottom: BorderSide(
          //     color: const Color(0x1a000000),
          //     width: 0.5.w,
          //     style: BorderStyle.solid,
          //   ),
          // ),
          // borderRadius: BorderRadius.only(bottomLeft: Radius.circular(4.0.w)),
          borderRadius: BorderRadius.circular(4.0.w),
          boxShadow: [
            BoxShadow(
              color: Color(0x1A386DF8),
              offset: Offset(0, 2),
              blurRadius: 5.0.w,
              spreadRadius: 3.0.w,
            )
          ]),
      // clipBehavior: Clip.antiAliasWithSaveLayer,
      child: Column(
        children: [
          Image.asset(
            getImagePath("img_default_scan"),
            width: 200.w,
            height: 200.w,
          ),
          _getInputView(vm, context),
        ],
      ),
    );
    return widget;
  }

  void _routerToScan(BuildContext context) {
    router.push(context, RouterConfig.scanRouter).then((res) {
      if (res is String && res.length > 0) {
        this.setState(() {
          _isCanClick = true;
        });
        _textEditingController.text = res;
      } else {
        this.setState(() {
          _isCanClick = false;
        });
      }
    });
  }

  Widget _getInputView(vm, BuildContext context) {
    return Container(
      padding: EdgeInsets.symmetric(horizontal: 20.w),
      height: 48.w,
      child: TextField(
          controller: _textEditingController,
          keyboardType: TextInputType.multiline,
          maxLines: 1,
          minLines: 1,
          maxLength: 30,
          decoration: InputDecoration(
            counterText: "", //此处控制最大字符是否显示
            label: Text("输入字符或点击右方扫码"),
            // labelText: "输入字符或点击右方扫码",
            // alignLabelWithHint: false,
            // 打开浮动 lable
            floatingLabelBehavior: FloatingLabelBehavior.never,
             // 能否交互选择
            enableInteractiveSelection:false,
            suffixIcon: GestureDetector(
              onTapDown: (details) {
                this._routerToScan(context);
              },
              child: Container(
                width: 40.w,
                height: 40.w,
                margin: EdgeInsets.all(4.w),
                alignment: Alignment.center,
                decoration: BoxDecoration(
                  color: Color(0x99386df8),
                  borderRadius: BorderRadius.all(
                    Radius.circular(38.w), //边角为5
                  ),
                  // borderRadius: BorderRadius.circular(22.w),
                ),
                child: Image.asset(
                  getImagePath("icon_line_scan"),
                  color: Colors.white,
                  width: 24.w,
                ),
              ),
            ),
            // contentPadding: EdgeInsets.fromLTRB(10, 0, 10, 15),
            labelStyle: TextStyle(
              color: Color(0x40000000),
              fontSize: 18.sp,
            ),
            fillColor: Color(0xFFF7F8FA),
            filled: true,
            isDense: true,
            // 去掉冗余边距, 只显示指定的
            contentPadding: EdgeInsets.only(left: 16.w),
            enabledBorder: OutlineInputBorder(
              /*边角*/
              borderRadius: BorderRadius.all(
                Radius.circular(40.w), //边角为5
              ),
              borderSide: BorderSide.none,
            ),
            /*       border: OutlineInputBorder(
              gapPadding: 0,
              borderRadius: BorderRadius.all(Radius.circular(40.w)),
              borderSide: BorderSide(
                width: 1,
                style: BorderStyle.none,
              ),
            ),*/
            focusedBorder: OutlineInputBorder(
              borderSide: BorderSide.none,
              borderRadius: BorderRadius.all(
                Radius.circular(40.w),
              ),
            ),
          ),
          onChanged: (e) {
            handleScanInput(vm, e);
          }),
    );
  }

  Widget _getButtonFunctionView(vm) {
    return Container(
        // color: Colors.red,
        margin: EdgeInsets.only(top: 40.w),
        child: Row(
          // mainAxisSize: MainAxisSize.min,
          mainAxisAlignment: MainAxisAlignment.spaceAround,
          children: [
            TextButton(
              onPressed: () {
                if (!_isCanClick) return;
                this.handlecheckPartsPrice(vm, context);
              },
              style: ButtonStyle(
                  // alignment: Alignment.centerRight,
                  // padding: MaterialStateProperty.all(EdgeInsets.zero), // 消除按钮带来的内边距
                  ),
              child: Container(
                width: 160.w,
                height: 44.w,
                alignment: Alignment.center,
                // 垂直水平居中可以在 设置【padding】 和 【alignment、width、height】 二选一
                // padding: EdgeInsets.symmetric(horizontal: 23.w, vertical: 10.w),
                decoration: BoxDecoration(
                  border: Border.all(
                    color: Color(_isCanClick ? 0xFF576B95 : 0x26000000),
                    width: 1.w,
                    style: BorderStyle.solid,
                  ),
                  borderRadius: BorderRadius.circular(22.w),
                ),
                child: Text(
                  "查询零售价",
                  style: TextStyle(
                    color: Color(_isCanClick ? 0xFF576B95 : 0x26000000),
                    fontWeight: FontWeight.w600,
                    fontSize: 16.sp,
                  ),
                ),
              ),
            ),
            TextButton(
              onPressed: () {
                if (!_isCanClick) return;
                this.handleCheckAuthenticity(vm, context);
              },
              style: ButtonStyle(
                  // alignment: Alignment.centerRight,
                  // padding: MaterialStateProperty.all(
                  //     EdgeInsets.symmetric(horizontal: 20.w, vertical: 21.w)),
                  ),
              child: Container(
                width: 160.w,
                height: 44.w,
                alignment: Alignment.center,
                decoration: BoxDecoration(
                    color: Color(_isCanClick ? 0xFF386DF8 : 0x33386DF8),
                    borderRadius: BorderRadius.circular(22.w)),
                child: Text(
                  "验证真伪",
                  style: TextStyle(
                      color: Colors.white,
                      fontWeight: FontWeight.w600,
                      fontSize: 16.sp),
                ),
              ),
            ),
          ],
        ));
  }

  @override
  Widget build(BuildContext context) {
    // Map<String, dynamic> routeParams = ModalRoute.of(context).settings?.arguments;

    return ChangeNotifierProvider(
        create: (_) => VM(this),
        child: Consumer<VM>(
            builder: (cx, vm, child) => new Container(
                  color: Colors.white,
                  child: new Stack(
                    children: [
                      Positioned(
                        top: 0,
                        left: 0,
                        child: Container(
                          height: 375.w,
                          child: new Image.asset(
                            'assets/images/img_1_1_bg_default_white.png',
                            fit: BoxFit.fitHeight,
                          ),
                        ),
                      ),
                      Scaffold(
                          backgroundColor: Colors.transparent,
                          appBar: AppNewBar(
                            backgroundColor: Colors.transparent,
                            showReturnBtn: widget.isResidentReturnBtn,
                            title: "扫码验真伪",
                          ),
                          body: SingleChildScrollView(
                            child: new Column(
                              children: [
                                _getScanView(vm),
                                _getButtonFunctionView(vm),
                              ],
                            ),
                          )),
                    ],
                  ),
                )));
  }
}