Android自定義控制項：自適應大小的文本控制項

来源:https://www.cnblogs.com/qixingchao/archive/2019/10/12/11652389.html
-Advertisement-
Play Games

需求 自適應大小的文本： 效果圖： 項目開發中，開發人員根據UI人員提供的一套尺寸，佈局了一些帶文本的頁面， 往往會少考慮一些數據極限的問題，造成機型屏幕適配問題。 例如： 文本（或數值）長度可變，如經驗值、金幣數量等，如果頁面同一高度使用了多個Textview佈局擺放，當Textview文本長度增 ...


需求

自適應大小的文本：
效果圖：
GIF.gif
項目開發中，開發人員根據UI人員提供的一套尺寸，佈局了一些帶文本的頁面，
往往會少考慮一些數據極限的問題，造成機型屏幕適配問題。
例如：
文本（或數值）長度可變，如經驗值、金幣數量等，如果頁面同一高度使用了多個Textview佈局擺放，當Textview文本長度增加時，有可能造成重疊現象。

例子還有很多，相信很多開發人員也都曾遇到過。
今天我們就寫一個簡單的例子，解決該問題。

我們項目中的實際需求：

1. 文本控制項單行、居中顯示；
2. 文本控制項預設有一個固定尺寸，如果文本過多，字型大小自動變小，文本仍然完全顯示，不折行；
3. 文本控制項尺寸變小，文本不變，字型大小也自動變小，文本仍然完全顯示，不折行；

其實2和3仔細分析一下是一個意思：
文本控制項的空間不夠存放當前文本時，字型大小自動縮小。

分析

一般的情況，很多開發者做法是繼承TextView，控制其屬性以達到效果。

我們換一種做法。
TextView文本說到底，就是一個View，而我們看到的文本，其實是通過畫筆繪製在View空間（即：畫布）上的。
那麼我們也使用這種方式，畫筆來實現吧。

可能有開發者會擔心很難，其實一點也不難，只需要簡單掌握幾個基礎知識（1. 畫布、2. 畫筆、3. 文本繪製的計算）就可以了。
我們自定義出來的控制項代碼，不會比直接繼承TextView多，而且大家還能學到更多有用的知識。

那麼我們開始分析：
如何在一定的空間中自適應文本的大小，使其能完全顯示？
原理很簡單，就是把字型大小變小就行了，那麼變成多小？如何計算呢？

1. 我們要實現的控制項，只是一個文本顯示，界面不複雜，所以我們不需要使用XML，只寫一個自定義類即可；
2. 自定義類直接繼承View；
3. View中可獲得的或者外界傳入的信息（即：已知條件）：
    3.1 文本信息Text（外界傳入）
    3.2 字型大小最大值MaxSize（外界傳入， 即，我們設置的預設字型大小，因為字型大小只會縮小，不會增加，所以也叫字型大小最大值）
    3.3 文本使用字型大小最大值應顯示的寬度PreWidth（可通過Paint、Text、MaxSize獲得）
    3.4 空間的寬度canvasWidth（即畫布寬度，可在View的onSizeChanged方法中獲得）；
   
    那麼，當空間不足以顯示文本時，應通過已知條件計算canvasWidth應對應的字型大小大小 X，
    如何計算呢？
    經過分析，大字體顯示的寬度與小字體顯示的寬度比值應是一致的，所以，公式如下：
    MaxSize / PreWidth = x / canvasWidth;   
    x = MaxSize * canvasWidth / PreWidth;
    x 就是我們需要重新設置的字型大小。
    得到字型大小，我們就可以為畫筆設置文字大小了，也就可以通過畫筆畫出合適大小的文字了。

4. 繪製文本，文本的坐標如何處理呢？
    此處我們以居中顯示為例：
    我們可以通過文本寬高與畫布寬高可計算出文字應被繪製的位置（x,y）
    例如：
    容器（即畫布）寬10，高10，文字寬4，高4，我們把容器和文字分別想象成兩個矩形，
    如何使文字矩形居中顯示在容器矩形里，需要我們算出文字矩形左上角的位置（x,y），即文字繪製的位置，
    其實也很簡單：
    x = （容器寬 - 文字寬）/ 2 = 1(0 - 4) / 3 = 3
    y = (容器高 - 文字高 ) / 2 = 3

    如果我們直接使用這個（x,y）直接繪製文本，得到的結果是文字位置向上偏移了，這不是我們想要的結果。
    其實，文本繪製是根據基線（baseline）來繪製的，我們還需要瞭解文本繪製時的結構計算。
    （文本如何繪製，下麵會有介紹）

