[flutter] TextFormFieldを利用して「 'initialValue == null || controller == null': is not true.」というエラーになった時の対応

flutterでアプリ開発してたらエラーではまったのでその対応メモです。
なお開発環境は次の通りです。

事象#

TextFormFieldを利用すると、次のようなエラーが表示されました。

1
'package:flutter/src/material/text_form_field.dart': Failed assertion: line 177 pos 15: 'initialValue == null || controller == null': is not true.

このエラーが発生する最小のコードは次の通りです。

1
TextFormField(
2
  controller: TextEditingController(),
3
  initialValue: 'init',
4
),

TextFormFieldではcontrollerとinitialValueを同時に利用することはできません。

initialValueに値を設定すると内部的にcontrollerを生成するため、同時に利用できないものと思われます。

controllerとinitialValueのどちらかのみを利用することでエラーを回避できます。

TextEditingControllerには初期値を設定することができるため、基本的にはcontrollerを利用するで問題ないと思います。

1
TextFormField(
2
  controller: TextEditingController(),
3
  initialValue: 'init',
4
),

1
TextFormField(
2
  controller: TextEditingController(text: 'init'),
3
),

参考：