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 MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類