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

posted @ 2019-10-12 08:05  齐行超  阅读(2160)  评论(0编辑  收藏  举报