Skip to main content

停用 'DropdownButtonFormField' 建構函式的 'value' 參數

`DropdownButtonFormField` 建構函式參數 `value` 已被參數 `initialValue` 取代。

摘要

#

DropdownButtonFormField 建構函式的 value 參數已被棄用,建議改用 initialValue 參數。

背景說明

#

DropdownButtonFormField 建構函式的 value 參數過去用來初始化 DropdownButtonFormField.initialValue。 由於參數名稱不一致,造成了混淆。例如,開發者可能誤以為設定 value 會變更目前選取的值,但實際上並非如此——它僅會設定初始值,或在欄位重設時生效。

變更說明

#

DropdownButtonFormField 建構函式的 value 參數現已棄用,請改用名為 initialValue 的參數。

遷移指南

#

請將 DropdownButtonFormField 建構函式中的 value 參數,替換為 initialValue 參數,以初始化 DropdownButtonFormField.initialValue

遷移前的程式碼:

dart
DropdownButtonFormField(
  value: 'Yellow',
),

遷移後的程式碼:

dart
DropdownButtonFormField(
  initialValue: 'Yellow',
),

時程

#

合併於版本:3.35.0-0.0.pre
正式版釋出:3.35

參考資料

#

API 文件:

相關議題:

相關 PR: