将 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