Flutter 的新的 Form 和 FormField 自动验证 API 框架

之前 Form 和 FormField 小部件的自动验证 API 无法控制自动验证何时发生。因此，这些小部件的自动验证总是在首次构建时，当小部件首次对用户可见时发生，而您无法控制自动验证何时发生。

由于原始 API 不允许开发人员更改自动验证行为，仅在用户与表单字段交互时进行验证，因此我们添加了新的 API，允许开发人员配置 Form 和 FormField 小部件的自动验证行为。

进行了以下更改：

autovalidate 参数已被弃用。
添加了一个名为 autovalidateMode 的新参数，这是一个接受 AutovalidateMode 枚举类值的枚举。

要迁移到新的自动验证 API，您需要将已弃用的 autovalidate 参数的用法替换为新的 autovalidateMode 参数。如果您想要与之前相同的行为，可以使用：autovalidateMode = AutovalidateMode.always。这将使您的 Form 和 FormField 小部件在首次构建时和每次更改时都自动验证。

迁移前的代码

dartclass MyWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return FormField(
      autovalidate: true,
      builder: (FormFieldState state) {
        return Container();
      },
    );
  }
}

迁移后的代码

dartclass MyWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return FormField(
      autovalidateMode: AutovalidateMode.always,
      builder: (FormFieldState state) {
        return Container();
      },
    );
  }
}

已于版本：1.21.0-5.0.pre 落地
稳定发布版本：1.22

API 文档

AutovalidateMode

Flutter 的新的 Form 和 FormField 自动验证 API

概述

背景

变更说明

迁移指南

时间线

参考资料