Introduction
Experience a whole new level of convenience with just a single line of wrapping—no complex setup or controller required—for effortless infinite scroll loading.
Important
The Scrollable widget (e.g., ListView, GridView) must use a NestedScrollController or a subclass. Using a regular ScrollController will cause the infinite scroll pagination to fail.
Preview
The GIF below demonstrates the package in action. Please note that due to compression, the animation may appear distorted or choppy.
Why Use This Library?
This package eliminates the usual boilerplate of infinite scroll implementations. Simply wrap your scrollable widget with InfiniteScrollPagination, and it just works. Perfect for adding infinite scroll to lists, grids, or any scrollable content without worrying about controllers or extra setup.
Usage
Note
💡 Some beginners might worry that setting shrinkWrap: true causes ListView or GridView to build all items at once.
In reality, this package ensures lazy building is fully maintained, and objective tests confirm that enabling shrinkWrap has no measurable performance impact.
For those who want a technical and objective explanation, please refer to DESCRIPTION.md for details and evidence.
InfiniteScrollPagination(
reverse: false,
isEnabled: ...,
onLoadMore: ...,
preloadOffset: 500, // Default is zero.
loadingIndicator: ...,
child: ListView.builder(
// Can be set to true if needed (recommended in most cases).
// Lazy building is fully preserved because constraints are enforced internally.
// Enabling this has been measured to have no noticeable performance impact.
shrinkWrap: true,
itemCount: _items.length,
itemBuilder: (context, index) {
return Text(_items[index]);
},
),
),