jbl_search 是一个 Flutter 插件，用于在应用中实现搜索功能。它提供了一个简单而强大的接口，帮助开发者快速集成搜索功能到 Flutter 应用中。以下是如何使用 jbl_search 插件的详细步骤和示例代码。

1. 添加依赖

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

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

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

2. 导入插件

在需要使用搜索功能的 Dart 文件中导入 jbl_search 插件：

import 'package:jbl_search/jbl_search.dart';

3. 初始化搜索功能

在应用启动时，你需要初始化 jbl_search 插件。通常，你可以在 main.dart 文件中进行初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await JblSearch.initialize();  // 初始化插件
  runApp(MyApp());
}

4. 创建搜索界面

接下来，你可以创建一个搜索界面。以下是一个简单的示例，展示了如何使用 jbl_search 插件来实现搜索功能：

class SearchPage extends StatefulWidget {
  @override
  _SearchPageState createState() => _SearchPageState();
}

class _SearchPageState extends State<SearchPage> {
  final JblSearchController _searchController = JblSearchController();
  List<String> _searchResults = [];

  @override
  void initState() {
    super.initState();
    _searchController.addListener(_onSearchChanged);
  }

  @override
  void dispose() {
    _searchController.removeListener(_onSearchChanged);
    _searchController.dispose();
    super.dispose();
  }

  void _onSearchChanged() {
    setState(() {
      _searchResults = _searchController.searchResults;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Search'),
      ),
      body: Column(
        children: [
          Padding(
            padding: const EdgeInsets.all(8.0),
            child: TextField(
              controller: _searchController.textController,
              decoration: InputDecoration(
                hintText: 'Search...',
                border: OutlineInputBorder(),
              ),
            ),
          ),
          Expanded(
            child: ListView.builder(
              itemCount: _searchResults.length,
              itemBuilder: (context, index) {
                return ListTile(
                  title: Text(_searchResults[index]),
                );
              },
            ),
          ),
        ],
      ),
    );
  }
}

5. 处理搜索逻辑

你可以通过 JblSearchController 来处理搜索逻辑。例如，你可以在 _onSearchChanged 方法中根据用户的输入来更新搜索结果：

void _onSearchChanged() {
  final query = _searchController.textController.text;
  setState(() {
    _searchResults = _searchController.search(query);  // 根据查询字符串进行搜索
  });
}

6. 运行应用

现在你可以运行应用并测试搜索功能。当用户在输入框中输入文本时，搜索结果会实时更新。

7. 进一步自定义

jbl_search 插件提供了许多可配置的选项，例如自定义搜索算法、搜索结果排序等。你可以根据应用的需求进一步定制搜索功能。

8. 处理异步搜索

如果你的搜索逻辑涉及到异步操作（例如从网络或数据库获取数据），你可以使用 FutureBuilder 或 StreamBuilder 来处理异步搜索结果。

Future<List<String>> _performSearch(String query) async {
  // 模拟异步搜索
  await Future.delayed(Duration(seconds: 1));
  return ['Result 1', 'Result 2', 'Result 3'];  // 返回模拟结果
}

void _onSearchChanged() async {
  final query = _searchController.textController.text;
  final results = await _performSearch(query);
  setState(() {
    _searchResults = results;
  });
}