新しいフォーム、FormField 自動検証 API

コンテンツ

まとめ

以前の自動検証 APIFormとFormFieldウィジェットは自動検証のタイミングを制御できませんでしたが起こるはずです。したがって、これらのウィジェットの自動検証はウィジェットが最初に作成されたとき、最初のビルド時に常に発生しましたユーザーには表示されますが、制御することはできませんでした自動検証がいつ行われるか。

コンテクスト

元の API では開発者による変更が許可されていないため次の場合にのみ検証する自動検証動作ユーザーがフォームフィールドを操作するため、新しい API を追加しました開発者が希望どおりに構成できるようにするのために動作する自動検証FormとFormFieldウィジェット。

変更内容の説明

次の変更が加えられました。

のautovalidateパラメータは廃止されました。
という新しいパラメータautovalidateMode、からの値を受け入れる EnumAutovalidateModeEnumクラスが追加されました。

移行ガイド

新しい自動検証 API に移行するには、次のことを行う必要があります。非推奨の使用法を置き換えるautovalidate新しいパラメータへのautovalidateModeパラメータ。以前と同じ動作が必要な場合は、次を使用できます。autovalidateMode = AutovalidateMode.always。これにより、FormとFormFieldウィジェット自動最初のビルド時と変更されるたびに検証します。

移行前のコード:

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

移行後のコード:

class 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