release_to_trigger 2.0.1 copy "release_to_trigger: ^2.0.1" to clipboard
release_to_trigger: ^2.0.1 copied to clipboard

A general-purpose pull-to-reveal or swipe-to-trigger gesture primitive to reveal hidden content, unlock features, trigger secret vaults, and perform pull-to-refresh actions.

2.0.1 #

New Features & Visual Customizations #

  • Upgrade sensors_plus dependency: Upgraded sensors_plus to version ^7.0.0 to support modern sensor API standards.
  • Named Constructor ReleaseToTrigger.refresh: Dedicated constructor configured for pull-to-refresh with state holding until async Future completion.
  • Multi-Stage Triggers (TriggerStage): Supports threshold stages (e.g., halfway, threshold, overpull) with custom labels, callbacks (onStageReached), and custom textStyle configurations.
  • Secure Combo Lock: Added option to require pointer long-press hold (requireLongPressBeforePull) for a configured duration before dragging is unlocked. Includes glassmorphic radial overlay animations and custom builder support (longPressProgressBuilder).
  • Shake-to-Cancel: Integrates sensors_plus to automatically collapse active drag gestures on device shake (enableShakeToCancel).
  • Real-Time Progress Hook (onProgressTick): Real-time progress tick stream callback for audio pitch, dynamic haptics, or advanced visual effects.
  • Enhanced Visual Customizations:
    • progressBackgroundColor to customize the circular progress track track color.
    • progressStrokeWidth to adjust the circular indicator stroke thickness.
    • padding to customize drawer inner padding alignment.
    • spacing to adjust layout distance between status text and indicators.

Improvements & Fixes #

  • Resolved long press gesture conflict in simulated widget tests by decoupling pointer drag start state initialization from animation timeline launches.
  • Expanded testing suite to 15 robust test cases covering named constructors, stages, lock combinations, haptic mocks, and styling parameters.

2.0.0 #

Breaking Changes #

  • Horizontal Swipe Enabled: enableHorizontalSwipe: true and swipeDirection: Axis.horizontal are now fully functional. Added left parameter to customize horizontal edge gesture starting direction.
  • Enforce pullSensitivityHeight: Gestures now only start if initiated within pullSensitivityHeight pixels from the active edge (top/bottom/left/right).
  • Enforce preventScrollingWhileDragging: Handled via AbsorbPointer wrapping the child widget to prevent scrolling of children lists during active drag sessions.

SDK & Tooling Updates #

  • Bumped minimum Dart SDK constraint to 3.5.0 and Flutter SDK constraint to 3.19.0.
  • Upgraded flutter_lints to ^6.0.0 and removed discontinued pedantic package.

Bug Fixes #

  • Removed unused _rotationAnimation property and its lint warning suppressions.

Documentation & Example #

  • Updated example app to demonstrate horizontal and vertical swipe gesture modes.
  • Added comprehensive widget test suite with coverage for gesture tracking, indicators, scrolling prevention, and sensitivity constraints.

1.0.4 #

  • Package Pubspec File Updated: Package Description Updated

1.0.3 #

  • Enhanced Documentation: Added comprehensive documentation with use cases and examples
  • Improved Example: Created a new Secret Vault demo showcasing advanced features
  • Better Parameter Organization: Reorganized parameters into logical categories
  • Added Parameter Tables: Created tables for better parameter documentation
  • Progress Indicator Showcase: Added detailed examples for each progress indicator type
  • Visual Improvements: Enhanced README with better formatting and structure
  • Package Optimization: Improved package metadata, added issue tracker, and enhanced documentation links
  • Testing Support: Added test dependencies for better code quality
  • Topic Optimization: Refined package topics for better discoverability
  • Issue Reporting: Added clear guidelines for reporting issues
  • Enhanced Progress Indicator Customization: Added support for multiple progress indicator types:
    • Rotating icons with customizable rotation
    • Scaling icons and images
    • Fading icons and images
    • Custom progress widgets
  • Added Icon Support: Can now use icons instead of circular progress
  • Added Image Support: Support for custom images as progress indicators
  • Custom Progress Builder: Added ability to create fully custom progress indicators
  • Improved Animation Control: Better control over rotation, scaling, and fading animations

1.0.2 #

  • Code Formatted: Code formatted using dart format ..

1.0.1 #

  • Added dart documentation comments: For improving code readability added dart documentation comments.
  • Remove withOpacity usage: WithOpacity is now deprecated so migrated from withOpacity to with withAlpha in backgroundColor.

1.0.0 #

  • Improved swipe sensitivity: Improved swipe sensitivity.
  • Added optional haptic feedback: Added haptic feedback for better interaction.
  • Solved known bugs & issues: Solved issues in ios gesture detection.
  • More customizable styling options: Better user experience with customizable styling options added.

0.0.9 #

  • Format According to pub.dev rules: solve ib/release_to_trigger.dart doesn't match the Dart formatter.

0.0.8 #

  • Format According to pub.dev rules: solve ib/release_to_trigger.dart doesn't match the Dart formatter.

0.0.7 #

  • Update package description: package description updated.

0.0.6 #

  • Update package description: package description updated.

0.0.5 #

  • Update readme: reame.md file updated.

0.0.4 #

  • Update readme: reame.md file updated.

0.0.3 #

  • Example added: For better understanding example code added.
  • Customize text: Now customize initial and release text style.
  • circular progress indicator: show or hide circular progress indicator.

0.0.2 #

  • Add License: MIT license added.
  • Improve sensitivity of pull: for better user experience pull sensitivity is improved.

0.0.1 Initial Release #

  • Release to Trigger Action: A Flutter widget designed to capture vertical swipe gestures and trigger a custom action when the user releases the swipe at a defined height. Ideal for refreshing content, loading actions, or any custom user interaction.
  • Configurable Sensitivity: Customize the height sensitivity for detecting a swipe (both at the top or bottom of the screen), allowing you to control how much the user must pull before the action is triggered.
  • Top and Bottom Swipes: Control whether the gesture triggers from the top or bottom of the screen using the top parameter.
  • Swipe Progress Indicator: A circular progress indicator shows swipe progress in real-time, dynamically adjusting based on the distance the user has pulled.
  • Customizable Design: Parameters for customizing colors, background, and text (e.g., initialText and triggeredText) for a personalized look and feel.
  • Callback on Trigger: Execute any custom functionality by providing a callback via the onTrigger parameter, allowing developers to integrate custom actions seamlessly.
18
likes
160
points
413
downloads

Documentation

Documentation
API reference

Publisher

unverified uploader

Weekly Downloads

A general-purpose pull-to-reveal or swipe-to-trigger gesture primitive to reveal hidden content, unlock features, trigger secret vaults, and perform pull-to-refresh actions.

Repository (GitHub)
View/report issues

Topics

#gesture-detection #pull-to-refresh #flutter-widgets #animation #secret-access

License

MIT (license)

Dependencies

flutter, sensors_plus

More

Packages that depend on release_to_trigger