history_list 是一个用于管理历史记录的 Flutter 插件。它可以帮助你在应用中轻松地管理和导航历史记录。以下是如何使用 history_list 插件的基本步骤：

1. 添加依赖

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

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

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

2. 导入插件

在你的 Dart 文件中导入 history_list 插件：

import 'package:history_list/history_list.dart';

3. 使用 HistoryList

HistoryList 是一个简单的历史记录管理器，你可以使用它来添加、删除和导航历史记录。

创建 HistoryList 实例

你可以创建一个 HistoryList 实例来管理你的历史记录：

final historyList = HistoryList<String>();

在这个例子中，我们使用 String 类型的历史记录项，你可以根据需要使用其他类型。

添加历史记录

你可以使用 add 方法来添加新的历史记录项：

historyList.add('Page 1');
historyList.add('Page 2');
historyList.add('Page 3');

导航历史记录

你可以使用 back 和 forward 方法来导航历史记录：

// 返回上一页
historyList.back();

// 前进到下一页
historyList.forward();

获取当前历史记录项

你可以使用 current 属性来获取当前的历史记录项：

final currentItem = historyList.current;
print('Current item: $currentItem');

检查是否可以导航

你可以使用 canGoBack 和 canGoForward 方法来检查是否可以导航：

if (historyList.canGoBack) {
  print('Can go back');
}

if (historyList.canGoForward) {
  print('Can go forward');
}

清除历史记录

你可以使用 clear 方法来清除所有历史记录：

historyList.clear();

4. 示例代码

以下是一个完整的示例代码，展示了如何使用 history_list 插件：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HistoryListExample(),
    );
  }
}

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

class _HistoryListExampleState extends State<HistoryListExample> {
  final historyList = HistoryList<String>();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('History List Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Current Item: ${historyList.current ?? 'None'}'),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                setState(() {
                  historyList.add('Page ${historyList.length + 1}');
                });
              },
              child: Text('Add Page'),
            ),
            SizedBox(height: 20),
            Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                ElevatedButton(
                  onPressed: historyList.canGoBack
                      ? () {
                          setState(() {
                            historyList.back();
                          });
                        }
                      : null,
                  child: Text('Back'),
                ),
                SizedBox(width: 20),
                ElevatedButton(
                  onPressed: historyList.canGoForward
                      ? () {
                          setState(() {
                            historyList.forward();
                          });
                        }
                      : null,
                  child: Text('Forward'),
                ),
              ],
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                setState(() {
                  historyList.clear();
                });
              },
              child: Text('Clear History'),
            ),
          ],
        ),
      ),
    );
  }
}