Android开发：如何让TextView显示搜索匹配的指定文本片段？

我正在开发应用内搜索功能，用Spannable高亮TextView里的文本，但TextView有固定宽高，搜索匹配的内容可能超出显示边界。

给出的TextView示例代码：

<TextView
    android:layout_width="256dp"
    android:maxLines="1"
    android:ellipsize="end"
    android:layout_height="wrap_content"
    android:layout_gravity="center"
    android:text="123456789 hello example of text field long line"
    android:textColor="?attr/clContent"
    android:textSize="24sp"/>

需求：当搜索“of text”时，希望TextView显示成这样：

|... of text field long...|

同时还有多行TextView（比如maxLines="3"）的情况，如何让它滚动到特定文本部分？是否可行？

我自己想了个手动实现的思路：单行时删掉匹配内容前的文本替换成“...”；多行同理删前面内容加省略号，但这个思路是不是太复杂？有没有更简便的实现方式？

单行TextView的解决方案 #

Android原生TextView没有直接支持“将匹配内容居中显示并在前后加省略号”的属性，但可以通过TextUtils.ellipsize()结合文本宽度测量实现，比手动删文本更可靠：

1. 定位搜索关键词在原文本中的起始、结束索引；
2. 用TextView的Paint对象计算可视宽度内可容纳的文本长度；
3. 拼接匹配内容与前后截断后的文本，确保整体宽度符合TextView限制，同时保留省略号。

示例代码（Kotlin）：

val originalText = "123456789 hello example of text field long line"
val keyword = "of text"
val startIndex = originalText.indexOf(keyword)
val endIndex = startIndex + keyword.length

val paint = textView.paint
val maxWidth = textView.width.toFloat()

// 计算关键词宽度与省略号占用宽度
val keywordWidth = paint.measureText(keyword)
val ellipsisWidth = paint.measureText("... ...")
val remainingWidth = maxWidth - ellipsisWidth - keywordWidth

// 分配前后可显示的文本宽度
val prefixAvailableWidth = remainingWidth / 2
val suffixAvailableWidth = remainingWidth / 2

// 截断前后文本到合适长度
val prefix = TextUtils.ellipsize(originalText.substring(0, startIndex), paint, prefixAvailableWidth, TextUtils.TruncateAt.END).toString()
val suffix = TextUtils.ellipsize(originalText.substring(endIndex), paint, suffixAvailableWidth, TextUtils.TruncateAt.START).toString()

// 拼接最终显示文本
val displayText = buildString {
    if (prefix.isNotEmpty()) append("...$prefix")
    append(keyword)
    if (suffix.isNotEmpty()) append("$suffix...")
}

// 添加强高亮效果
val spannable = SpannableString(displayText)
val highlightSpan = ForegroundColorSpan(Color.RED)
val keywordStartInDisplay = displayText.indexOf(keyword)
spannable.setSpan(highlightSpan, keywordStartInDisplay, keywordStartInDisplay + keyword.length, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)

textView.text = spannable

多行TextView的滚动解决方案 #

多行TextView要滚动到匹配内容位置，需要先开启滚动功能，再定位目标行并滚动：

1. 给TextView添加滚动支持：设置movementMethod = ScrollingMovementMethod()，开启垂直滚动条；
2. 通过TextView的Layout对象定位匹配内容所在的行；
3. 调用scrollTo()滚动到目标行的位置，若要居中显示可调整偏移量。

示例代码（Kotlin）：

// 开启滚动支持
textView.movementMethod = ScrollingMovementMethod()
textView.isVerticalScrollBarEnabled = true

val originalText = "这里是很长的多行文本，包含我们要搜索的目标内容...（省略更多内容）"
val keyword = "目标内容"
val startIndex = originalText.indexOf(keyword)

// 获取TextView的布局对象，需在TextView完成绘制后调用（比如post中）
textView.post {
    val layout = textView.layout ?: return@post
    val targetLine = layout.getLineForOffset(startIndex)
    val lineTop = layout.getLineTop(targetLine)
    
    // 滚动到目标行顶部
    textView.scrollTo(0, lineTop)
    
    // 若要让目标行居中显示
    val textViewHeight = textView.height
    val lineHeight = layout.getLineHeight(targetLine)
    val centeredScrollY = lineTop - (textViewHeight - lineHeight) / 2
    textView.scrollTo(0, centeredScrollY)
}

关于手动实现思路的评价 #

你想到的手动截断思路可行，但需要处理大量边界情况：比如匹配内容本身过长超过TextView宽度、匹配内容在文本开头/结尾等。使用TextUtils.ellipsize()结合Paint测量宽度的方式更健壮，能自动适配各种边界场景，代码复杂度也更低。

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