LazyRefreshingListView #

A customizable Flutter widget built on top of pull_to_refresh_flutter3 that simplifies the implementation of pull-to-refresh and infinite scrolling (lazy loading) for any scrollable child, like a ListView.

✨ Features #

• ✅ Pull-to-refresh support
• ✅ Infinite scroll loading
• ✅ Custom loader and no-more-data message
• ✅ Easily pluggable into any scrollable widget
• ✅ Clean API with sensible defaults
• ✅ Full control over styling and layout

🧱 Installation #

Add this to your pubspec.yaml:

dependencies:
  lazy_refreshing_list_view: ^1.0.0

Then run:

flutter pub get

🔧 Usage #

import 'package:lazy_refreshing_list_view/lazy_refreshing_list_view.dart';

LazyRefreshingListView(
  onRefresh: () async {
    // Your refresh logic here
  },
  onLoading: () async {
    // Return true if more data is available, false otherwise
    return false;
  },
  child: ListView.builder(
    itemCount: 20,
    itemBuilder: (context, index) => ListTile(title: Text('Item #$index')),
  ),
);

📌 Parameters #

🔄 Example #

Here's a full working example:

class MyListPage extends StatelessWidget {
  final List<String> items = List.generate(20, (i) => 'Item $i');

  Future<void> _refresh() async {
    await Future.delayed(Duration(seconds: 2));
    // refresh your data here
  }

  Future<bool> _loadMore() async {
    await Future.delayed(Duration(seconds: 2));
    // return false when no more data is available
    return false;
  }

  @override
  Widget build(BuildContext context) {
    return LazyRefreshingListView(
      onRefresh: _refresh,
      onLoading: _loadMore,
      child: ListView.builder(
        itemCount: items.length,
        itemBuilder: (context, index) => ListTile(title: Text(items[index])),
      ),
    );
  }
}

💡 Tip #

This widget uses the pull_to_refresh_flutter3 package under the hood. You can customize it further using that package’s capabilities.

📃 License #

MIT © 2025 Faysal Ahmed