好了，基礎知識點分析完了，我們先熟悉一下這些基礎吧！
***

繪圖基礎

本章介紹的基礎知識僅介紹當前需要用到的，不會特別細緻，如果有需要，請自行查詢資料。
1.Canvas 畫布、Paint畫筆
我們看到的控制項上的內容，其實是繪製在畫布上的，而繪製是使用的畫筆工具。
畫佈有很多方法，如：畫文本、圓、矩形、線、路徑、圖片等；

Canvas（畫布）提供的畫文本的方法：
    public void drawText(char[] text, int index, int count, float x, float y, Paint paint) {
        throw new RuntimeException("Stub!");
    }

    public void drawText(String text, float x, float y, Paint paint) {
        throw new RuntimeException("Stub!");
    }

    public void drawText(String text, int start, int end, float x, float y, Paint paint) {
        throw new RuntimeException("Stub!");
    }

    public void drawText(CharSequence text, int start, int end, float x, float y, Paint paint) {
        throw new RuntimeException("Stub!");
    }

畫筆可以設置我們想要的效果，如顏色、字體、字型大小、線粗細等；

Paint（畫筆）設置文本屬性的一些主要方法：
    //設置文本大小
    public void setTextSize(float textSize) {
        throw new RuntimeException("Stub!");
    }
    //設置顏色
    public void setColor(int color) {
        throw new RuntimeException("Stub!");
    }
    //設置文本間距
    public void setLetterSpacing(float letterSpacing) {
        throw new RuntimeException("Stub!");
    }
    //設置文本對齊方式
    public void setTextAlign(Paint.Align align) {
        throw new RuntimeException("Stub!");
    }
   //設置文本文字類型：如：宋體、黑體、平方等字體
    public Typeface setTypeface(Typeface typeface) {
        throw new RuntimeException("Stub!");
    }
    //計算文本寬度（根據設置的字型大小大小，要繪製的文本內容，計算並返回該文本應占用的寬度）
    public float measureText(String text) {
        throw new RuntimeException("Stub!");
    }
    ...
    還有很多設置文本的方法，可以自行查找！！！

具體，可參考這篇文章：
https://www.jianshu.com/p/f69873371763
https://blog.csdn.net/ttjay000/article/details/73876973

2.文本繪製
想把文字精準的繪製到屏幕上，
需要瞭解字體測量類：FontMetrics，以及該類的top,ascent,descent,bottom,leading五個成員變數；
繪製的起始點基於Baseline.png
如果我們想在畫布的最左上角（即（0,0）位置）開始繪製文本，繪製完成後，我們看到的是如上圖所示的Baseline以下的部分，而上面的部分我們是看不到的。

原因很簡單，文本的繪製，是基於Baseline的，如果我們直接設置繪製的位置是（0,0），即 Baseline的位置是（0,0），如上圖所示，Baseline以上的文本肯定被繪製在控制項上面去了，即y為負數，所以我們看不到Baseline以上的內容。

那麼，我們應該如何做才能將文字繪製在我們想要的位置呢，其實很簡單，我們只需要讓Baseline的位置向下偏移就可以了，但是偏移多少呢？
再看上圖，我們只需要拿到文本的上面的幾個屬性（ascent等），就可以算出來了。

具體可參考這篇文章：
https://www.cnblogs.com/tianzhijiexian/p/4297664.html

代碼實現

自定義控制項類：AutoTextView

package iwangzhe.customautosizetextview;
import android.content.Context;
import android.graphics.Canvas;
import android.graphics.Paint;
import android.util.AttributeSet;
import android.view.View;
import android.widget.TextView;

/**
 * 類：AutoTextView
 * 作者： qxc
 * 日期：2018/4/3.
 */
public class AutoTextView extends View {
    private Context context;//上下文
    private int canvasWidth;//畫布寬度
    private int canvasHeight;//畫布高度
    private Paint paint;//畫筆

    private int maxTextSize = 50;//外界傳入的預設字型大小（最大字型大小），單位SP，如果不傳入，我們預設50sp，大家可自行修改
    private String text = "";//外界傳入的文本內容
    public AutoTextView(Context context) {
        super(context);
        this.context = context;
        initPaint();//初始化畫筆屬性
    }

