flutter_slidable

Add flutter_slidable to your pubspec.yaml dependencies and import it into your Dart files.

dependencies:
  flutter_slidable: <latest_version>

import 'package:flutter_slidable/flutter_slidable.dart';

Use a SlidableController to open or close action panes via code. Pass the controller instance to the Slidable widget's controller property.

final controller = SlidableController();

// ...

Slidable(
  controller: controller,
  // ...
);

// ...

// Open the actions
void _handleOpen() {
  controller.openEndActionPane();
  // OR
  //controller.openStartActionPane();
}

void _handleClose() {
  controller.close();
}

The motion parameter in an ActionPane defines how the actions animate when the user drags the Slidable. Available motions include:

• BehindMotion: Actions appear as if they are behind the Slidable.
• DrawerMotion: Actions animate as if they were drawers.
• ScrollMotion: Actions follow the Slidable while it is moving.
• StretchMotion: Actions animate as if they were being stretched.

If you encounter a FlutterError stating "A dismissed Slidable widget is still part of the tree.", it means the Slidable widget was not removed from the widget tree immediately after the dismissal animation completed.

To fix this:

1. Ensure you have implemented the onDismissed handler within your ActionPane.
2. Immediately remove the Slidable widget from your application's widget tree once the onDismissed handler has fired.

You can access the ambient data of the current ActionPane from its children using the static ActionPane.of(context) method. This returns an ActionPaneData object containing:

• extentRatio: The total extent of the pane relative to the enclosing Slidable.
• alignment: The Alignment used by the pane.
• direction: The Axis in which the slidable moves.
• fromStart: A boolean indicating if this is the start action pane.
• children: The list of action widgets in this pane.

The SlidableController exposes several ValueNotifier properties that you can listen to for reacting to state changes:

• actionPaneType: A ValueNotifier<ActionPaneType> indicating if the current pane is start, end, or none.
• direction: A ValueNotifier<int> representing movement direction (-1 for left, 0 for stationary, 1 for right).
• endGesture: A ValueNotifier<EndGesture?> that tracks the end of a gesture (e.g., OpeningGesture, ClosingGesture, or StillGesture).
• dismissGesture: A ValueNotifier<DismissGesture?> tracking dismissal intentions.
• resizeRequest: A ValueNotifier<ResizeRequest?> that emits when a dismiss() call completes, providing a duration and a callback.

To manually trigger a notification within a SlidableGroupBehavior scope, use the SlidableGroupNotification static methods. This is useful for custom interactions or sending a final notification during a widget's disposal.

• dispatch<T>(BuildContext context, T notification, {bool assertParentExists = true}): Sends a notification of type T to the nearest SlidableGroupBehavior<T>.
• createDispatcher<T>(BuildContext context, {bool assertParentExists = true}): Returns a SlidableGroupNotificationDispatcher<T> which can be used to call .dispatch(notification) later (e.g., after a BuildContext is no longer valid for direct dispatch).

The Slidable widget allows users to drag a widget to reveal contextual actions (panes). You can define a startActionPane and/or an endActionPane to show different actions depending on the drag direction.

Key properties:

• enabled: Set to false to disable interaction.
• closeOnScroll: If true, the slidable closes when the nearest Scrollable moves.
• direction: The axis of movement (Axis.horizontal or Axis.vertical).
• groupTag: Use a shared object for multiple Slidable widgets to ensure only one in the group is open at a time.
• useTextDirection: If true (and direction is horizontal), the panes are positioned based on the ambient TextDirection (LTR/RTL).

Use SlidableGroupBehavior<T> to create a scope for a group of Slidable widgets. This allows you to coordinate state or listen to notifications (like a specific slide action) across multiple Slidables within the same tree branch.

• onNotification: A callback T? Function(T notification)? that can intercept and modify a notification before it is dispatched. If it returns null, the notification is suppressed.
• child: The widget tree containing the Slidables that belong to this group.