概述

#

使用帶有刪除按鈕的任何 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