infinite_scroll_pagination 5.0.0

Lazily load and display pages of items as the user scrolls down your screen.

5.0.0 - 2025-02-24

Added

• PagingListener widget to connect a PagingController to a PagedLayoutBuilder.

Changed

• PagingController no longer has addPageRequestListener method and firstPageKey parameter. Use the fetchPage parameter of the constructor instead.
• PagingController no longer has the itemList, error, and nextPageKey getters and setters. All values are now stored in PagingState.
• PagingController no longer has the appendPage and appendLastPage methods. Use the copyWith method of PagingState to update its pages, keys, and hasNextPage fields.
• PagingController no longer has the retryLastFailedRequest method. You can simply call fetchNextPage to try again.
• PagingController no longer has the invisibleItemsThreshold field. It is now configured in PagedChildBuilderDelegate.
• PagingController now features getters matching the fields of PagingState as well as mapItems to modify the items.
• PagedLayoutBuilder no longer accepts pagingController as a parameter. It now takes PagingState and fetchNextPage instead.
• PagingState now uses pages (List<List<ItemType>>) instead of itemList (List<ItemType>). A new extension getter items is provided for flattening.
• PagingState now features keys, a list storing all fetched keys, and hasNextPage replacing nextPageKey.
• PagingState now includes isLoading, which tracks whether a request is in progress.
• PagingState now provides error as type Object? instead of dynamic.
• PagingState now includes mapItems and filterItems extension methods for modifying items conveniently.

Fixed

• PagingController now deduplicates requests.
• PagingController refresh operations now cancel previous requests.
• Off-by-one error in invisibleItemsThreshold calculation.
• Failure to trigger page request when invisibleItemsThreshold is too large.
• Animating between states with animateTransitions.

4.1.0 - 2024-11-09

Added

• PagedSliverMasonryGrid.

Changed

• Updates example.

Removed

• pubspec.lock from version control.

4.0.0 - 2023-08-17

Added

• PagedMasonryGridView.
• PagedPageView.
• Support for the box protocol in PagedLayoutBuilder.

Changed

• Renames PagedSliverBuilder to PagedLayoutBuilder.

3.2.0 - 2022-05-23

Changed

• Migrates to Flutter 3.

3.1.0 - 2021-07-04

Added

• animated status transitions.

3.0.1+1 - 2021-05-23

Added

• Flutter Favorite status to the README.

3.0.1 - 2021-03-08

Added

• New unit tests.

Changed

• Updates sliver_tools dependency.

Fixed

• Code formatting in ListenableListener.

3.0.0 - 2021-03-04

Changed

• Promotes null safety to stable release.
• Migrates example project to null safety.
• Migrates code samples to null safety.

3.0.0-nullsafety.0 - 2021-02-06

Changed

• Migrates to null safety.

2.3.0 - 2021-01-15

Added

• alternative constructor to PagingController receiving an initial PagingState.

Changed

• Cookbook file name.
• LICENSE file.

2.2.4 - 2021-01-08

Fixed

• New page requests happening before the end of the current frame.

2.2.3 - 2020-12-14

Fixed

• Bug in which manually resetting to a previous page would stop requesting subsequent pages.

2.2.2 - 2020-11-04

Added

• Condition to avoid requesting the first page when there are preloaded items.

2.2.1 - 2020-10-21

Added

• shrinkWrapFirstPageIndicators property to PagedSliverList, PagedSliverGrid, and PagedSliverBuilder.

Changed

• Improve error message displayed when calling a disposed PagingController.

Fixed

• Separator being displayed on completed lists.

2.2.0+1 - 2020-10-19

Changed

• Constraints the Flutter SDK dependency to a minimum version of 1.22.0.

2.2.0 - 2020-10-18

Added

• New constructor parameters from ScrollView to PagedListView and PagedGridView.

2.1.0+1 - 2020-10-13

Added

• Link to raywenderlich.com tutorial.

Changed

• Examples to async/await.

2.1.0 - 2020-10-10

Added

• noMoreItemsIndicatorBuilder to PagedChildBuilderDelegate.
• Properties to both grid widgets to let you choose whether to display the progress, error, and completed listing indicators as grid items or below the grid, as in the list widgets.

2.0.1 - 2020-10-03

Fixed

• PagingController not calling its status listeners.

2.0.0 - 2020-10-02

Changed

• BREAKING CHANGE: Replaces PagedDataSource and PagedStateChangeListener with PagingController, favoring composition over inheritance.

1.1.1 - 2020-09-23

Removed

• Scroll from first page progress indicator, first page error indicator, and no items found indicator.

1.1.0 - 2020-09-18

Added

• PagedStateChangeListener.

1.0.0+2 - 2020-08-22

Added

• Documentation to PagedDataSource properties.

Changed

• README images reference URL.

1.0.0+1 - 2020-08-22

Added

• Images to README.md.
• Initial release.