Flutter智能搜索插件smartsearch的使用

Flutter Smart Search Widget 是一个为 Flutter 应用程序提供高度可定制和智能搜索功能的包。它允许开发人员轻松地将高级搜索功能集成到他们的应用程序中，简化用户的搜索过程并提供更强大的用户体验。

关键特性

• 响应式对话框
• 键盘控制
• 搜索函数和回调作为参数
• 分类
• 结果列表视图插槽
• 无结果屏幕

安装

要安装该包，请在 pubspec.yaml 文件中将其作为依赖项添加：

dependencies:
  flutter_advanced_search: ^1.0.0

然后运行以下命令以下载并安装包：

flutter pub get

使用文档、示例代码和测试

以下是一个完整的示例，展示如何在 Flutter 应用程序中使用 smartsearch 插件。

示例代码

文件路径：example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:smartsearch/smart_search_result.dart'; // 导入搜索结果类
import 'package:smartsearch/smartsearch.dart'; // 导入智能搜索组件

void main() {
  runApp(const MainApp()); // 运行主应用
}

class MainApp extends StatelessWidget {
  const MainApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: const [
        GlobalMaterialLocalizations.delegate, // 支持多语言
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
      ],
      supportedLocales: const [
        Locale('en'), // 支持的语言（例如英语）
      ],
      home: Scaffold(
        body: Builder(
          builder: (context) => Center(
            child: TextButton(
              onPressed: () => showDialog<void>(
                context: context,
                builder: (context) => SmartSearchBox(
                  width: 600, // 设置搜索框宽度
                  resultsQuery: (String term, List<String> categories) async { // 定义搜索逻辑
                    Map<String, List<String>> testData = {
                      'Publishers': ['Klay Lewis', 'Ehsan Woodard', 'River Bains', 'Bill Blackbeard', 'Dreadful Pete', 'John Bones', 'Max Henry',],
                      'Reviewers': ['Toyah Downs', 'Tyla Kane', 'Lillian Bonner', 'Tianna Fernandez', 'Darcie Cervantes', 'Hafsah Pope'],
                    };

                    // 如果用户选择了分类，则过滤掉未选中的分类
                    if (categories.isNotEmpty) {
                      for (String k in testData.keys) {
                        if (!categories.contains(k)) testData[k] = [];
                      }
                    }

                    // 如果搜索关键词不为空，则过滤出包含关键词的结果
                    if (term.isNotEmpty) {
                      for (String k in testData.keys) {
                        testData[k]?.removeWhere((v) => !v.toLowerCase().contains(term.toLowerCase()));
                      }
                    }

                    // 构造搜索结果
                    Map<String, List<SmartSearchResult>> result = {};
                    for (String k in testData.keys) {
                      result.putIfAbsent(k, () => []);
                      for (String v in testData[k] ?? <String>[]) {
                        result[k]!.add(SmartSearchResult(
                          titleSlot: Text(v), // 设置结果的标题
                          descriptionSlot: Text(v, style: TextStyle(color: Theme.of(context).colorScheme.onSurface.withOpacity(0.5))), // 设置描述
                          leadingSlot: const Icon(Icons.abc_rounded), // 设置前缀图标
                          trailingSlot: const Icon(Icons.more_horiz), // 设置后缀图标
                          onSelect: () async => print(v), // 点击事件回调
                        ));
                      }
                    }

                    return result; // 返回构造好的搜索结果
                  },
                ),
              ),
              child: const Text('搜索'), // 按钮文本
            ),
          ),
        ),
      ),
    );
  }
}