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

Posted on by

前言

相信這個方法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其它相關文章！

推薦閱讀：