swipeable_dismissible 0.0.1

A fluid, highly customizable, and 1:1 touch-responsive swipe-to-dismiss widget for Flutter.

Swipeable Dismissible

A fluid, highly customizable, and 1:1 touch-responsive swipe-to-dismiss widget for Flutter. It supports multiple action layouts, dynamic over-swipe expansion, smooth fading transitions, and fully custom action widgets.

---

✨ Features

• ⚡ 1:1 Touch Response — Instant fluid drag tracking with zero perceived latency.
• 🎨 Fully Customizable Actions — Customize width, height, colors, border radius, elevation, and shadow colors.
• 🧩 Custom Content Support — Display any widget inside an action using customContent.
• 📐 Multiple Action Layouts — Arrange actions in either a horizontal row or a grid.
• 🎯 Dynamic Expansion — Automatically expands the primary dismiss action during over-swipe while smoothly fading secondary actions.
• 🛡️ Overflow Safe — Prevents RenderFlex overflow during extreme drag gestures.
• 🔔 Swipe Callbacks — Listen to gesture lifecycle events with onSwipeStart, onSwipeUpdate, and onSwipeEnd.

---

📦 Installation

Add the package to your pubspec.yaml:

dependencies:
  swipeable_dismissible: ^0.0.1

Then run:

flutter pub get

---

🚀 Usage

import 'package:flutter/material.dart';
import 'package:swipeable_dismissible/swipeable_dismissible.dart';

SwipeDismissible(
  key: const ValueKey('item_1'),
  borderRadius: BorderRadius.circular(50),
  spacing: 8,
  actionGap: 12,

  onSwipeStart: () {
    print('Started swiping');
  },

  actions: [
    SwipeDismissableAction(
      icon: const Icon(Icons.archive),
      backgroundColor: Colors.blue,
      width: 50,
      height: 50,
      borderRadius: BorderRadius.circular(25),
      onPressed: () {},
    ),

    SwipeDismissableAction(
      icon: const Icon(Icons.star),
      backgroundColor: Colors.amber,
      width: 50,
      height: 50,
      borderRadius: BorderRadius.circular(25),
      onPressed: () {},
    ),

    SwipeDismissableAction(
      icon: const Icon(Icons.delete),
      label: 'Delete',
      backgroundColor: Colors.red,
      width: 70,
      height: 50,
      borderRadius: BorderRadius.circular(50),
      isDismissAction: true,
      onPressed: () {
        // Handle delete operation
      },
    ),
  ],

  child: const ListTile(
    title: Text('Swipeable Item'),
    subtitle: Text('Swipe left to reveal actions'),
  ),
);

---

API Reference

SwipeDismissible

Parameter	Type	Default	Description
child	Widget	Required	Main widget displayed in the foreground (e.g. ListTile, Card).
actions	List<SwipeDismissableAction>	Required	List of action buttons displayed behind the child.
layout	SwipeActionLayout	SwipeActionLayout.row	Layout arrangement for actions (row or grid).
direction	SwipeDirection	SwipeDirection.endToStart	Allowed swipe direction (endToStart, startToEnd, both).
spacing	double	8.0	Space between action buttons.
actionGap	double	12.0	Gap between the child and the action container.
borderRadius	BorderRadiusGeometry?	null	Default border radius applied to actions.
animationDuration	Duration	200ms	Duration of slide and snap animations.
animationCurve	Curve	Curves.easeOutCubic	Animation curve used for transitions.
gridCrossAxisCount	int	2	Number of columns when using grid layout.
gridChildAspectRatio	double	1.0	Child aspect ratio for grid layout.
dismissThresholdRatio	double	0.65	Swipe ratio required to trigger automatic dismissal.
onSwipeStart	VoidCallback?	null	Called when dragging begins.
onSwipeUpdate	ValueChanged<double>?	null	Reports the current drag offset in pixels.
onSwipeEnd	VoidCallback?	null	Called when dragging ends.

---

SwipeDismissableAction

Parameter	Type	Default	Description
onPressed	VoidCallback	Required	Called when the action button is pressed.
icon	Widget?	null	Optional icon displayed inside the action button.
label	String?	null	Optional text label.
labelStyle	TextStyle?	null	Custom text style for the label.
backgroundColor	Color	Colors.red	Background color of the action button.
foregroundColor	Color	Colors.white	Default color for icons and text.
width	double?	60.0	Width of the action button.
height	double?	50.0	Height of the action button.
elevation	double	0.0	Elevation (shadow depth).
shadowColor	Color?	null	Shadow color when elevation is greater than zero.
borderRadius	BorderRadiusGeometry?	null	Border radius of the action button.
padding	EdgeInsetsGeometry?	null	Internal padding around the action content.
isDismissAction	bool	false	Expands this action during a full swipe dismissal.
customContent	Widget?	null	Displays a custom widget instead of the default icon/label layout.

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for more information.