跳至主要内容

将 useDeleteButtonTooltip 迁移到 Chips 的 deleteButtonTooltipMessage

摘要

#

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

上下文

#

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

更改说明

#

deleteButtonTooltipMessage 属性为芯片组件的删除按钮上的工具提示提供消息。随后,进行了更改,以便将空字符串提供给此属性会禁用工具提示。

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

迁移指南

#

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

迁移前的代码

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