9 搜索 on 编程那些事儿

9.1 为应用添加搜索界面

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/adding-a-search-interface-to-your-app

9.1 为应用添加搜索界面

提供一个界面，让人们可以在应用中搜索内容。

概述

通过把某个 searchable 视图修饰符（例如 searchable(text:placement:prompt:)）应用到 NavigationSplitView 或 NavigationStack，或者应用到它们内部的某个视图，就能为应用添加搜索界面。随后工具栏中会出现一个搜索框。搜索框的确切位置与外观取决于平台、你在代码中放置该修饰符的位置以及它的配置。

创建搜索框的 searchable 修饰符接收一个指向字符串的 Binding，该字符串代表搜索框中的文本。你负责提供这个字符串的存储，以及（可选的）离散搜索令牌数组的存储，并用它们执行搜索。要了解如何管理搜索框的数据，参见执行搜索操作。

9.2 执行搜索操作

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/performing-a-search-operation

9.2 执行搜索操作

根据你存储的搜索文本以及可选令牌更新搜索结果。

概述

要在应用的数据模型中执行搜索，先为查询文本创建存储，并用 searchable 视图修饰符呈现它。由于存储由你管理，你可以检测到它的变化并相应地更新搜索操作。随着人们输入而更新搜索结果，可以确保应用的搜索界面响应及时。

9.3 提供搜索词建议

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/suggesting-search-terms

9.3 提供搜索词建议

向在应用中搜索内容的人提供建议。

概述

你可以通过提供一组搜索建议视图，在搜索过程中建议查询文本。由于建议视图并不限于纯文本，你还必须提供每个建议视图所代表的搜索字符串。如果你的搜索界面包含令牌，你也可以为令牌提供建议。SwiftUI 会把建议显示在搜索框下方的列表中。

9.4 限定搜索操作的范围

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/scoping-a-search-operation

9.4 限定搜索操作的范围

把搜索空间划分为几个宽泛的类别。

概述

如果你要搜索的数据可以分为几个类别，就可以定义不同的作用域，帮助人们缩小搜索范围。定义作用域之后，SwiftUI 会呈现一个选择器，让人们从中选择一个。随后你把这个当前选中的作用域，作为搜索操作的输入之一。

9.5 管理搜索界面的激活

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/managing-search-interface-activation

9.5 管理搜索界面的激活

以编程方式检测并关闭搜索框。

概述

人们通过轻点或点击来激活应用中的搜索框，之后就可以输入搜索词。在许多情况下，你的应用只需要对搜索文本值的相应变化做出反应——界面会通过你提供的绑定来更新这些值，如执行搜索操作所述。