    public AutoTextView(Context context, AttributeSet attrs) {
        super(context, attrs);
        this.context = context;
        initPaint();//初始化畫筆屬性
    }

    //初始化畫筆屬性
    private void initPaint(){
        //設置防鋸齒
        paint = new Paint(Paint.ANTI_ALIAS_FLAG);
        //設置畫筆寬度
        paint.setStrokeWidth(1);
    }

    /**
     * 設置文本（供外界調用）
     * @param text 文本
     */
    public AutoTextView setText(String text){
        this.text = text;
        return this;
    }

    /**
     * 設置支持的最大文本字型大小（供外界調用）
     * @param size 文本字型大小
     */
    public AutoTextView setMaxTextSize(int size){
        this.maxTextSize = size;
        return this;
    }

    @Override
    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
        super.onSizeChanged(w, h, oldw, oldh);
        //每一次外觀變化，都會調用該方法
        this.canvasWidth = getWidth();//獲得畫布寬度
        this.canvasHeight = getHeight();//獲得畫布高度
    }

    @Override
    protected void onDraw(Canvas canvas) {
        //每次重繪，繪製傳遞進來的文本信息
        drawText(canvas);
    }

    //繪製文本
    private void drawText(Canvas canvas){
        //根據畫布寬度，獲得合適的字型大小（即：剛好能顯示滿當前寬度的字型大小，與maxsize相比，只能小不能大）
        float textSize = getRightSize();
        //為畫筆設置上合適的字型大小
        paint.setTextSize(sp2px(textSize));

        // 計算Baseline繪製的起點X軸坐標 ，計算方式：畫布寬度的一半 - 文字寬度的一半
        int x = (int) (canvasWidth / 2 - paint.measureText(text) / 2);

        //int x = 0;
        // 計算Baseline繪製的Y坐標 ，計算方式：畫布高度的一半 - 文字總高度的一半
        int y = (int) ((canvasHeight / 2) - ((paint.descent() + paint.ascent()) / 2));

        //繪製文本
        canvas.drawText(text,x,y,paint);
    }

    //獲得合適的字型大小
    private float getRightSize(){
        paint.setTextSize(sp2px(maxTextSize));
        paint.setTextAlign(Paint.Align.LEFT);
        //根據最大值，計算出當前文本占用的寬度
        float preWidth = paint.measureText(text);
        //如果文本占用的寬度比畫布寬度小，說明不用伸縮，直接返回當前字型大小
        if(preWidth<canvasWidth){
            return maxTextSize;
        }
        //已知當前文本字型大小、文本占用寬度、畫布寬度，計算出合適的字型大小，並返回
        return maxTextSize*canvasWidth/preWidth;
    }
    
    //實際繪製時，需要使用像素進行繪製，此處提供sp 轉 px的方法
    private int sp2px(float spValue) {
        final float scale = context.getResources().getDisplayMetrics().density;
        return (int) (spValue * scale + 0.5f);
    }
}

調用方類與佈局文件：MainActivity
使用SeekBar模擬文本控制項寬度變化（即：容器大小變化）

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="iwangzhe.customautosizetextview.MainActivity">

    <iwangzhe.customautosizetextview.AutoTextView
        android:layout_width="match_parent"
        android:background="#eeeeee"
        android:layout_height="50dp"
        android:layout_marginTop="20dp"
        android:id="@+id/atv" />

    <SeekBar
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@+id/atv"
        android:layout_marginTop="50dp"
        android:progress="100"
        android:id="@+id/sb" />
</RelativeLayout>

package iwangzhe.customautosizetextview;
import android.content.Context;
import android.content.res.Configuration;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.RelativeLayout;
import android.widget.SeekBar;

