前言
相信这个方法Canvas.drawText大家一定不陌生,TextView就是使用它将文字绘制出来。可是这个方法并没有文字换行的功能,也就是说它只能绘制一行;但是TextView的文字却是会自动换行,当页面不足以显示后面的文字时(通过android:breakStrategy属性可以调整换行时机)就会自动换行。查看源码后发现TextView是通过Layout来帮助测量文字。
Layout
Layout是一个抽象类,具体实现有BoringLayout、StaticLayout、DynamicLayout。 简单介绍一下:
- 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
)
}
我们可以用它来干嘛呢
Layout通过传入的String和width,来计算出每行能显示的文字数量。所以我们能够获取每一行的文字。
mLayout.lineCount//获取行数
mLayout.getLineStart(0)//获取第一行在传入String中的起始位置
mLayout.getLineEnd(0)//获取第一行在传入String中的终止位置
mLayout.getLineVisibleEnd(2)//获取指定行的最后可见字符(不计算空格的文本偏移量)
Layout有一个draw方法,可以直接把分行的内容绘制到view上。
val canvas = getCanvas()
mLayout.draw(canvas)//传入canvas就行啦
拓展
- 需求
开发了小说的阅读软件,我需要将每一章的内容分配到每一个页面。我需要获取到每一页能够显示的文字数量和文字内容。
- 解决方案
此时就可以通过Layout把章节内容分行,然后计算每一页能够显示多少行,将每页的内容传递过去。
- 如何实现
简单描述一下这个分页工具:
需要传入章节的内容,因为要进行分页,肯定是需要它的。
行间距相关的两个参数
lineSpaceAdd 额外的行间距,正数则增加行间距负数则减少,默认为0.0f。
lineSpaceMutil 行间距倍数,没有具体的单位,默认为1.0f,大于1.0f则增加行距,小于则减少。
这两个参数在小说阅读页面还是很重要的。 3. 阅读页面的高度和宽度,通过宽度使得Layout能够将内容分割成行,通过页面高度和行高度就能够能够获取每一页能够显示的行数。 4. 行高度lineHeight
如果你是直接传递的textview来计算的话就是直接textview.getLineHeight()
如果是通过传递textPaint,那么就用这个计算
fun getLineHeight(): Float {
//公式很简单,也体现出了行间距这两个参数的作用
return textPaint.textSize * lineSpaceMult + lineSpaceExtra
}
光有这些东西当然是不够的,文字的测量肯定需要知道文字的字体、字号,在这里只需要传入一个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,大问题应该没有吧,看个思路就好,更多关于Android开发TextView自动换行的资料请关注编程网其它相关文章!