paging_plus 0.0.1-alpha.1
paging_plus: ^0.0.1-alpha.1 copied to clipboard
Lightweight and intuitive package for pagination and paging management. Easy-to-use utilities for handling page numbers, item counts, and load more functionality in Flutter and Dart applications.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.0.1-alpha.1 - 2025-11-02 #
Added #
- Initial alpha release of the
paging_pluspackage Pageclass for representing a single page in a paginated dataset- Constructor:
Page(pageNumber, count, remainingsCount) - Properties:
pageNumber,count,remainingsCount,hasRemaining,pageSize,currentTotalCount,expectedTotalCount - Factory method:
Page.latestPage(itemCount, pageSize)- creates the latest page based on item count - Static method:
Page.getPages(itemCount, pageSize)- generates all pages for a dataset
- Constructor:
Pagingclass for intelligent pagination request calculation- Constructor:
Paging(pageNumber, pageSize, shouldHasDuplicates) - Factory method:
Paging.next()with optimization options - Support for optimized pagination to minimize redundant data fetching
- GCD-based algorithm for efficient page size calculation
- Constructor:
- Built on Equatable for easy comparison and testing
- Comprehensive dartdoc documentation for all classes and methods
- Detailed README.md with:
- Installation instructions
- Usage examples for basic and advanced scenarios
- Practical examples (infinite scroll, REST API pagination, Flutter ListView)
- Complete API reference
- Explanation of pagination optimization
- Example code demonstrating real-world use cases
- Comprehensive unit tests covering all features
Features #
- ๐ Calculate detailed page information from item counts
- ๐ Intelligently determine the next page to fetch
- โก Minimize redundant data fetching with optimized pagination
- ๐ Built-in support for "load more" functionality
- ๐ฏ Type safe with null safety support
- ๐ Built on Equatable for easy comparison
- โก Lightweight with minimal dependencies
- ๐งช Comprehensive test coverage