1.13 搜索修饰符

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

1.13 搜索修饰符

让人们可以在你的应用中搜索内容。

概述

用搜索视图修饰符为应用添加搜索能力。更多信息参见搜索。

显示搜索界面

• searchable(text:placement:prompt:) —— 把该视图标记为可搜索，这会配置搜索框的显示。
• searchable(text:isPresented:placement:prompt:) —— 把该视图标记为可搜索，并可编程方式呈现搜索框。
• searchPresentationToolbarBehavior(_:) —— 为在该视图内的任何 searchable 修饰符配置搜索工具栏的呈现行为。
• searchToolbarBehavior(_:) —— 配置工具栏中搜索的行为。
• searchSelection(_:) —— 把与最近一个 searchable 修饰符关联的搜索框选区绑定到给定的 TextSelection 值。

使用令牌搜索

• searchable(text:tokens:placement:prompt:token:) —— 把该视图标记为可用文本和令牌搜索。
• searchable(text:tokens:isPresented:placement:prompt:token:) —— 把该视图标记为可用文本和令牌搜索，并支持以编程方式呈现。

使用可编辑令牌搜索

• searchable(text:editableTokens:isPresented:placement:prompt:token:) —— 把该视图标记为可搜索，这会配置搜索框的显示。
• searchable(text:editableTokens:placement:prompt:token:) —— 把该视图标记为可搜索，这会配置搜索框的显示。

提供搜索建议

• searchSuggestions(_:) —— 配置该视图的搜索建议。
• searchSuggestions(_:for:) —— 配置在该视图中如何显示搜索建议。
• searchCompletion(_:) —— 当该视图用作搜索建议时，把一个完整构成的字符串与它的值关联起来。
• searchable(text:tokens:suggestedTokens:placement:prompt:token:) —— 把该视图标记为可用文本、令牌和建议搜索。
• searchable(text:tokens:suggestedTokens:isPresented:placement:prompt:token:) —— 把该视图标记为可用文本、令牌和建议搜索，并支持以编程方式呈现。

限制搜索范围

• searchScopes(_:scopes:) —— 配置该视图的搜索作用域。
• searchScopes(:activation::) —— 用指定的激活策略配置该视图的搜索作用域。

通过听写搜索

• searchDictationBehavior(_:) —— 为 searchable 修饰符配置的任何搜索框设置听写行为。