public class MainActivity extends AppCompatActivity {
    SeekBar sb;
    AutoTextView atv;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        initView();
        initEvent();
    }

    void initView(){
        sb = (SeekBar) findViewById(R.id.sb);
        sb.setProgress(100);
        atv = (AutoTextView) findViewById(R.id.atv);
        //設置測試數據
        atv.setText("一二三四五六七八九十").setMaxTextSize(50);
    }

    void initEvent(){
        //使用SeekBar模擬文本控制項寬度變化（即：容器大小變化）
        sb.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int i, boolean b) {
                RelativeLayout.LayoutParams linearParams = (RelativeLayout.LayoutParams) atv.getLayoutParams();
                linearParams.height = dip2px(MainActivity.this, 50);
                linearParams.width = i * sb.getWidth()/100;
                atv.setLayoutParams(linearParams);
            }

            @Override
            public void onStartTrackingTouch(SeekBar seekBar) {

            }

            @Override
            public void onStopTrackingTouch(SeekBar seekBar) {

            }
        });
    }

    public static int dip2px(Context context, float dpValue) {
        final float scale = context.getResources().getDisplayMetrics().density;
        return (int) (dpValue * scale + 0.5f);
    }
}

總結：
此控制項使用起來，很簡單，但是技術點很實用，以後做動態報表的自定義控制項時，都會用到。
如果大家想要增加設置文本字體、加粗、下劃線等樣式，請參考該示例，自行擴展即可。
本文章，主要是為了讓大家瞭解 使用畫布畫筆 自定義控制項的過程，如果想在自己的項目中使用，請根據需要自行調整優化。

Demo下載地址：
（為了減小Demo大小，我刪除了build下的文件，大家獲取後rebuild一下代碼，就可以了）
https://pan.baidu.com/s/1Fu81a-Efki_MpTDkfls0JA


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 排坑日記之批量從庫IO進程停止
    早上剛睜眼，看到了一堆資料庫告警的簡訊,其中一個內容如下： 眼看這是剛從其他DBA交接過來的資料庫,不敢怠慢,立馬起來查看從庫日誌信息如下： 即非正常停止。 再登錄主庫機器查看主庫錯誤日誌，信息如下 從主庫日誌可以看出，2個從庫是主庫主動斷開的,而給出的信息也指出了原因failed on flush ...
  • Microsoft SQL Server 2012安裝說明
    Microsoft SQL Server 2012安裝說明 環境：Windows8, Windows7, WinVista, Win2003, WinXP Microsoft SQL Server 2012是一款強大的MySQL資料庫管理和開發工具。新版的Microsoft SQL Server 2 ...
  • 52個有效方法(1) - 瞭解Objective-C語言的起源
    1. Objective C語言使用的是"消息結構"而非"函數調用"。 "消息結構"和"函數調用"之間的區別 "消息結構"的語言: 運行時由運行環境決定所應執行的代碼 "函數調用"的語言: 由編譯器決定 記憶體模型：Objective C語言中的指針是用來指示對象的。 Objective C為C語言添 ...
  • alibaba/flutter_boost
    flutterBoost使用筆記 新一代Flutter-Native混合解決方案。 FlutterBoost是一個Flutter插件，它可以輕鬆地為現有原生應用程式提供Flutter混合集成方案。FlutterBoost的理念是將Flutter像Webview那樣來使用。在現有應用程式中同時管理Na ...
  • Flutter學習筆記（29）--Flutter如何與native進行通信
    如需轉載，請註明出處：Flutter學習筆記（29）--Flutter如何與native進行通信 前言：在我們開發Flutter項目的時候，難免會遇到需要調用native api或者是其他的情況，這時候就需要處理Flutter與native的通信問題，一般常用的Flutter與native的通信方式 ...
  • Flutter 的基本控制項
    文本控制項 Text 支持兩種類型的文本展示，一個是預設的展示單一樣式文本 Text，另一個是支持多種混合樣式的富文本 Text.rich。 單一樣式文本 Text 單一樣式文本 Text 的初始化，是要傳入需要展示的字元串。而這個字元串的具體展示效果，受構造函數中的其他參數控制。這些參數大致可以分為 ...
  • Flutter學習筆記（28）--使用第三方jar包
    如需轉載，請註明出處：Flutter學習筆記（28）--使用第三方jar包 1.打開一個Flutter項目，點擊編碼視窗右上角的Open for Editing in Android Studio，這時候你的Flutter項目會轉換成一個Android結構的項目。 2.項目的目錄結構選擇projec ...
  • Android原生PDF功能實現
    1、背景 近期，公司希望實現安卓原生端的PDF功能，要求：高效、實用。 經過兩天的調研、編碼，實現了一個簡單Demo，如上圖所示。 關於安卓原生端的PDF功能實現，技術點還是很多的，為了咱們安卓開發的同學少走彎路，通過此文章，簡單講解下Demo的實現原理和主要技術點，並附上源碼。 2、安卓PDF現狀 ...
