infinite_paging_widget #

A lightweight Flutter infinite scroll list/grid with load-more pagination.

Pass your items and an onLoadMore callback — when the user scrolls near the bottom, the widget asks for the next page. Supports empty, loading, error, header, footer, pull-to-refresh, and end-of-list slots out of the box.

Features #

• List and grid layouts via PagingDisplayType
• Near-bottom load-more with configurable loadThreshold
• Guards against overlapping load requests
• Empty / loading / error / header / footer / no-more slots
• Optional pull-to-refresh via onRefresh
• Scroll axis, reverse, cache extent, and keyboard dismiss controls
• Optional list separators and external ScrollController
• Zero third-party dependencies beyond Flutter

Install #

dependencies:
  infinite_paging_widget: ^0.2.0

import 'package:infinite_paging_widget/infinite_paging_widget.dart';

Usage #

InfinitePagingWidget<String>(
  items: items,
  hasMore: hasMore,
  isLoading: isLoading,
  onLoadMore: () => loadNextPage(),
  onRefresh: () => refreshFromStart(),
  noMoreWidget: (context) => const Padding(
    padding: EdgeInsets.all(16),
    child: Text('End of list', textAlign: TextAlign.center),
  ),
  itemBuilder: (context, item, index) {
    return ListTile(title: Text(item));
  },
)

Grid #

InfinitePagingWidget<Product>(
  displayType: PagingDisplayType.grid,
  gridCrossAxisCount: 2,
  gridChildAspectRatio: 0.75,
  items: products,
  hasMore: hasMore,
  isLoading: isLoading,
  onLoadMore: loadNextPage,
  itemBuilder: (context, product, index) => ProductCard(product: product),
)

Customization #

Example #

See the example/ app for fake pagination in both list and grid modes, including pull-to-refresh and an end-of-list message.

License #

MIT