停用 'DropdownButtonFormField' 建構函式的 'value' 參數
`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.35.0-0.0.pre
正式版釋出:3.35
參考資料
#API 文件:
相關議題:
相關 PR:
Unless stated otherwise, the documentation on this site reflects Flutter 3.44.0. Page last updated on 2026-06-14. View source or report an issue.