自定义View:可伸展折叠的ExpandTextView

前言

最近工作比较多,写了几个小控件跟大家分享一下。首先看图:


效果图

这种可以显示展开和折叠的TextView非常常见,如果全文要当作一个按钮处理的话,就没办法和文字混排,所以以前就和产品商量折中方案,就没太细细研究这个效果。今天算是补上了。

正文

其实实现这个效果非常简单,总共就100行代码。

首先我们要解决的问题是按钮和文字的混排问题,首选方案肯定是SpannableString,文字的大小,颜色,下划线都可以定制,用它肯定没毛病。剩下的就是字符串的截取,如果是折叠我们就截取字符串的前几行,再减去几个字符给全文留出位置,展开就全部展示。

因为要保存设置的文字,所以我们需要写一个setText方法:

// 折叠时显示的最大行数
private var collapsedMaxLine = 0

// 文字
private var content: String = ""

// 是否需要显示 全文/收起,不足collapsedMaxLine的行数,没必要显示
private var hasMore = false

fun setText(content: String) {
     this.content = content
     super.setText(content)
     // 重置状态
     maxLines = Int.MAX_VALUE
     hasMore = false
}

字符串的截取就放在onMeasure中:

 var collapsed = true
      set(value) {
          if (field != value) {
              field = value
              requestLayout()
          }
      }

override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
        if (!TextUtils.isEmpty(content)) {
            if (layout != null) {
                // 如果现在的行数比折叠的是否大,验证是否可以展开
                if (layout.lineCount > collapsedMaxLine) {
                    hasMore = true
                }

                // 如果是折叠
                if (collapsed) {
                    // 行数保持一致
                    if (layout.lineCount > collapsedMaxLine) {
                        maxLines = collapsedMaxLine
                        // layout可以返回指定的行数的最后一个字符的位置,如果不了解的话,后续会讲
                        val endIndex = layout.getLineEnd(collapsedMaxLine - 1)
                        // 减去文字,拼接 ...全部后缀
                        super.setText(getCollapsedContent(endIndex))
                    }
                } else {
                    // 展开状态 并且 可以展开
                    if (hasMore) {
                        // 取消行数限制
                        maxLines = Int.MAX_VALUE
                        // 显示全部内容,拼接 收起后缀
                        super.setText(getAllContent())
                        hasMore = false
                    }
                }
            }
        }
        super.onMeasure(widthMeasureSpec, heightMeasureSpec)
}

拼接全部和收起按钮,需要可以点击,这里我们还得自定义一个ClickSpan:

private fun getAllContent(): SpannableStringBuilder {
        return SpannableStringBuilder(content)
            .apply {
                append("收起")
                setSpan(ClickableColorSpan(color = collapsedColor, underLine = collapsedUnderLine) {
                    collapsed = !collapsed
                }, length - 2, length, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
            }
    }


    private fun getCollapsedContent(endIndex: Int): SpannableStringBuilder {
        return SpannableStringBuilder(content.substring(0, endIndex - 7))
            .apply {
                append("...全文")
                setSpan(ClickableColorSpan(color = collapsedColor, underLine = collapsedUnderLine) {
                    collapsed = !collapsed
                }, length - 5, length, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
            }
    }


    class ClickableColorSpan(
        private val color: Int,
        private val underLine: Boolean,
        private val click: () -> Unit
    ) : ClickableSpan() {

        override fun updateDrawState(ds: TextPaint) {
            ds.color = color
            ds.isUnderlineText = underLine
            // 要注意这句代码不可以打开,否则无法显示设置的UI
//        super.updateDrawState(ds)
        }

        override fun onClick(widget: View) {
            click.invoke()
        }
    }

为什么ClickSpan的super.updateDrawState(ds)不可以打开,因为这个方法会覆盖我们的color和下划线

@Override
public void updateDrawState(@NonNull TextPaint ds) {
    ds.setColor(ds.linkColor);
    ds.setUnderlineText(true);
}

最后千万别忘了设置最重要的一步,TextView设置

init {
    // 不设置此方法,点击无效
    movementMethod = LinkMovementMethod.getInstance()
}

到此效果完成。

神奇的Layout

在上面的代码中,我们使用了TextView的一个属性:layout。它在android.text包下,专门辅助TextView绘制文字的类。在上一次开发歌词变色的功能中,发挥了非常重要的作用。

下面介绍一下Layout的常用方法:

// 返回某一行开始的文字的索引,如果line等于lineCount,会返回字符串的长度
public abstract int getLineStart(int line);
// 返回某一行最后一个字符的索引
public final int getLineEnd(int line) 
// 返回某一个距离顶部的top
public abstract int getLineTop(int line);
// 返回某一行左边的间距
public float getLineLeft(int line)
// 返回某一行右边的间距
public float getLineRight(int line)
// 返回某一行下面的间距
public final int getLineBottom(int line)
// 获得某一行的宽度
public float getLineWidth(int line)、
// 返回某个位置所在的行数
public int getLineForOffset(int offset)

当TextView绘制文字后,我们可以通过Layout得到和文字相关的所有信息,只能说Layout真的是无敌。

问题修复

问题1:

private fun getCollapsedContent(endIndex: Int): SpannableStringBuilder {
        return SpannableStringBuilder(content.substring(0, endIndex - 7)) // 请注意这句
            .apply {
                append("...全文")
                setSpan(ClickableColorSpan(color = collapsedColor, underLine = collapsedUnderLine) {
                    collapsed = !collapsed
                }, length - 5, length, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
            }
    }

这里面有一个字符串截取的操作,我们本意是想从显示的字符串中留出“...全文”的位置,但是实际使用中发现,如果换行符过多可能导致不足7个字,行数仍然超过collapsedMaxLine。

例如内容:”1\n2\n\n3\n\n4“,总共是9行,但是如果collapsedMaxLine=3,前三行只有4个字,导致越界崩溃。

所以此处代码改为:

        // 计算最大行数的字数
        val lineEnd = layout.getLineEnd(collapsedMaxLine - 1)
        val collapsedMaxLineTextCount = lineEnd - layout.getLineStart(collapsedMaxLine - 1)
        return SpannableStringBuilder(
            content.substring(
                0, if (collapsedMaxLineTextCount > 7) {
                    // 如果最后一行超过了7个字符,就减去7个字符,给...全文留出空位
                    lineEnd - 7
                } else {
                    // 不截取
                    lineEnd
                }
            )
        )
       ...
    }

问题2:

原本设置内容的方法为setText,此方法容易和系统方法混淆,所以修改为setContent。

总结

通过今天的小控件,主要还是想安利大家Layout这一神器,有了它处理更复杂的文字效果都不是问题,有时间大家可以研究研究。

GitHub地址:点击查看源码

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269