modest_pagination 是一个用于 Flutter 的分页管理插件，它可以帮助你轻松地实现分页功能。以下是如何使用 modest_pagination 插件的基本步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 modest_pagination 的依赖：

dependencies:
  flutter:
    sdk: flutter
  modest_pagination: ^0.0.1  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 基本使用

2.1 创建一个分页控制器

modest_pagination 提供了一个 PaginationController 类，你可以使用它来管理分页数据。

import 'package:modest_pagination/modest_pagination.dart';

class MyPaginationController extends PaginationController<MyDataModel> {
  [@override](/user/override)
  Future<List<MyDataModel>> loadPage(int page) async {
    // 在这里实现从服务器或本地加载数据的逻辑
    // 例如，使用 API 请求获取数据
    final response = await api.getData(page);
    return response.data;
  }
}

2.2 在 UI 中使用分页控制器

你可以在 ListView 或 GridView 中使用 PaginationController 来显示分页数据。

import 'package:flutter/material.dart';
import 'package:modest_pagination/modest_pagination.dart';

class MyPaginationPage extends StatefulWidget {
  [@override](/user/override)
  _MyPaginationPageState createState() => _MyPaginationPageState();
}

class _MyPaginationPageState extends State<MyPaginationPage> {
  final MyPaginationController _controller = MyPaginationController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('分页示例'),
      ),
      body: PaginationListView<MyDataModel>(
        controller: _controller,
        itemBuilder: (context, item, index) {
          return ListTile(
            title: Text(item.name),
            subtitle: Text(item.description),
          );
        },
        loadingBuilder: (context) {
          return Center(child: CircularProgressIndicator());
        },
        errorBuilder: (context, error) {
          return Center(child: Text('加载失败: $error'));
        },
      ),
    );
  }
}

3. 高级功能

3.1 自定义加载更多和错误提示

你可以通过 loadingBuilder 和 errorBuilder 来自定义加载更多和错误提示的 UI。

PaginationListView<MyDataModel>(
  controller: _controller,
  itemBuilder: (context, item, index) {
    return ListTile(
      title: Text(item.name),
      subtitle: Text(item.description),
    );
  },
  loadingBuilder: (context) {
    return Padding(
      padding: EdgeInsets.all(16.0),
      child: Center(child: CircularProgressIndicator()),
    );
  },
  errorBuilder: (context, error) {
    return Padding(
      padding: EdgeInsets.all(16.0),
      child: Center(child: Text('加载失败: $error')),
    );
  },
);

3.2 手动触发加载更多

你可以通过 PaginationController 的 loadNextPage 方法手动触发加载更多数据。

_controller.loadNextPage();

3.3 重置分页数据

你可以通过 PaginationController 的 reset 方法重置分页数据。

_controller.reset();

4. 完整示例

import 'package:flutter/material.dart';
import 'package:modest_pagination/modest_pagination.dart';

class MyDataModel {
  final String name;
  final String description;

  MyDataModel(this.name, this.description);
}

class MyPaginationController extends PaginationController<MyDataModel> {
  [@override](/user/override)
  Future<List<MyDataModel>> loadPage(int page) async {
    // 模拟从服务器加载数据
    await Future.delayed(Duration(seconds: 2));
    return List.generate(10, (index) => MyDataModel('Item ${page * 10 + index}', 'Description ${page * 10 + index}'));
  }
}

class MyPaginationPage extends StatefulWidget {
  [@override](/user/override)
  _MyPaginationPageState createState() => _MyPaginationPageState();
}

class _MyPaginationPageState extends State<MyPaginationPage> {
  final MyPaginationController _controller = MyPaginationController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('分页示例'),
      ),
      body: PaginationListView<MyDataModel>(
        controller: _controller,
        itemBuilder: (context, item, index) {
          return ListTile(
            title: Text(item.name),
            subtitle: Text(item.description),
          );
        },
        loadingBuilder: (context) {
          return Padding(
            padding: EdgeInsets.all(16.0),
            child: Center(child: CircularProgressIndicator()),
          );
        },
        errorBuilder: (context, error) {
          return Padding(
            padding: EdgeInsets.all(16.0),
            child: Center(child: Text('加载失败: $error')),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          _controller.loadNextPage();
        },
        child: Icon(Icons.add),
      ),
    );
  }
}

void main() {
  runApp(MaterialApp(
    home: MyPaginationPage(),
  ));
}