Dismissible 簡介

Dismissible 是 Flutter 中用于實現(xiàn)可滑動刪除或拖拽操作的一個有用的小部件。主要用于在用戶對列表項或任何其他可滑動的元素執(zhí)行刪除或拖動操作時，提供一種簡便的實現(xiàn)方式。

使用場景

• 列表項刪除： 允許用戶在列表中通過滑動手勢刪除某個項。
• 左右滑動： 提供可自定義的背景，當用戶左滑或右滑時顯示。
• 拖拽排序： 可用于實現(xiàn)拖拽排序，當用戶長按并拖動列表項時，可以將其拖到新的位置。
• 任何需要滑動手勢操作的場景： 適用于需要使用滑動手勢進行操作的任何場景。

常用屬性

• key (Key? key): 小部件的標識符。通常使用數(shù)據(jù)項的唯一標識作為 key。

• child (Widget child): 被包裹的小部件，即可滑動刪除或拖拽的內容。

• onDismissed (void Function(DismissDirection direction)? onDismissed): 在滑動操作完成時調用的回調函數(shù)?；卣{參數(shù) direction 表示滑動的方向，是 DismissDirection 枚舉的一個值。

• direction (DismissDirection direction): 定義可滑動的方向。默認為 DismissDirection.horizontal，即水平方向。可以選擇 DismissDirection.vertical、DismissDirection.endToStart、DismissDirection.startToEnd、DismissDirection.up、DismissDirection.down。

• resizeDuration (Duration? resizeDuration): 控制小部件大小調整的動畫時間。如果設置為 null，則禁用動畫，小部件的大小將立即調整。默認值為 const Duration(milliseconds: 200)。

• dismissThresholds (Map<DismissDirection, double>? dismissThresholds): 定義滑動多遠觸發(fā) onDismissed 回調的閾值。鍵是 DismissDirection 枚舉值，值是一個 double 類型，表示滑動的百分比。例如，{ DismissDirection.endToStart: 0.5 } 表示向左滑動超過 50% 觸發(fā)回調。

• movementDuration (Duration? movementDuration): 定義調整小部件位置的動畫時間。默認為 const Duration(milliseconds: 200)。

• crossAxisEndOffset (double crossAxisEndOffset): 當 direction 為 DismissDirection.horizontal 時，定義小部件在縱軸方向的偏移。正值表示向下偏移，負值表示向上偏移。默認為 0。

• background (Widget? background): 定義在拖動時顯示的背景。通常是一個按鈕或圖標，用于執(zhí)行刪除等操作。

• secondaryBackground (Widget? secondaryBackground): 定義在拖動時顯示的輔助背景，通常是一個按鈕或圖標，用于執(zhí)行其他操作。當 direction 為 DismissDirection.horizontal 時，這是顯示在右側的背景。

• confirmDismiss (Future Function(DismissDirection direction)? confirmDismiss): 一個可選的回調函數(shù)，用于在實際執(zhí)行滑動刪除或拖拽之前確認是否執(zhí)行。如果返回 true，則執(zhí)行刪除或拖拽操作；如果返回 false，則取消操作。回調參數(shù) direction 表示滑動的方向。

• dragStartBehavior (DragStartBehavior? dragStartBehavior): 定義在拖動開始時處理拖動的方式。默認為 DragStartBehavior.start。

• crossAxisStartDragOffset (double crossAxisStartDragOffset): 定義在縱軸方向上開始拖動的偏移量。正值表示向下偏移，負值表示向上偏移。默認為 0。

• movementDurationVsCurrent} (bool? movementDurationVsCurrent): 在處理滑動時，如果設置為 true，將使用當前小部件的尺寸來計算移動的距離，而不是使用小部件被滑動前的尺寸。默認為 false。

這些屬性提供了很多靈活性，可以根據(jù)具體需求來定制滑動刪除或拖拽的交互效果。在使用時，根據(jù)具體情況選擇合適的屬性進行配置。

基本用法舉例

Dismissible(key: Key(item.id.toString()), // 唯一標識，通常使用數(shù)據(jù)項的唯一標識onDismissed: (direction) {// 在用戶滑動時調用，可以在這里執(zhí)行刪除等操作// direction 表示滑動的方向，是DismissDirection的枚舉值之一// DismissDirection.horizontal 表示水平滑動// DismissDirection.vertical 表示垂直滑動// DismissDirection.endToStart 表示從右向左滑動（LTR語言環(huán)境）// DismissDirection.startToEnd 表示從左向右滑動（LTR語言環(huán)境）// DismissDirection.up 表示從下向上滑動// DismissDirection.down 表示從上向下滑動},background: Container(color: Colors.red, // 右滑或左滑時顯示的背景顏色child: Icon(Icons.delete),),child: ListTile(title: Text(item.title),// 其他列表項的內容),
);

在這個例子中，Dismissible 包裹了一個 ListTile，表示列表中的一項。當用戶滑動這個項時，onDismissed 回調會被觸發(fā)，你可以在這里執(zhí)行刪除等操作。background 屬性定義了右滑或左滑時顯示的背景，可以包含圖標、文字等。

注意事項

• key 是必需的，通常使用數(shù)據(jù)項的唯一標識。這是用來標識 Dismissible 的唯一性，以確保正確的刪除和排序。
• 在 onDismissed 回調中，你需要執(zhí)行具體的操作，例如從數(shù)據(jù)列表中刪除對應的項。
• direction 參數(shù)表示滑動的方向，可以用于根據(jù)不同的方向執(zhí)行不同的操作。
• background 屬性定義了滑動時顯示的背景，通常用來表示刪除操作。
  總的來說，Dismissible 是一個非常實用的小部件，方便實現(xiàn)一些常見的滑動手勢操作，特別適用于列表中的項。

---

結束語 Flutter是一個由Google開發(fā)的開源UI工具包，它可以讓您在不同平臺上創(chuàng)建高質量、美觀的應用程序，而無需編寫大量平臺特定的代碼。我將學習和深入研究Flutter的方方面面。從基礎知識到高級技巧，從UI設計到性能優(yōu)化，歡飲關注一起討論學習，共同進入Flutter的精彩世界！