Skip to main content

将 Chips 的 useDeleteButtonTooltip 迁移到 deleteButtonTooltipMessage

摘要

#

使用任何带有删除按钮的芯片的useDeleteButtonTooltip属性会发出弃用警告,或者在引用时不再存在。这包括ChipInputChipRawChip小部件。

背景

#

ChipInputChipRawChip小部件的useDeleteButtonTooltip属性已被弃用,取而代之的是deleteButtonTooltipMessage,因为后者可用于禁用芯片删除按钮的工具提示。

变更说明

#

deleteButtonTooltipMessage属性为芯片小部件删除按钮上的工具提示提供消息。随后,进行了一项更改,即为此属性提供空字符串可禁用工具提示。

为了避免 API 的冗余,此更改弃用了useDeleteButtonTooltip,该属性正是为此功能而引入的。如果您明确禁用了工具提示,则可以使用Flutter fix来帮助您将现有代码从useDeleteButtonTooltip迁移到deleteButtonTooltipMessage

迁移指南

#

默认情况下,删除按钮的工具提示始终启用。要显式禁用工具提示,请为deleteButtonTooltipMessage属性提供一个空字符串。以下代码片段显示了迁移更改,这些更改适用于ChipInputChipRawChip小部件:

迁移前的代码:

dart
Chip(
  label: const Text('禁用删除按钮工具提示'),
  onDeleted: _handleDeleteChip,
  useDeleteButtonTooltip: false,
);

RawChip(
  label: const Text('启用删除按钮工具提示'),
  onDeleted: _handleDeleteChip,
  useDeleteButtonTooltip: true,
);

迁移后的代码:

dart
Chip(
  label: const Text('禁用删除按钮工具提示'),
  onDeleted: _handleDeleteChip,
  deleteButtonTooltipMessage: '',
);

RawChip(
  label: const Text('启用删除按钮工具提示'),
  onDeleted: _handleDeleteChip,
);

时间线

#

包含的版本:2.11.0-0.1.pre
稳定版本:3.0.0

参考

#

API 文档:

相关 PR: