README.md

Infinite Pagination ListView Scrollable

A very lite Flutter Package infinite scroll listview with pagination.

Platforms

This plugin has been successfully tested on iOS, Android & web.

Examples

The following examples are extracted from the example project available in the repository. More examples are available in this project.

Demo of infinite scroll listview with pagination

Features

• Infinite scroll listview.
• Automating Pagination
• Customizable listview item widget.
• Customizable listview initial loading widget.
• Customizable listview more loading widget.
• Customizable listview empty widget.
• Customizable listview error widget.
• Customizable listview when end of list is reached widget.
• To Refresh listview.

Getting started and Usage

We need to two steps to use this package.

1. First step is to create a function to fetch data to use dataFetcher function.
2. Second step is to implement and design the listview to use itemBuilder function.

First Example Model Data Sample String List

          ListviewInfinitePagination<Post>(
            itemBuilder: (index, item) {
              return Text('$index => ${item.title}',
              );
            },
            dataFetcher: (page) => dataFetchMocha(page),
          )
          
          // ####### Data Sample Mocha Function dataFetchMocha
          Future<List<String>> dataFetchMocha(int page) async {
              List<String> testList = [];
              if (page < 4) {
                for (int i = 1 + (page - 1) * 20; i <= page * 20; i++) {
                  testList.add('Item$i of page$page');
                }
              }
              return testList;
          }

Second Example Model with Data Sample Api

          ListviewInfinitePagination<Post>(
            itemBuilder: (index, item) {
              return Text('$index => ${item}');
            },
            dataFetcher: (page) => dataFetchApi(page),
          )
          
          // ####### Data Sample Api Function dataFetchApi
          Future<List<Post>> dataFetchApi(int page) async {
              const String _baseUrl = 'https://jsonplaceholder.typicode.com/posts';
              List<Post> testList = [];
            
              try {
                final res = await http.get(Uri.parse("$_baseUrl?_page=$page&_limit=10"));
                json.decode(res.body).forEach((post) {
                  testList.add(Post.fromJson(post));
                });
              } catch (err) {
                if (kDebugMode) {
                  print('Something went wrong');
                }
              }
              return testList;
          }

API Reference

• Free fake API for testing and prototyping

Get all items

  GET /posts

Parameter	Type	Description
_page	int	Pagination
_limit	int	Offset

[
  { id: 1, title: '...' /* ... */ },
  { id: 2, title: '...' /* ... */ },
  { id: 3, title: '...' /* ... */ },
  /* ... */
  { id: 100, title: '...' /* ... */ },
];

Additional information

LICENSE!

Dropdown Searchable list is MIT-licensed.

Let us know!

I would be happy if you send us feedback on your projects where you use our component. Just email [email protected] and let me know if you have any questions or suggestions about my work.