9 搜索

3 分钟阅读

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

让人们可以在应用中搜索文本或其他内容。

概述

要在应用中呈现搜索框，先为搜索文本、以及可选的离散搜索词（称为令牌，token）创建并管理存储。然后把该存储绑定到搜索框上：对应用中的某个视图应用 searchable 视图修饰符即可。

当人们与该输入框交互时，他们会隐式地修改底层存储，从而修改搜索参数。你的应用会相应地更新界面的其他部分。为增强搜索交互，你还可以：

关于设计指导，参见 Human Interface Guidelines 中的搜索。

为应用添加搜索界面 —— 提供一个界面，让人们可以在应用中搜索内容。
执行搜索操作 —— 根据搜索文本以及你存储的可选令牌更新搜索结果。
searchable(text:placement:prompt:) —— 把该视图标记为可搜索，这会配置搜索框的显示。
searchable(text:tokens:placement:prompt:token:) —— 把该视图标记为可用文本和令牌搜索。
searchable(text:editableTokens:placement:prompt:token:) —— 把该视图标记为可搜索，这会配置搜索框的显示。
SearchFieldPlacement —— 搜索框在视图层级中的放置位置。

提供搜索词建议 —— 向在应用中搜索内容的人提供建议。
searchSuggestions(_:) —— 配置该视图的搜索建议。
searchSuggestions(_:for:) —— 配置在该视图中如何显示搜索建议。
searchCompletion(_:) —— 当该视图用作搜索建议时，把一个完整构成的字符串与它的值关联起来。
searchable(text:tokens:suggestedTokens:placement:prompt:token:) —— 把该视图标记为可用文本、令牌和建议搜索。
SearchSuggestionsPlacement —— SwiftUI 显示搜索建议的方式。

管理搜索界面的激活 —— 以编程方式检测并关闭搜索框。
isSearching —— 表示用户是否正在搜索的布尔值。
dismissSearch —— 结束当前搜索交互的动作。
DismissSearchAction —— 可以结束搜索交互的动作。
searchable(text:isPresented:placement:prompt:) —— 把该视图标记为可搜索，并可编程方式呈现搜索框。
searchable(text:tokens:isPresented:placement:prompt:token:) —— 把该视图标记为可用文本和令牌搜索，并支持以编程方式呈现。
searchable(text:editableTokens:isPresented:placement:prompt:token:) —— 把该视图标记为可搜索，这会配置搜索框的显示。
searchable(text:tokens:suggestedTokens:isPresented:placement:prompt:token:) —— 把该视图标记为可用文本、令牌和建议搜索，并支持以编程方式呈现。