將 Chips 的 useDeleteButtonTooltip 遷移到 deleteButtonTooltipMessage
概述
#使用帶有刪除按鈕的任何 Chip 的 useDeleteButtonTooltip 會導致棄用警告,或者在使用時不再存在。這包括 Chip、InputChip 和 RawChip 小部件。
背景
#Chip、InputChip 和 RawChip 小部件的 useDeleteButtonTooltip 已棄用,取而代之的是 deleteButtonTooltipMessage,因為後者可用於停用 Chip 刪除按鈕的工具提示。
變更說明
#deleteButtonTooltipMessage 屬性為 Chip 小部件刪除按鈕上的工具提示提供訊息。隨後,我們進行了一項更改,將空字串傳遞給此屬性即可停用工具提示。
為了避免 API 重複,此更改棄用了 useDeleteButtonTooltip,該屬性最初是為了實現此確切功能而引入的。如果您之前已明確停用工具提示,可以使用 Flutter fix 來幫助您將現有程式碼從 useDeleteButtonTooltip 遷移到 deleteButtonTooltipMessage。
遷移指南
#預設情況下,刪除按鈕的工具提示始終啟用。要明確停用工具提示,請將空字串傳遞給 deleteButtonTooltipMessage 屬性。以下程式碼段展示了遷移更改,這些更改適用於 Chip、InputChip 和 RawChip 小部件。
遷移前的程式碼
dart
Chip(
label: const Text('Disabled delete button tooltip'),
onDeleted: _handleDeleteChip,
useDeleteButtonTooltip: false,
);
RawChip(
label: const Text('Enabled delete button tooltip'),
onDeleted: _handleDeleteChip,
useDeleteButtonTooltip: true,
);遷移後的程式碼
dart
Chip(
label: const Text('Disabled delete button tooltip'),
onDeleted: _handleDeleteChip,
deleteButtonTooltipMessage: '',
);
RawChip(
label: const Text('Enabled delete button tooltip'),
onDeleted: _handleDeleteChip,
);時間線
#已於版本:2.11.0-0.1.pre 落地
穩定版本:3.0.0
參考資料
#API 文件
相關 PR