将 Chips 的 useDeleteButtonTooltip 迁移到 deleteButtonTooltipMessage
摘要
#使用任何带有删除按钮的芯片的useDeleteButtonTooltip
属性会发出弃用警告,或者在引用时不再存在。这包括Chip
、InputChip
和RawChip
小部件。
背景
#Chip
、InputChip
和RawChip
小部件的useDeleteButtonTooltip
属性已被弃用,取而代之的是deleteButtonTooltipMessage
,因为后者可用于禁用芯片删除按钮的工具提示。
变更说明
#deleteButtonTooltipMessage
属性为芯片小部件删除按钮上的工具提示提供消息。随后,进行了一项更改,即为此属性提供空字符串可禁用工具提示。
为了避免 API 的冗余,此更改弃用了useDeleteButtonTooltip
,该属性正是为此功能而引入的。如果您明确禁用了工具提示,则可以使用Flutter fix来帮助您将现有代码从useDeleteButtonTooltip
迁移到deleteButtonTooltipMessage
。
迁移指南
#默认情况下,删除按钮的工具提示始终启用。要显式禁用工具提示,请为deleteButtonTooltipMessage
属性提供一个空字符串。以下代码片段显示了迁移更改,这些更改适用于Chip
、InputChip
和RawChip
小部件:
迁移前的代码:
Chip(
label: const Text('禁用删除按钮工具提示'),
onDeleted: _handleDeleteChip,
useDeleteButtonTooltip: false,
);
RawChip(
label: const Text('启用删除按钮工具提示'),
onDeleted: _handleDeleteChip,
useDeleteButtonTooltip: true,
);
迁移后的代码:
Chip(
label: const Text('禁用删除按钮工具提示'),
onDeleted: _handleDeleteChip,
deleteButtonTooltipMessage: '',
);
RawChip(
label: const Text('启用删除按钮工具提示'),
onDeleted: _handleDeleteChip,
);
时间线
#包含的版本:2.11.0-0.1.pre
稳定版本:3.0.0
参考
#API 文档:
相关 PR:
除非另有说明,否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。 查看源代码 或 报告问题。