概述

#

使用带有删除按钮的任何 Chip 的 useDeleteButtonTooltip 会导致弃用警告,或者在使用时不再存在。这包括 ChipInputChipRawChip 小部件。

背景

#

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

变更说明

#

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

为了避免 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