SwiftlySearch 使用教程

SwiftlySearch 使用教程

SwiftlySearchA small, lightweight UISearchController wrapper for SwiftUI项目地址:https://gitcode.com/gh_mirrors/sw/SwiftlySearch

项目介绍

SwiftlySearch 是一个轻量级的 UISearchController 包装器，专为 SwiftUI 设计。该项目旨在简化在 SwiftUI 应用中集成搜索功能的过程。然而，需要注意的是，该项目已被标记为过时，因为 iOS 15 引入了 searchable() 方法，这是 SwiftUI 官方的搜索栏实现。尽管如此，SwiftlySearch 仍然可以作为面向 iOS 15 以下版本应用的兼容解决方案。

项目快速启动

安装

首先，更新你的 Package.swift 文件以包含 SwiftlySearch：

let package = Package(
    dependencies: [
        .package(url: "https://github.com/thislooksfun/SwiftlySearch.git", from: "1.0.0")
    ]
)

在 Xcode 中，通过以下步骤添加依赖：

1. 打开 File > Swift Packages > Add Package Dependency。
2. 输入 https://github.com/thislooksfun/SwiftlySearch 作为 URL。
3. 选择你需要的版本约束。
4. 点击 Next 和 Finish。

使用

导入 SwiftlySearch 并在你的视图中使用它：

import SwiftlySearch

struct ContentView: View {
    let items: [String]
    @State var searchText = ""

    var body: some View {
        NavigationView {
            List(items.filter { $0.localizedStandardContains(searchText) }) { item in
                Text(item)
            }
            .navigationBarSearch($searchText)
        }
    }
}

应用案例和最佳实践

基本搜索功能

以下是一个基本的搜索功能实现示例：

struct ContentView: View {
    let items: [String] = ["Apple", "Banana", "Cherry", "Date", "Elderberry"]
    @State var searchText: String = ""

    var body: some View {
        NavigationView {
            List(items.filter { $0.localizedStandardContains(searchText) }) { item in
                Text(item)
            }
            .navigationBarSearch($searchText)
        }
    }
}

高级搜索功能

如果你需要在搜索结果中使用 NavigationLink，可以参考以下示例：

struct ContentView: View {
    @State var searchText: String = ""

    var body: some View {
        NavigationView {
            ZStack {
                if searchText.isEmpty {
                    NormalView()
                } else {
                    SearchResultsView(text: searchText)
                }
            }
            .navigationBarSearch($searchText)
        }
    }
}

struct NormalView: View {
    var body: some View {
        Text("Some view")
    }
}

struct SearchResultsView: View {
    var text: String

    var body: some View {
        VStack {
            Text("You searched for \(text)")
            NavigationLink(destination: Text(text)) {
                Text("Let's go")
            }
        }
    }
}

典型生态项目

SwiftlySearch 作为一个轻量级的搜索功能包装器，适用于需要快速集成搜索功能的 SwiftUI 项目。虽然它已被标记为过时，但对于需要支持 iOS 15 以下版本的应用来说，仍然是一个有价值的工具。

相关项目

• SwiftUIX: 一个扩展 SwiftUI 功能的库，提供了许多有用的组件和工具。
• ComposableArchitecture: 一个用于构建 SwiftUI 应用的库，提供了强大的状态管理和组合功能。

通过结合这些生态项目，你可以构建出更加强大和灵活的 SwiftUI 应用。

SwiftlySearchA small, lightweight UISearchController wrapper for SwiftUI项目地址:https://gitcode.com/gh_mirrors/sw/SwiftlySearch