ripple_action_button 1.1.3 ripple_action_button: ^1.1.3 copied to clipboard
A versatile, state-driven button widget with ripple effects for Flutter. Supports idle, loading, success, and error states with full customization.
Changelog #
1.1.3 Small changes #
Fixed #
- Updated license file to replace placeholders with the correct copyright year and owner information.
- Fixed line indentation in the
example.md
file for better readability.
1.1.2 Small change #
Fixed #
- Corrected the version number mentioned in the README file to match the latest version of the package.
1.1.1 Small changes #
- Fixed formatting issues to comply with Dart formatter.
- Resolved static analysis warnings to improve package quality.
Version 1.1.0 - Enhancements and Bug Fixes #
New Features #
-
Enabled Property:
- Added
enabled
property to control whether the button is interactive. - Adjusts button opacity when disabled for visual feedback.
- Added
-
Ripple Customization:
- Introduced
rippleSplashFactory
for advanced customization of ripple behavior usingInteractiveInkFeatureFactory
.
- Introduced
Improvements #
-
Press Handling:
- Updated
_handlePress
method to respect the newenabled
property, preventing interaction when the button is disabled.
- Updated
-
Visual Feedback:
- Enhanced
build
method to dynamically adjust button opacity based onenabled
state.
- Enhanced
Bug Fixes #
- Fixed potential edge cases in state transitions ensuring smoother and more predictable animations.
Version 1.0.0 - Initial Release #
Features #
-
Button States:
- Supports multiple states:
idle
,loading
,success
, anderror
. - Transitions between states with customizable animations and durations.
- Supports multiple states:
-
Customization:
- Define custom widgets for each state.
- Configurable ripple effects, including color, opacity, and splash settings.
- Customizable button dimensions, decorations, and animation curves.
-
Callbacks:
- Includes lifecycle callbacks for each state:
onIdle
,onLoading
,onSuccess
, andonError
. - Provides
onPressed
to execute async tasks with success/error feedback. onComplete
to notify when the button task finishes, including status.
- Includes lifecycle callbacks for each state:
-
Error Handling:
- Graceful exception handling with
onException
callback.
- Graceful exception handling with
-
Responsive Design:
- Automatically adapts button size or allows explicit width/height settings.
- Auto-hides keyboard upon interaction if enabled.
-
Accessibility:
- Includes semantic labels for better accessibility support.
-
Utilities:
- Programmatically simulate button clicks using
simulateClick()
.
- Programmatically simulate button clicks using