Android開發TextView內的文字實現自動換行

前言

相信這個方法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自動換行的資料請關註WalkonNet其它相關文章!

推薦閱讀: