将 useDeleteButtonTooltip 迁移到 Chips 的 deleteButtonTooltipMessage
摘要
#使用任何带有删除按钮的芯片的 useDeleteButtonTooltip
会给出弃用警告,或者在引用时不再存在。这包括 Chip
、InputChip
和 RawChip
组件。
上下文
#Chip
、InputChip
和 RawChip
组件的 useDeleteButtonTooltip
已被弃用,取而代之的是 deleteButtonTooltipMessage
,因为后者可用于禁用芯片删除按钮的工具提示。
更改说明
#deleteButtonTooltipMessage
属性为芯片组件的删除按钮上的工具提示提供消息。随后,进行了更改,以便将空字符串提供给此属性会禁用工具提示。
为了避免 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
除非另有说明,否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新于 2024-04-04。 查看源代码 或 报告问题.