概述

#

在任何带有删除按钮的 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