full_swipe_back_gesture 0.1.0

full_swipe_back_gesture: ^0.1.0 copied to clipboard

full_swipe_back_gesture #

iOS-style full-screen back swipe gesture PageRoute that solves the horizontal scroll conflict problem. Unlike standard Flutter navigation where horizontal scrollables (PageView, ListView) compete with and block back gestures, this package enables seamless back swiping from anywhere on the screen while preserving natural horizontal scroll behavior.

Installation #

dependencies:
  full_swipe_back_gesture: ^0.1.0

Usage #

import 'package:full_swipe_back_gesture/full_swipe_back_gesture.dart';

Navigator.of(context).push(
  BackSwipePageRoute(
    builder: (_) => const DetailPage(),
  ),
);

Key Features

• Full-screen swipe: Back gesture works from anywhere on the screen, not just the edge
• Smart conflict resolution: Automatically detects when horizontal scrollables are at their left boundary
• iOS-like behavior: Edge swipes always trigger back gesture regardless of scrollable state
• Customizable: Adjust edge width, transition curves, and durations

Configuration Options

• edgeStartWidthPx: Width from left edge where back gesture always starts (default: 24.0px)
• pushCurve / popCurve: Animation curves for push/pop transitions
• transitionDuration / reverseTransitionDuration: Animation durations

How It Works #

• Edge swipes: Always trigger back gesture regardless of horizontal scrollable state
• Non-edge swipes: Only trigger back gesture when the topmost horizontal scrollable is at its left boundary
• Gesture completion: Uses velocity (>900px/s) or distance (>50% screen width) to determine pop action

Examples #

Check the example/ app to see the package working with various layouts including PageView, nested scrollables, and long lists.

License #

MIT