You need to enable JavaScript to run this app. 表视图单元格为自定义数据类型时如何实现UISearchBar搜索过滤功能
优惠活动
大模型
产品
解决方案
定价
更多

表视图单元格为自定义数据类型时如何实现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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 09:54:03