Android EditText如何实现文本样式的精准控制？

2024-07-21 19:41:46

Android EditText：摆脱Span样式控制的烦恼，实现精准格式化

在Android开发中，EditText是我们经常使用的控件之一。为了实现更加丰富的文本展示效果，我们常常需要对EditText中的文本进行样式设置，例如加粗、斜体、颜色变化等。这时，SpannableString就成为了我们的得力助手。

然而，在实际使用过程中，很多开发者都会遇到一个棘手的问题：如何精准地控制选中文本的样式？尤其是在对已经应用了样式的文本进行再次操作时，常常会出现“牵一发而动全身”的情况，例如想要取消一段斜体文字中几个字的斜体，结果却导致整个段落的斜体都被取消了。

问题的根源在于对SpannableString操作方式的误解。许多开发者习惯于直接使用setSpan方法来设置样式，但这种方式在处理部分文本样式更改时，容易导致预期之外的结果，因为setSpan方法会直接应用样式到整个SpannableString上，而不是我们期望的部分文本。

精准控制Span：化解样式冲突的利器

为了解决这个问题，我们需要更加精确地定位和操作Span。以下是一种行之有效的解决方案：

R.id.context_menu_cursive -> {
    val start = editText.selectionStart
    val end = editText.selectionEnd
    val spannable = editText.text as Spannable
    
    // 查找选中文本范围内所有StyleSpan
    val styleSpans = spannable.getSpans(start, end, StyleSpan::class.java)
    
    // 判断是否已有斜体样式
    var hasItalic = false
    for (span in styleSpans) {
        if (span.style == Typeface.ITALIC) {
            hasItalic = true
            break
        }
    }
    
    // 遍历所有StyleSpan，根据情况进行移除或拆分
    var i = 0
    while (i < styleSpans.size) {
        val span = styleSpans[i]
        val spanStart = spannable.getSpanStart(span)
        val spanEnd = spannable.getSpanEnd(span)
        
        if (span.style == Typeface.ITALIC) {
            // 选中区域完全包含当前Span，移除该Span
            if (spanStart >= start && spanEnd <= end) {
                spannable.removeSpan(span)
                // 注意：移除Span后，styleSpans的大小会发生变化，需要特殊处理
                continue 
            } else {
                // 选中区域部分包含当前Span，拆分Span
                if (spanStart < start) {
                    spannable.setSpan(StyleSpan(Typeface.ITALIC), spanStart, start, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
                }
                if (spanEnd > end) {
                    spannable.setSpan(StyleSpan(Typeface.ITALIC), end, spanEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
                }
                spannable.removeSpan(span)
            }
        }
        i++
    }
    
    // 如果之前没有斜体，则添加斜体样式
    if (!hasItalic) {
        spannable.setSpan(StyleSpan(Typeface.ITALIC), start, end, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
    }
    mode.finish()
    true
}

代码解析:

获取选中文本范围: 我们首先通过 editText.selectionStart 和 editText.selectionEnd 获取到用户选中的文本范围。
查找目标Span: 使用 spannable.getSpans(start, end, StyleSpan::class.java) 获取选中区域内所有的 StyleSpan，这些Span代表了应用到文本上的样式信息。
判断斜体状态: 遍历获取到的 styleSpans，检查是否已经存在斜体样式。
精细化操作Span:
- 如果当前 Span 是斜体且与选中区域有重叠：
  - 如果选中区域完全包含当前 Span，我们直接移除该 Span。
  - 如果选中区域部分包含当前 Span，我们需要将 Span 拆分为两部分，保留未选中区域的样式，并移除原有的 Span。
添加新样式: 如果之前没有斜体样式，我们才添加 StyleSpan(Typeface.ITALIC) 到选中的文本区域。

常见问题解答

为什么不能直接使用setSpan方法设置样式？

直接使用setSpan方法设置样式会作用于整个SpannableString，而不是我们期望的部分文本，容易导致已有的样式被覆盖或者产生冲突。
代码中为什么要遍历所有StyleSpan？

因为选中的文本区域内可能存在多个StyleSpan，我们需要逐个判断和处理，才能确保样式修改的准确性。
为什么要拆分Span？

当选中的文本区域部分包含一个Span时，如果直接移除该Span，会导致未选中的部分也失去样式。因此，我们需要将Span拆分成两部分，保留未选中区域的样式。
如何处理其他类型的Span？

处理其他类型的Span，例如ForegroundColorSpan、UnderlineSpan等，思路与处理StyleSpan类似，只需要修改对应的Span类型和样式即可。
还有哪些需要注意的地方？

在移除Span时，要注意数组越界的问题，因为移除Span后，styleSpans 的大小会发生变化。