zoukankan      html  css  js  c++  java
  • 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

  • 相关阅读:
    XSLT轻松入门收藏贴
    [网摘学习]使用openstack构建私有云计算平台
    [网摘学习]关于OpenStack架构
    [问题]django_openstack.templatetags
    [网摘学习]5个Linux命令
    关于git使用 命令参考
    [openstack问题]dashboard无法登陆进去的问题
    前台显示后台变量值
    实现浏览器垂直水平居中的 DIV
    IsPostBack作用
  • 原文地址:https://www.cnblogs.com/qixingchao/p/11652389.html
Copyright © 2011-2022 走看看