flutter_easy_navigation_list 是一个用于简化 Flutter 应用中导航列表管理的插件。它提供了一种简单的方式来管理和导航列表项，特别适用于需要处理大量数据或复杂导航逻辑的场景。

安装

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

dependencies:
  flutter:
    sdk: flutter
  flutter_easy_navigation_list: ^1.0.0  # 请使用最新版本

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

基本使用

1. 导入包

import 'package:flutter_easy_navigation_list/flutter_easy_navigation_list.dart';

2. 创建导航列表

你可以使用 EasyNavigationList 来创建一个导航列表。以下是一个简单的示例：

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Easy Navigation List'),
      ),
      body: EasyNavigationList(
        items: items,
        itemBuilder: (context, item, index) {
          return ListTile(
            title: Text(item),
            onTap: () {
              Navigator.push(
                context,
                MaterialPageRoute(
                  builder: (context) => DetailPage(item: item),
                ),
              );
            },
          );
        },
      ),
    );
  }
}

3. 处理导航

在上面的示例中，当用户点击列表项时，会导航到一个新的页面 DetailPage。你可以根据需要在 DetailPage 中显示更多的信息。

class DetailPage extends StatelessWidget {
  final String item;

  DetailPage({required this.item});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Detail Page'),
      ),
      body: Center(
        child: Text('You selected: $item'),
      ),
    );
  }
}

高级功能

1. 自定义分隔符

你可以通过 separatorBuilder 来自定义列表项之间的分隔符：

EasyNavigationList(
  items: items,
  itemBuilder: (context, item, index) {
    return ListTile(
      title: Text(item),
      onTap: () {
        Navigator.push(
          context,
          MaterialPageRoute(
            builder: (context) => DetailPage(item: item),
          ),
        );
      },
    );
  },
  separatorBuilder: (context, index) {
    return Divider(
      color: Colors.grey,
      height: 1,
    );
  },
)

2. 自定义滚动行为

你可以通过 scrollController 和 physics 来自定义滚动行为：

EasyNavigationList(
  items: items,
  itemBuilder: (context, item, index) {
    return ListTile(
      title: Text(item),
      onTap: () {
        Navigator.push(
          context,
          MaterialPageRoute(
            builder: (context) => DetailPage(item: item),
          ),
        );
      },
    );
  },
  scrollController: ScrollController(),
  physics: BouncingScrollPhysics(),
)

3. 支持分页加载

flutter_easy_navigation_list 还支持分页加载功能，你可以通过 onLoadMore 回调来实现：

EasyNavigationList(
  items: items,
  itemBuilder: (context, item, index) {
    return ListTile(
      title: Text(item),
      onTap: () {
        Navigator.push(
          context,
          MaterialPageRoute(
            builder: (context) => DetailPage(item: item),
          ),
        );
      },
    );
  },
  onLoadMore: () async {
    // 加载更多数据
    await Future.delayed(Duration(seconds: 2));
    items.addAll(List.generate(10, (index) => 'New Item ${items.length + index}'));
    return true; // 返回 true 表示加载成功，false 表示加载失败或没有更多数据
  },
)