将 useDeleteButtonTooltip 迁移到 Chips 的 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