Swift中实现SearchBar输入后TextView平滑滚动至指定子串并置顶的优化方案求助

我来帮你解决这个TextView滚动的痛点——你的核心需求是把指定子串平滑滚动到可视区域顶部，同时支持带动画/无动画两种模式，还要解决现有方案两次滚动、延迟导致的不流畅问题对吧？下面给你一套更可靠的实现思路：

问题根源分析 #

你之前的两次滚动+延迟方案，本质是因为直接设置光标后获取caretRect时，TextView的布局可能还没完成（尤其是长文本场景），导致坐标不准确。我们可以通过原生API直接定位子串位置，避免依赖异步延迟和两次调整。

优化后的完整实现 #

1. 先实现可靠的子串位置定位

首先要确保能准确找到子串在TextView中的起始位置，避免位置错误导致滚动偏差：

// 获取子串在文本中的首次出现范围
func getFirstSubstringRange(of substring: String, in textView: UITextView) -> NSRange? {
    guard let text = textView.text else { return nil }
    guard let stringRange = text.range(of: substring) else { return nil }
    return NSRange(stringRange, in: text)
}

// 将NSRange转换为UITextPosition（用于获取坐标）
func textPosition(from range: NSRange, in textView: UITextView) -> UITextPosition? {
    guard let startPos = textView.position(from: textView.beginningOfDocument, offset: range.location) else {
        return nil
    }
    return textView.position(from: startPos, offset: range.length)
}

2. 核心滚动方法（支持动画开关）

直接利用TextView的原生滚动API，一次到位将子串滚动到顶部：

func scrollToSubstring(_ substring: String, animated: Bool) {
    guard let textRange = getFirstSubstringRange(of: substring, in: themeTextView) else {
        // 子串不存在时的处理：比如滚动到顶部或不操作
        themeTextView.setContentOffset(.zero, animated: animated)
        return
    }
    
    // 获取子串起始位置的UITextPosition
    guard let startPosition = themeTextView.position(from: themeTextView.beginningOfDocument, offset: textRange.location) else {
        return
    }
    
    // 获取子串起始位置对应的矩形（相对于TextView内部坐标系）
    let substringRect = themeTextView.caretRect(for: startPosition)
    
    // 计算目标滚动偏移量：让子串顶部对齐TextView可视区域顶部，同时考虑contentInset（避免被导航栏/状态栏遮挡）
    var targetOffsetY = substringRect.origin.y - themeTextView.contentInset.top
    // 防止偏移量小于0（避免滚动到顶部以上）
    targetOffsetY = max(targetOffsetY, 0)
    
    // 方案一：用原生scrollRectToVisible，自动处理边界和动画
    let targetVisibleRect = CGRect(x: 0, y: targetOffsetY, width: themeTextView.bounds.width, height: 1)
    themeTextView.scrollRectToVisible(targetVisibleRect, animated: animated)
    
    // 方案二：直接设置contentOffset，更精确控制（二选一即可）
    // let targetOffset = CGPoint(x: 0, y: targetOffsetY)
    // themeTextView.setContentOffset(targetOffset, animated: animated)
}

解决你之前遇到的问题 #

• 移除首次调整后长文本异常：现在直接通过子串位置计算目标偏移，不需要先滚动到顶部再修正，长文本场景下坐标计算依然准确。
• 无需DispatchQueue延迟：通过UITextPosition获取的caretRect是基于当前TextView布局的实时坐标，不需要等待布局更新。
• 支持动画开关：animated参数直接控制滚动是否带动画，完全满足你的需求。

调用示例 #

在搜索框回调中使用

func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
    guard !searchText.trimmingCharacters(in: .whitespaces).isEmpty else {
        // 搜索文本为空时滚动到顶部
        themeTextView.setContentOffset(.zero, animated: true)
        return
    }
    scrollToSubstring(searchText, animated: true)
}

在Segue完成后使用

要确保TextView已经完成布局，建议在viewDidAppear中调用：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 从其他页面跳转后滚动到指定子串
    scrollToSubstring("目标内容", animated: true)
}

额外注意事项 #

• 如果子串已经在可视区域内，scrollRectToVisible不会触发滚动，符合预期。
• 若需要将子串居中或其他位置，只需调整targetOffsetY的计算逻辑即可。
• 确保TextView的isScrollEnabled属性为true，否则滚动功能无效。

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