Migrate useDeleteButtonTooltip to deleteButtonTooltipMessage of Chips

Using useDeleteButtonTooltip of any chip that has a delete button gives a deprecation warning, or no longer exists when referenced. This includes the Chip, InputChip, and RawChip widgets.

The useDeleteButtonTooltip of Chip, InputChip, and RawChip widgets is deprecated in favor of deleteButtonTooltipMessage, as the latter can be used to disable the tooltip of the chip's delete button.

The deleteButtonTooltipMessage property provides a message to the tooltip on the delete button of the chip widgets. Subsequently, a change was made such that providing an empty string to this property disables the tooltip.

To avoid redundancy of the API, this change deprecated useDeleteButtonTooltip, which was introduced for this exact functionality. A Flutter fix is available to help you migrate existing code from useDeleteButtonTooltip to deleteButtonTooltipMessage, if you explicitly disabled the tooltip.

By default, the tooltip of the delete button is always enabled. To explicitly disable the tooltip, provide an empty string to the deleteButtonTooltipMessage property. The following code snippets show the migration changes, which are applicable for Chip, InputChip, and RawChip widgets:

Code before migration:

Chip(
  label: const Text('Disabled delete button tooltip'),
  onDeleted: _handleDeleteChip,
  useDeleteButtonTooltip: false,
);

RawChip(
  label: const Text('Enabled delete button tooltip'),
  onDeleted: _handleDeleteChip,
  useDeleteButtonTooltip: true,
);

Code after migration:

Chip(
  label: const Text('Disabled delete button tooltip'),
  onDeleted: _handleDeleteChip,
  deleteButtonTooltipMessage: '',
);

RawChip(
  label: const Text('Enabled delete button tooltip'),
  onDeleted: _handleDeleteChip,
);

Landed in version: 2.11.0-0.1.pre
In stable release: 3.0.0

API documentation:

• Chip
• InputChip
• RawChip

Relevant PR:

• Deprecate useDeleteButtonTooltip for Chips

Unless stated otherwise, the documentation on this site reflects the latest stable version of Flutter. Page last updated on 2024-04-04. View source or report an issue.