Android自定义控件：自适应大小的文本控件

---

需求

自适应大小的文本：
效果图：

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