一周排行
    -Advertisement-
    Play Games
  • .net 6 C#中System.IO.Path類的用法
    1. 說明 /* Performs operations on System.String instances that contain file or directory path information. These operations are performed in a cross-pla ...
  • 使用WebApi+Vue3從0到1搭建《許可權管理系統》:二、搭建JWT系統鑒權
    視頻地址：【WebApi+Vue3從0到1搭建《許可權管理系統》系列視頻：搭建JWT系統鑒權-嗶哩嗶哩】 https://b23.tv/R6cOcDO qq群:801913255 一、在appsettings.json中設置鑒權屬性 /*jwt鑒權*/ "JwtSetting": { "Issuer" ...
  • 實戰指南：使用 xUnit 和 ASP.NET Core 進行集成測試【完整教程】
    引言 集成測試可在包含應用支持基礎結構（如資料庫、文件系統和網路）的級別上確保應用組件功能正常。 ASP.NET Core 通過將單元測試框架與測試 Web 主機和記憶體中測試伺服器結合使用來支持集成測試。 簡介 集成測試與單元測試相比，能夠在更廣泛的級別上評估應用的組件，確認多個組件一起工作以生成預 ...
  • .NET Emit 入門教程：第六部分：IL 指令：9：詳解 ILGenerator 指令方法：運算操作指令（指令篇結束）
    在.NET Emit編程中，我們探討了運算操作指令的重要性和應用。這些指令包括各種數學運算、位操作和比較操作，能夠在動態生成的代碼中實現對數據的處理和操作。通過這些指令，開發人員可以靈活地進行算術運算、邏輯運算和比較操作，從而實現各種複雜的演算法和邏輯......本篇之後，將進入第七部分：實戰項目 ...
  • WPF多表頭表格實現
    前言 多表頭表格是一個常見的業務需求，然而WPF中卻沒有預設實現這個功能，得益於WPF強大的控制項模板設計，我們可以通過修改控制項模板的方式自己實現它。 一、需求分析 下圖為一個典型的統計表格，統計1-12月的數據。 此時我們有一個需求，需要將月份按季度劃分，以便能夠直觀地看到季度統計數據，以下為該需求 ...
  • gRPC入門學習之旅（七）
    如何將 ASP.NET Core MVC 項目的視圖分離到另一個項目 在當下這個年代 SPA 已是主流，人們早已忘記了 MVC 以及 Razor 的故事。但是在某些場景下 SSR 還是有意想不到效果。比如某些靜態頁面，比如追求首屏載入速度的時候。最近在項目中回歸傳統效果還是不錯。 有的時候我們希望將 ...
  • System.AggregateException: 發生一個或多個錯誤.....
    System.AggregateException: 發生一個或多個錯誤。 > Microsoft.WebTools.Shared.Exceptions.WebToolsException: 生成失敗。檢查輸出視窗瞭解更多詳細信息。 內部異常堆棧跟蹤的結尾 > (內部異常 #0) Microsoft ...
  • 精通中間件測試：Asp.Net Core實戰指南，提升應用穩定性和可靠性
    引言 在上一章節我們實戰了在Asp.Net Core中的項目實戰，這一章節講解一下如何測試Asp.Net Core的中間件。 TestServer 還記得我們在集成測試中提供的TestServer嗎？ TestServer 是由 Microsoft.AspNetCore.TestHost 包提供的。 ...
  • Case表達式
    在發現結果為真的WHEN子句時,CASE表達式的真假值判斷會終止,剩餘的WHEN子句會被忽略: CASE WHEN col_1 IN ('a', 'b') THEN '第一' WHEN col_1 IN ('a') THEN '第二' ELSE '其他' END 註意: 統一各分支返回的數據類型. ...
  • 揭秘：C#語法中“_ =” 是什麼？
    在C#編程世界中，語法的精妙之處往往體現在那些看似微小卻極具影響力的符號與結構之中。其中，“_ =” 這一組合突然出現還真不知道什麼意思。本文將深入剖析“_ =” 的含義、工作原理及其在實際編程中的廣泛應用，揭示其作為C#語法奇兵的重要角色。 一、下劃線 _：神秘的棄元符號 下劃線 _ 在C#中並非 ...
所有分類