Apple TV 带键盘及筛选功能的搜索栏实现方法咨询

你要实现的Apple Music风格带分类筛选的搜索栏可通过tvOS原生UIKit组件实现，完全匹配你需要的键盘联动、分类切换效果：

实现前提 #

• 最低兼容tvOS 14.0及以上版本，该版本起系统开放了搜索栏的scope分类选择能力
• 无需自定义复杂组件，原生组件默认支持Apple TV焦点规则、键盘交互逻辑，不需要额外适配系统交互

核心实现代码 #

1. 基础属性与搜索控制器配置 #

import UIKit

class SearchViewController: UIViewController {
    // 你已经实现的搜索结果展示collectionView可直接复用
    private var resultCollectionView: UICollectionView!
    private var searchController: UISearchController!
    // 自定义筛选分类名称，可按需求修改
    private let searchScopes = ["All Apple Music", "Library"]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupSearchController()
    }
    
    private func setupSearchController() {
        // 初始化搜索控制器，如用当前页展示结果可传nil
        searchController = UISearchController(searchResultsController: nil)
        // 配置搜索栏基础属性
        searchController.searchBar.placeholder = "搜索内容"
        // 绑定筛选分类
        searchController.searchBar.scopeButtonTitles = searchScopes
        searchController.searchBar.selectedScopeButtonIndex = 0
        // 关闭不需要的联想建议弹窗
        searchController.showsSearchResultsController = false
        // 设置代理处理搜索事件
        searchController.searchBar.delegate = self
        searchController.searchResultsUpdater = self
        // 将搜索栏绑定到导航栏
        navigationItem.searchController = searchController
        navigationItem.hidesSearchBarWhenScrolling = false
    }
}

2. 搜索与分类切换事件处理 #

extension SearchViewController: UISearchBarDelegate, UISearchResultsUpdating {
    // 搜索关键词变化时触发
    func updateSearchResults(for searchController: UISearchController) {
        let keyword = searchController.searchBar.text ?? ""
        let selectedScope = searchScopes[searchController.searchBar.selectedScopeButtonIndex]
        // 调用你已实现的搜索结果逻辑，传入关键词和选中分类刷新collectionView即可
        refreshSearchResult(keyword: keyword, scope: selectedScope)
    }
    
    // 筛选分类切换时触发
    func searchBar(_ searchBar: UISearchBar, selectedScopeButtonIndexDidChange selectedScope: Int) {
        updateSearchResults(for: searchController)
    }
}

自定义调整说明 #

• 如果需要修改筛选栏的字体、配色，可通过UISearchBar的scopeBarAppearance属性进行自定义配置，匹配你的App设计风格
• 搜索结果的展示逻辑你已经通过collectionView实现，无需改动，只需要在上述回调方法中传入对应参数刷新数据即可

官方参考文档 #

你可以直接在Xcode的Developer Documentation中搜索以下关键词查看官方说明：

• UISearchController (tvOS)
• UISearchBar scopeButtonTitles (tvOS 14.0+)

内容的提问来源于stack exchange，提问作者Ricardo Pessoa