新的 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

新的 Form、FormField 自动验证 API

概述

背景

变更说明

迁移指南

时间线

参考资料