TextView如何实现文字添加删除线效果？

Question

在Android开发中，如何通过TextView实现文字添加删除线效果是一个常见需求。许多开发者在使用`Paint.STRIKE_THRU_TEXT_FLAG`时遇到问题：虽然设置了该标志，但删除线未显示或显示异常。常见原因包括未正确调用`paintFlags`属性、在SpannableString中使用时范围界定错误，或与其他文本样式（如下划线）冲突。此外，在RecyclerView等复用场景中，若未重置paintFlags，可能导致删除线错乱显示。如何确保删除线稳定呈现且兼容不同API版本？

Answer 1

一、TextView删除线基础实现方式

在Android开发中，为TextView添加删除线最直接的方式是通过设置其画笔（Paint）的标志位。核心属性为Paint.STRIKE_THRU_TEXT_FLAG，该标志控制是否绘制贯穿文本的横线。

TextView textView = findViewById(R.id.text_view);
textView.getPaint().setFlags(Paint.STRIKE_THRU_TEXT_FLAG);

上述代码通过获取TextView的Paint对象并设置删除线标志来实现效果。然而，许多开发者在此处踩坑：仅调用setFlags()会覆盖原有所有样式（如抗锯齿、下划线等），可能导致文本渲染异常。

正确的做法是使用按位或操作保留原有标志：

Paint paint = textView.getPaint();
paint.setFlags(paint.getFlags() | Paint.STRIKE_THRU_TEXT_FLAG);

此方法确保在启用删除线的同时不破坏其他文本渲染特性，适用于大多数静态场景下的简单需求。

二、SpannableString动态范围控制

当需要对部分文字添加删除线时，应使用SpannableString结合StrikethroughSpan类。这是更灵活且推荐的做法，尤其适用于富文本展示。

Span类型	用途	是否支持部分文本
StrikethroughSpan	添加删除线	✔️
UnderlineSpan	添加下划线	✔️
StyleSpan	粗体/斜体	✔️

示例代码如下：

SpannableString spannable = new SpannableString("原价：¥99.9");
spannable.setSpan(new StrikethroughSpan(), 3, 8, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
textView.setText(spannable);

注意：start和end索引必须准确，否则会导致删除线错位或缺失。常见错误包括字符串长度计算错误、Unicode字符处理不当等。

三、多样式冲突与解决方案

在实际项目中，常需同时应用删除线与下划线或其他样式。若混合使用paintFlags和Span，容易引发样式覆盖问题。

1. 避免在已使用SpannableString的文本上再操作paintFlags。
2. 多个Span可叠加使用，但需注意顺序和范围一致性。
3. 例如，同时加删除线和变色：

SpannableString spannable = new SpannableString("促销价已失效");
spannable.setSpan(new StrikethroughSpan(), 0, 5, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
spannable.setSpan(new ForegroundColorSpan(Color.GRAY), 0, 5, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
textView.setText(spannable);

此时两个Span作用于相同区间，系统自动合并渲染，不会冲突。

四、RecyclerView复用导致的状态错乱

在RecyclerView.Adapter中，由于ViewHolder复用机制，若未显式重置paintFlags，可能造成删除线“残留”到其他条目。

graph TD
    A[绑定Item数据] --> B{是否需要删除线?}
    B -- 是 --> C[设置STRIKE_THRU_TEXT_FLAG]
    B -- 否 --> D[清除删除线标志]
    D --> E[paint.setFlags(paint.getFlags() & ~Paint.STRIKE_THRU_TEXT_FLAG)]
    C --> F[显示删除线]
    E --> G[正常文本]

关键修复点在于“否”分支必须主动清除标志，不能假设初始状态为无删除线。正确写法：

if (item.isDiscounted()) {
    paint.setFlags(paint.getFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
} else {
    paint.setFlags(paint.getFlags() & (~Paint.STRIKE_THRU_TEXT_FLAG));
}

使用位运算& ~可安全移除指定标志而不影响其他样式。

五、跨API版本兼容性考量

尽管Paint.STRIKE_THRU_TEXT_FLAG自API Level 1可用，但在某些定制ROM或低版本设备上存在渲染偏差。建议封装工具类统一处理：

public class TextDecorUtil {
    public static void setStrikeThrough(TextView tv, boolean strike) {
        TextPaint paint = tv.getPaint();
        if (strike) {
            paint.setFlags(paint.getFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
        } else {
            paint.setFlags(paint.getFlags() & (~Paint.STRIKE_THRU_TEXT_FLAG));
        }
        tv.invalidate(); // 强制重绘
    }
}

此外，在XML中也可通过android:textStyle间接支持，但原生不提供删除线属性，需依赖第三方库或自定义View增强。

综上所述，从单一控件到复杂列表，再到多版本适配，删除线实现需兼顾准确性、可维护性与健壮性。