【聊技術】在Android中實現自適應文字大小顯示

蕭文翰發表於2020-12-08
Android

本週的聊技術話題和大家說說如何在Android中實現自適應文字大小顯示。
想象一下，在佈局中，通常顯示文字的區域大小是固定的，但是文字長度並不總是固定的。比如列表中的文章標題、介面下方的按鈕文字等等。
為了儘可能讓這些文字可見，傳統的做法是通過文字長度設定文字大小，或者通過android:ellipsize屬性設定文字省略方式等等。
實際上，從Android O開始，Android API引入了自適應文字大小的簡易實現。它不僅可以用於TextView，對於Button等具有文字顯示的控制元件同樣適用。通過androidX，還可以適配到低版本的Android中。
下面，我們以TextView為例，來看看如何使用它們吧。

開啟自適應顯示模式

我們以Empty Activity方式建立一個新的工程，其中預設包含了只顯示Hello World!文字的TextView控制元件，我們為其加上id，並修改尺寸和預設文字。為了相容低版本的Android裝置，使用androidX中提供的的AppCompatTextView替代TextView。
完整的佈局檔案如下：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.appcompat.widget.AppCompatTextView
        android:id="@+id/activity_main_tv"
        android:layout_width="100dp"
        android:layout_height="20dp"
        android:text="abcdefghijklmno"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

然後，將程式執行起來，可以看到，文字的顯示僅到字母“n”處就停止了，”o”並沒有顯示。顯而易見，這是因為文字框的大小限制了文字的顯示。

下面，我們來到MainActivity程式碼，呼叫setAutoSizeTextTypeWithDefaults();方法，開啟自適應縮放。

private AppCompatTextView demoTv;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    demoTv = findViewById(R.id.activity_main_tv);
    demoTv.setAutoSizeTextTypeWithDefaults(TextView.AUTO_SIZE_TEXT_TYPE_UNIFORM);
}

重新執行後，可以看到文字被完整地顯示出來了：

對於setAutoSizeTextTypeWithDefaults();方法，我們可以傳入的引數值通常有兩個，分別是TextView.AUTO_SIZE_TEXT_TYPE_UNIFORM和TextView.AUTO_SIZE_TEXT_TYPE_NONE。對應開啟自適應文字大小與否。

自定義文字縮放方式

下面，我們修改TextView的文字，繼續追加：

android:text="abcdefghijklmnopqrstuvwxyz"

再次執行App，我們發現：無論自適應模式開關與否，都無法完整地顯示所有文字。這時候，我們就要對文字大小的自動縮放進行自定義了。

設定縮放配置

首先要介紹一種通過設定縮放配置實現自定義縮放的方法。我們先來看程式碼：

demoTv.setAutoSizeTextTypeUniformWithConfiguration(4,15,2, TypedValue.COMPLEX_UNIT_SP);

如上程式碼所示，setAutoSizeTextTypeUniformWithConfiguration();是實現此種縮放方式的關鍵，它由4個引數構成。

  • 4：表示文字縮放的最小值；
  • 20：表示文字縮放的最大值；
  • 2：表示文字縮放的嘗試步長；
  • TypedValue.COMPLEX_UNIT_SP：指定前三個引數使用SP作為單位。

可以這樣理解，當文字無法顯示完全時，系統將以步長為單位遞減文字大小設定值，直到文字完全顯示，或者嘗試值小於給定的文字縮放的最小值。
重新執行App，可以看到文字已經被完整地顯示出來了。

定義預設值

自定義縮放的第二種方式是通過定義預設值實現。我們還是直接看程式碼：

demoTv.setAutoSizeTextTypeUniformWithPresetSizes(new int[]{9, 11, 13, 15}, TypedValue.COMPLEX_UNIT_SP);

通過setAutoSizeTextTypeUniformWithPresetSizes();方法定義預設值，需要兩個引數，第一個是預設值的具體數值；第二個則是預設值的單位。
以上面的程式碼為例，在進行文字縮放時，文字大小隻能從9SP，11SP，13SP和15SP這4個值中取。遺憾的是，即使取到9SP，文字依然無法完全顯示：

仔細觀察圖中第二行文字，可以發現文字的下面由於高度不夠，被截去了一段。

小結

綜上，我們總共講解了三種文字自動縮放的方式。這三種方式無所謂孰優孰劣，只是使用場景的區別。有了它們，我們無需自己定義不同的文字大小，更無需自己實現文字的自適應縮放了。
最後，特別需要說明：一定要在xml以及java程式碼中使用AppCompatTextView控制元件，除非你的App只支援Android O及以上版本。
這次的分享就到這裡，希望上述內容對你有所幫助。

相關文章