Saltar al contenido principal

Migrar useDeleteButtonTooltip a deleteButtonTooltipMessage de Chips

Se ha puesto en desuso useDeleteButtonTooltip en los chips que tienen un botón de eliminación en favor de deleteButtonTooltipMessage.

Resumen

#

Utilizar useDeleteButtonTooltip en cualquier chip que tenga un botón de eliminación genera una advertencia de depreciación, o ya no existe cuando se hace referencia a él. Esto incluye los Widgets Chip, InputChip y RawChip.

Contexto

#

La propiedad useDeleteButtonTooltip de los Widgets Chip, InputChip y RawChip se ha puesto en desuso en favor de deleteButtonTooltipMessage, ya que este último puede utilizarse para desactivar el tooltip del botón de eliminación del chip.

Descripción del cambio

#

La propiedad deleteButtonTooltipMessage proporciona un mensaje para el tooltip en el botón de eliminación de los Widgets de chip. Posteriormente, se realizó un cambio de manera que proporcionar una cadena vacía a esta propiedad desactiva el tooltip.

Para evitar la redundancia de la API, este cambio puso en desuso useDeleteButtonTooltip, el cual se introdujo para esta funcionalidad exacta. Una solución de Flutter está disponible para ayudarte a migrar el código existente de useDeleteButtonTooltip a deleteButtonTooltipMessage, si desactivaste explícitamente el tooltip.

Guía de migración

#

Por defecto, el tooltip del botón de eliminación está siempre activado. Para desactivar explícitamente el tooltip, proporciona una cadena vacía a la propiedad deleteButtonTooltipMessage. Los siguientes fragmentos de código muestran los cambios de migración, los cuales son aplicables para los Widgets Chip, InputChip y RawChip:

Código antes de la migración:

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,
);

Código después de la migración:

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

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

Timeline

#

Llegó en la versión: 2.11.0-0.1.pre
En la versión estable: 3.0.0

Referencias

#

Documentación de la API:

PR relevante: