shelf_paginate 是一个用于 Dart 服务器端框架 shelf 的分页插件，它可以帮助你轻松地实现分页功能。虽然 shelf_paginate 不是专门为 Flutter 设计的，但你可以在 Flutter 应用中通过调用后端 API 来使用它。下面是如何在 shelf 中使用 shelf_paginate 的示例，以及如何在 Flutter 中进行分页展示。

1. 安装 shelf_paginate

首先，在你的 Dart 服务器项目中安装 shelf_paginate：

dependencies:
  shelf: ^1.0.0
  shelf_paginate: ^1.0.0

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

2. 在 shelf 中使用 shelf_paginate

假设你有一个返回列表数据的 API，并希望对其进行分页。以下是一个简单的示例：

import 'package:shelf/shelf.dart';
import 'package:shelf_paginate/shelf_paginate.dart';
import 'package:shelf_router/shelf_router.dart';

void main() {
  var app = Router();

  // 模拟数据
  final items = List.generate(100, (index) => 'Item ${index + 1}');

  // 分页路由
  app.get('/items', (Request request) {
    return paginate(
      request,
      items,
      pageSize: 10, // 每页显示10条数据
      serializer: (List<String> pageItems, int pageNumber, int totalPages) {
        return {
          'page': pageNumber,
          'total_pages': totalPages,
          'data': pageItems,
        };
      },
    );
  });

  // 启动服务器
  var server = await shelf_io.serve(app, 'localhost', 8080);
  print('Server running on localhost:${server.port}');
}

在这个示例中，paginate 函数会根据 request 中的查询参数（通常是 page 和 perPage）对 items 列表进行分页，并返回分页后的结果。

3. 在 Flutter 中调用 API 并展示分页数据

在 Flutter 中，你可以使用 http 包或其他网络库来调用这个 API，并展示分页数据。以下是一个简单的 Flutter 示例：

import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
import 'dart:convert';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Pagination Demo',
      home: HomePage(),
    );
  }
}

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

class _HomePageState extends State<HomePage> {
  List<String> items = [];
  int currentPage = 1;
  int totalPages = 1;

  Future<void> fetchItems(int page) async {
    final response = await http.get(Uri.parse('http://localhost:8080/items?page=$page'));

    if (response.statusCode == 200) {
      final data = json.decode(response.body);
      setState(() {
        items = List<String>.from(data['data']);
        currentPage = data['page'];
        totalPages = data['total_pages'];
      });
    } else {
      throw Exception('Failed to load items');
    }
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    fetchItems(1);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Pagination Demo'),
      ),
      body: Column(
        children: [
          Expanded(
            child: ListView.builder(
              itemCount: items.length,
              itemBuilder: (context, index) {
                return ListTile(
                  title: Text(items[index]),
                );
              },
            ),
          ),
          Padding(
            padding: const EdgeInsets.all(8.0),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                IconButton(
                  icon: Icon(Icons.arrow_back),
                  onPressed: currentPage > 1
                      ? () {
                          fetchItems(currentPage - 1);
                        }
                      : null,
                ),
                Text('Page $currentPage of $totalPages'),
                IconButton(
                  icon: Icon(Icons.arrow_forward),
                  onPressed: currentPage < totalPages
                      ? () {
                          fetchItems(currentPage + 1);
                        }
                      : null,
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }
}