xuelongqy/flutter_easy_refresh
Flutter Easy Refresh
flutter_easy_refresh is a library for implementing pull-to-refresh and infinite scroll pagination within Flutter list components. It provides the functional components and logic required to trigger data reloads via pull-down gestures and fetch additional data chunks through pull-up triggers.
The project features a decoupled indicator architecture that allows for customizable visual styles, themed animations, and flexible positioning of headers and footers. It includes a centralized controller that enables the programmatic management of refresh and loading states independently of user gestures.
The library covers scroll management through customizable physics and inertia, as well as paginated data synchronization to automate the loading of data based on page indices. It also provides integration for nested scroll views to coordinate indicator positions within a view hierarchy.
Features
- List Interaction Patterns - Implements comprehensive mobile list interaction patterns, including pull-to-refresh and infinite scrolling physics.
- Programmatic Action Controls - Includes a controller that allows developers to trigger or finish refresh and load actions programmatically.
- Pagination State Managers - Tracks current page indices internally to automate the triggering of load actions when the list bottom is reached.
- State Controllers - Includes a centralized controller to programmatically manage and synchronize the loading states of refresh and load actions.
- Infinite Scrolling - Implements a pull-up loading system to fetch and append additional data chunks as the user scrolls.
- Pull-to-Refresh Frameworks - Provides a framework for implementing pull-down mechanisms to reload data with customizable headers and animations.
- Pull-Up Loading Indicators - Provides UI components and logic to trigger additional content loading when the user scrolls to the bottom of a list.
- Overscroll Triggers - Uses custom scroll physics to detect overscroll offsets, triggering refresh headers or load footers based on drag distance.
- Scroll State Controllers - Offers APIs to programmatically control the loading and refresh states of the scroll view independently of user gestures.
- Animated Gesture Event Mappings - Maps user scroll offsets directly to animation controllers to synchronize the visual progress of refresh indicators with touch input.
- Indicator Architectures - Provides a decoupled architecture for header and footer indicators, allowing custom animations and themes to be injected independently.
- Indicator Positionings - Enables the placement of refresh or load indicators at specific locations within the scroll view, including nested layouts.
- Inertial Scrolling Physics - Provides mechanisms to adjust scrolling physics and inertia for precise interaction and smooth movement.
- Refresh Indicator Customizations - Allows for the visual modification and styling of refresh and load indicators to match specific application themes.
- Nested Scroll Coordination - Wraps scrollable widgets to intercept notifications and coordinate indicator positions within nested view hierarchies.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
