TextView 的文字是怎么自动换行的

6,071 阅读4分钟

相信这个方法Canvas.drawText大家一定不陌生,TextView就是使用它将文字绘制出来。可是这个方法并没有文字换行的功能,也就是说它只能绘制一行;但是TextView的文字却是会自动换行,当页面不足以显示后面的文字时(通过android:breakStrategy属性可以调整换行时机)就会自动换行。查看源码后发现TextView是通过Layout来帮助测量文字。

Layout

Layout是一个抽象类,具体实现有BoringLayoutStaticLayoutDynamicLayout。 简单介绍一下:

  • BoringLayout 无聊的布局,用于单行文本,如果不确定给定的文字是否满足可以调用isBoring方法来判断
  • StaticLayout 静态布局,顾名思义就是不会变化的文本。
  • DynamicLayout 动态布局,文字可以被改变。

这里通过StaticLayout来介绍一下它们的作用。

构造方法:

	val lineSpaceadd = 0.0f //额外的行间距
        val lineSpacemuti = 1.0f//行间距倍数
        //根据不同的版本确认是否使用Builder
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.M) {
            mLayout = StaticLayout.Builder
                .obtain("传入的String", string的起始坐标, string的结尾坐标, TextPaint(), width)
                .build()
        } else {
        	//传统构造方法
            mLayout = StaticLayout(
                "传入的String",
                TextPaint(),
                width,
                Layout.Alignment.ALIGN_NORMAL,
                lineSpaceadd,
                lineSpacemuti,
                false
            )
        }

我们可以用它来干嘛呢

  1. Layout通过传入的String和width,来计算出每行能显示的文字数量。所以我们能够获取每一行的文字。
	mLayout.lineCount//获取行数
        mLayout.getLineStart(0)//获取第一行在传入String中的起始位置
        mLayout.getLineEnd(0)//获取第一行在传入String中的终止位置
        mLayout.getLineVisibleEnd(2)//获取指定行的最后可见字符(不计算空格的文本偏移量)

  1. Layout有一个draw方法,可以直接把分行的内容绘制到view上。
	val canvas = getCanvas()
	mLayout.draw(canvas)//传入canvas就行啦

拓展

需求 开发了小说的阅读软件,我需要将每一章的内容分配到每一个页面。我需要获取到每一页能够显示的文字数量和文字内容。 解决方案 此时就可以通过Layout把章节内容分行,然后计算每一页能够显示多少行,将每页的内容传递过去。 如何实现 简单描述一下这个分页工具:

  1. 需要传入章节的内容,因为要进行分页,肯定是需要它的。
  2. 行间距相关的两个参数
  • lineSpaceAdd 额外的行间距,正数则增加行间距负数则减少,默认为0.0f。
  • lineSpaceMutil 行间距倍数,没有具体的单位,默认为1.0f,大于1.0f则增加行距,小于则减少。 这两个参数在小说阅读页面还是很重要的。
  1. 阅读页面的高度和宽度,通过宽度使得Layout能够将内容分割成行,通过页面高度和行高度就能够能够获取每一页能够显示的行数。

  2. 行高度lineHeight

    1. 如果你是直接传递的textview来计算的话就是直接textview.getLineHeight()
    2. 如果是通过传递textPaint,那么就用这个计算
      fun getLineHeight(): Float {
      	//公式很简单,也体现出了行间距这两个参数的作用
      	return textPaint.textSize * lineSpaceMult + lineSpaceExtra
      }
      
  3. 光有这些东西当然是不够的,文字的测量肯定需要知道文字的字体、字号,在这里只需要传入一个TextPaint就可以获取到这些数据了。

具体实现 PagingTool.kt 我纠结了很久最后还是用了单例模式,代码功底不深,有问题欢迎大家指出。

//kotlin中的单例,java的同学不用纳闷
object PagingTool{
    private var width = 0//宽度
    private var height = 0//高度
    private var lineSpaceAdd = 0.0f//额外的行间距
    private var lineSpaceMutil = 1.0f//行间距倍数
    private var text:String = ""//文字内容
    private var textPaint = TextPaint()
    //对于画笔的参数,由于我是把阅读页面的配置保存在数据库中的,通过room框架返回LiveData,实时更新字体字号;当然也可以每次配置变更就手动更新一次。
    private lateinit var mLayout:Layout//工具的核心人物,lateinit就是延迟加载的意思,
    
    //setter
    public fun setHeight(height: Int) {
        this.height = height
    }
    public fun setWidth(width: Int) {
        this.width = width
    }
    public fun setPaint(textPaint:TextPaint){
    	this.textPaint = textPaint
    }
    public fun setLineSpaceAdd(spaceAdd:Float){
    	lineSpaceAdd = spaceAdd
    }
    public fun setLineSpaceMutil(spaceMutil:Float){
    	lineSpaceMutil = spaceMutil
    }
    
    //计算行高
    private fun getLineHeight():Int{
    	//上面说到的计算方法
    	return textPaint.textSize*lineSpaceMutil+lineSpaceAdd
        //textView.getLineHeight()
    }
    
    private fun setText(str:String){
    	text = str
        mLayout = StaticLayout(
                text,
                textPaint,
                width,
                Layout.Alignment.ALIGN_NORMAL,
                lineSpaceAdd,
                lineSpaceMutil,
                false//这个参数不用在意
            )
    }
    
    //分页
    public fun paging(str:String):List<String>{
    	setText(str)//设置内容,初始化layout
        //边界条件,为0就直接返回整个章节的内容
        if(width == 0 || height == 0)return arrayListOf(str)
        val totalLineCount = mLayout.lineCount//总行数,这个是layout测量出来的
        var pageLineCount = height / getLineHeight() //页面高度除以行高度得到页面允许绘制的行数
        if(pageLineCount < 1)pageLineCount = 1//这种情况,只可能出现在文字巨大,大到页面高度显示不下一行文字,那我还是设置让他显示一行,可以删掉
        var pageCount = totalLineCount / pageLineCount //总行数除以页面允许绘制的行数,得到分页数量
        if (totalLineCount % pageLineCount > 0)//还剩下有几行,组成最后一页
        	pageCount++
        val list = ArrayList<String>()
        //现在就只需要将内容按页添加到这个list中
        for(i in 0 until pageCount){
            var temp = (i + 1) * pageLineCount
            temp--
            if (temp >= totalLineCount)
                temp = totalLineCount - 1
            val start = mLayout.getLineStart(i * pageLineCount)
            val end = mLayout.getLineEnd(temp)
            //获取到每一页的起始坐标,结尾坐标
            val string = text.substring(start, end)
            list.add(string)
        }
        //这个时候就已经把内容分页了,list的size就是页数
        return list
    }
}

手撸的,没有跑过大致思路是这样,也许会有小bug,大问题应该没有吧,看个思路就好。