表视图单元格为自定义数据类型时如何实现UISearchBar搜索过滤功能
核心问题排查
你猜的两个问题都存在,另外还有两处容易引发 bug 的逻辑漏洞,逐一说明:
问题1:表视图完全没绑定过滤后的数据
所有UITableViewDataSource方法都直接读取全量的mealPlan数组,哪怕你正确生成了filteredData,表视图也只会渲染全量数据,搜索自然没有任何反馈。
问题2:文本匹配逻辑完全失效
你当前写的判断条件是:
if ((item.title?.lowercased().contains(searchText.lowercased())) != nil)
这个判断的本质是检查「item.title是否为nil」,根本没有判断文本匹配的结果:
- 只要
item.title有值,不管搜索的内容和它有没有关联,都会被加入过滤结果 - 一旦
item.title为nil,哪怕完全匹配搜索词也会被漏掉
问题3:多过滤条件割裂
你同时有「收藏筛选」和「搜索关键词筛选」两个过滤维度,当前代码完全独立维护两个状态,切换收藏时会覆盖之前的搜索结果,数据同步很容易出问题。
可直接复用的修复方案
1. 重构数据源逻辑,取消手动维护多个数组
用计算属性统一输出当前要展示的内容,自动兼容两种过滤状态,从根源避免数组不同步的问题:
// 删掉原来的 var filteredData: [MealPlan]! private var displayMealPlans: [MealPlan] { // 第一步:先按搜索关键词过滤 let trimmedSearchText = searchBar.text?.trimmingCharacters(in: .whitespaces) ?? "" let searchFiltered = trimmedSearchText.isEmpty ? mealPlan : mealPlan.filter { meal in guard let title = meal.title else { return false } return title.lowercased().contains(trimmedSearchText.lowercased()) } // 第二步:叠加收藏状态过滤 guard isStarFiltered else { return searchFiltered } return searchFiltered.filter { $0.isStarred == true } }
2. 修改表视图数据源方法,全部读取displayMealPlans
extension MealPlanViewController: UITableViewDelegate, UITableViewDataSource { func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int { // 原来返回 mealPlan.count,替换为当前过滤后的数据总数 return displayMealPlans.count } func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell { let cell = tableView.dequeueReusableCell(withIdentifier: "MealPlanCell", for: indexPath) as! MealPlanCell // 原来从全量mealPlan取数据,替换为当前展示的数组 let mealPlanInTable = displayMealPlans[indexPath.row] cell.displayMealPlan(mealPlanInTable) cell.mealPlanView.layer.cornerRadius = 10 cell.coverImageView.layer.cornerRadius = 10 return cell } }
3. 简化搜索框代理方法
不需要手动维护过滤数组,触发表视图刷新即可,计算属性会自动读取最新的搜索文本:
func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) { tableView.reloadData() }
4. 修复收藏按钮的逻辑
切换收藏状态后直接触发表视图刷新,不需要额外维护过滤数组:
@IBAction func starButtonTapped(_ sender: Any) { isStarFiltered.toggle() setStarFilterButton() // 保留原来从Firestore拉取对应收藏状态数据的逻辑即可 if isStarFiltered { model.getMealPlans(true) } else { model.getMealPlans() } // 数据拉取完成后,mealPlansRetrieved方法里已经有reloadData了,不需要重复调用 }
5. 修复跳转传值的错位问题
原来的逻辑是传表视图行索引给下游页面,在搜索/过滤状态下,这个索引对应的是当前展示数组的位置,不是全量数组的位置,会出现跳转内容和选中内容不匹配的问题:
override func prepare(for segue: UIStoryboardSegue, sender: Any?) { let indexPath = tableView.indexPathForSelectedRow guard let indexPath = indexPath else { return } let selectedMealPlan = displayMealPlans[indexPath.row] let ingredientsVC = segue.destination as! IngredientsViewController // 推荐直接传递选中的MealPlan对象,替代原来传索引的逻辑 // 如果不想修改下游VC的属性,可以通过docID匹配全量mealPlan里的正确索引再传递 ingredientsVC.selectedMealPlan = selectedMealPlan }
可选优化
- 给
MealPlan的可选属性设置默认值,减少后续取值时的解包风险 - 数据量较大时可以把过滤逻辑放到后台队列执行,避免主线程卡顿
- 加个清空按钮,让用户可以快速重置搜索状态
内容的提问来源于stack exchange,提问作者amirbt17
相关产品推荐
相关产品推荐

