弃用 `DropdownButtonFormField` 构造函数参数 `value`，转而使用参数 `initialValue`

DropdownButtonFormField 构造函数中的 value 参数已弃用，转而使用 initialValue 参数。

DropdownButtonFormField 构造函数中的 value 参数曾用于初始化 DropdownButtonFormField.initialValue。名称不一致容易造成混淆。例如，开发者曾错误地认为设置 value 会改变当前选定的值。但实际并非如此——它仅用于设置初始值或在字段重置时使用。

DropdownButtonFormField 构造函数中的 value 参数已弃用，转而使用名为 initialValue 的参数。

将 DropdownButtonFormField 构造函数中的 value 参数替换为 initialValue 参数，以初始化 DropdownButtonFormField.initialValue。

迁移前的代码

DropdownButtonFormField(
  value: 'Yellow',
),

迁移后的代码

DropdownButtonFormField(
  initialValue: 'Yellow',
),

生效版本：3.33.0-1.0.pre
稳定发布版：待定

API 文档

• DropdownButtonFormField
• DropdownButtonFormField.initialValue

相关问题

• 问题 #169983

相关 PR

• 弃用 DropdownButtonFormField 的 value 参数，转而使用 initialValue