Android花样loading进度条（三）-配文字环形进度条

背景

Android花样loading进度条系列文章主要讲解如何自定义所需的进度条，包括水平、圆形、环形、圆弧形、不规则形状等。  
本篇我们继续从圆环形进度条讲起，讲配文字的环形进度条，不仅有进度色彩，还有进度提示和文字说明，主要是使用Canvas绘制圆和圆弧、绘制文字。

效果

先上图看效果，这里有4个进度条，样式上有微妙区别，基本都属于一个类别的进度条了。  

4个进度条基本上分为3类：

1. 带文字的进度条；

2. 不带文字的进度条；

3. 带自定义字体的进度条

我们以第1种作为基本示例来讲解，需要准备的知识点有：

• 自定义控件的坐标轴；

• Canvas圆环、圆弧绘制方法；

• Canvas文字绘制方法

• 自定义属性；

• Handler消息处理机制。

其中除了Canvas文字绘制方法没有说，其他都在上一篇 Android花样loading进度条（二）-简单环形进度条一文中有讲解过。

Canvas文字绘制

Canvas类提供了文字绘制方法：

android.graphics.Canvas#drawText(String text, float x, float y, Paint paint)

此方法还有几个重载的方法，我们这里就用到这个方法就可以了。参数说明：

• text：要绘制的文字；

• x：文字绘制起始的x坐标；

• y：文字绘制baseline位置（具体可以查阅其他资料），在使用时调优即可；

• paint：绘制时用到的画笔。

自定义属性

配文字的环形进度条控件一般定义的属性有：

• 圆环的颜色；

• 圆环的宽度；

• 圆环上的进度颜色；

• 圆环上的进度宽度；

• 文字大小；

• 文字颜色；

• 百分比大小等。

为此，我们定义attrs.xml配置文件的内容为：

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <!--配文字环形进度-->
    <declare-styleable name="TextRoundProgress">
        <!--圆环颜色-->
        <attr name="trp_roundColor" format="color" />
        <!--圆环的宽度-->
        <attr name="trp_roundWidth" format="dimension" />
        <!--圆环上的进度颜色-->
        <attr name="trp_progressColor" format="color" />
        <!--圆环上的进度宽度-->
        <attr name="trp_progressWidth" format="dimension" />
        <!--文字内容-->
        <attr name="trp_text" format="string" />
        <!--文字指示颜色-->
        <attr name="trp_textColor" format="color" />
        <!--文字指示字体大小-->
        <attr name="trp_textSize" format="dimension" />
        <!--数字指示字体大小-->
        <attr name="trp_numSize" format="dimension" />
        <!--进度值的最大值，一般为100-->
        <attr name="trp_max" format="integer" />
        <!--是否显示文字指示内容-->
        <attr name="trp_textShow" format="boolean" />
        <!--开始角度，指定进度初始点的绘制位置-->
        <attr name="trp_startAngle" format="integer" />
        <!--是否使用自定义字体-->
        <attr name="trp_userCustomFont" format="boolean" />
    </declare-styleable>
</resources>

有了属性定义后，我们在绘制的时候结合这些属性就可以按设置值绘制了。

进度条图形绘制

1、基础绘制
分两步走，第一步绘制背景环；第二步绘制前景进度环，这两步可以参考 Android花样loading进度条（二）-简单环形进度条。
2、绘制文字
由于本篇在上一篇简单环形进度上加了文字，有一些基础部分重合了，本篇主要讲差异化的部分，即绘制文字部分。

// step3 画文字指示
paint.setStrokeWidth(0);
paint.setColor(textColor);
paint.setTextSize(textSize);
// 计算百分比
int percent = (int) (((float) progress / (float) max) * 100);

if (textShow && text != null && text.length() > 0 && percent >= 0) {
    // 3.1 画文字
    paint.setTypeface(Typeface.DEFAULT); // 设置为默认字体
    float textWidth = paint.measureText(text); // 测量字体宽度
    canvas.drawText(text, centerX - textWidth / 2, centerX + textSize + 5, paint);
    // 3.2 画百分比
    paint.setTextSize(numSize);
    if (useCustomFont) {
        paint.setTypeface(AppResource.getTypeface(getContext())); // 设置字体
    } else {
        paint.setTypeface(Typeface.DEFAULT_BOLD); // 设置为加粗默认字体
    }
    float numWidth = paint.measureText(percent + "%"); // 测量字体宽度，我们需要根据字体的宽度设置在圆环中间
    canvas.drawText(percent + "%", centerX - numWidth / 2, centerX, paint); // 画出进度百分比
}

作解释如下：

• percent：进度值对应的百分比，比较好理解；

• textWidth：使用画笔测量出的文字宽度；

• centerX 表示控件中心x坐标，centerX - textWidth / 2表示的点在中心向左偏移字体一半的长度；

• drawText方法参数x=(centerX - textWidth / 2)表示文字要横向居中；

• drawText方法参数y=(centerX + textSize + 5)表示文字竖向位置，由于这里不是垂直居中的，就是靠参数调出来的效果，不具有普及型；

• paint.setTypeface：本方法可以设置画笔使用的文字字体。

至此，进度条绘制就完成了，整个TextRoundProgress的代码为：

package com.dommy.loading.widget;

import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.Paint;
import android.graphics.RectF;
import android.graphics.Typeface;
import android.util.AttributeSet;
import android.view.View;

import com.dommy.loading.R;
import com.dommy.loading.util.AppResource;

/**
 * 配文字环形进度条
 */
public class TextRoundProgress extends View {
    private Paint paint; // 画笔对象的引用
    private int roundColor; // 圆环的颜色
    private float roundWidth; // 圆环的宽度
    private int progressColor; // 圆环进度的颜色
    private float progressWidth; // 圆环进度的宽度
    private String text; // 文字内容
    private int textColor; // 中间进度百分比的字符串的颜色
    private float textSize; // 中间进度百分比的字符串的字体大小
    private float numSize; // 中间进度文本大小
    private int max; // 最大进度
    private int startAngle; // 进度条起始角度
    private boolean textShow; // 是否显示中间的进度
    private boolean useCustomFont; // 是否使用自定义字体
    private int progress; // 当前进度

    public TextRoundProgress(Context context) {
        this(context, null);
    }

    public TextRoundProgress(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }

    public TextRoundProgress(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);

        paint = new Paint();

        // 读取自定义属性的值
        TypedArray mTypedArray = context.obtainStyledAttributes(attrs, R.styleable.TextRoundProgress);

        // 获取自定义属性和默认值
        roundColor = mTypedArray.getColor(R.styleable.TextRoundProgress_trp_roundColor, Color.RED);
        roundWidth = mTypedArray.getDimension(R.styleable.TextRoundProgress_trp_roundWidth, 5);
        progressColor = mTypedArray.getColor(R.styleable.TextRoundProgress_trp_progressColor, Color.GREEN);
        progressWidth = mTypedArray.getDimension(R.styleable.TextRoundProgress_trp_progressWidth, roundWidth);
        text = mTypedArray.getString(R.styleable.TextRoundProgress_trp_text);
        textColor = mTypedArray.getColor(R.styleable.TextRoundProgress_trp_textColor, Color.GREEN);
        textSize = mTypedArray.getDimension(R.styleable.TextRoundProgress_trp_textSize, 11);
        numSize = mTypedArray.getDimension(R.styleable.TextRoundProgress_trp_numSize, 14);
        max = mTypedArray.getInteger(R.styleable.TextRoundProgress_trp_max, 100);
        startAngle = mTypedArray.getInt(R.styleable.TextRoundProgress_trp_startAngle, 90);
        textShow = mTypedArray.getBoolean(R.styleable.TextRoundProgress_trp_textShow, true);
        useCustomFont = mTypedArray.getBoolean(R.styleable.TextRoundProgress_trp_userCustomFont, false);
        mTypedArray.recycle();
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);

        int centerX = getWidth() / 2; // 获取圆心的x坐标
        int radius = (int) (centerX - roundWidth / 2); // 圆环的半径

        // step1 画最外层的大圆环
        paint.setStrokeWidth(roundWidth); // 设置圆环的宽度
        paint.setColor(roundColor); // 设置圆环的颜色
        paint.setAntiAlias(true); // 消除锯齿
        // 设置画笔样式
        paint.setStyle(Paint.Style.STROKE);
        canvas.drawCircle(centerX, centerX, radius, paint); // 画出圆环

        // step2 画圆弧-画圆环的进度
        paint.setStrokeWidth(progressWidth); // 设置画笔的宽度使用进度条的宽度
        paint.setColor(progressColor); // 设置进度的颜色
        RectF oval = new RectF(centerX - radius, centerX - radius, centerX + radius, centerX + radius); // 用于定义的圆弧的形状和大小的界限

        int sweepAngle = 360 * progress / max; // 计算进度值在圆环所占的角度
        // 根据进度画圆弧
        canvas.drawArc(oval, startAngle, sweepAngle, false, paint);

        // step3 画文字指示
        paint.setStrokeWidth(0);
        paint.setColor(textColor);
        paint.setTextSize(textSize);
        // 计算百分比
        int percent = (int) (((float) progress / (float) max) * 100);

        if (textShow && text != null && text.length() > 0 && percent >= 0) {
            // 3.1 画文字
            paint.setTypeface(Typeface.DEFAULT); // 设置为默认字体
            float textWidth = paint.measureText(text); // 测量字体宽度
            canvas.drawText(text, centerX - textWidth / 2, centerX + textSize + 5, paint);
            // 3.2 画百分比
            paint.setTextSize(numSize);
            if (useCustomFont) {
                paint.setTypeface(AppResource.getTypeface(getContext())); // 设置字体
            } else {
                paint.setTypeface(Typeface.DEFAULT_BOLD); // 设置为加粗默认字体
            }
            float numWidth = paint.measureText(percent + "%"); // 测量字体宽度，我们需要根据字体的宽度设置在圆环中间
            canvas.drawText(percent + "%", centerX - numWidth / 2, centerX, paint); // 画出进度百分比
        }
    }

    /**
     * 设置进度的最大值
     * <p>根据需要，最大值一般设置为100，也可以设置为1000、10000等</p>
     *
     * @param max int最大值
     */
    public synchronized void setMax(int max) {
        if (max < 0) {
            throw new IllegalArgumentException("max not less than 0");
        }
        this.max = max;
    }

    /**
     * 获取进度
     *
     * @return int 当前进度值
     */
    public synchronized int getProgress() {
        return progress;
    }

    /**
     * 设置进度，此为线程安全控件
     *
     * @param progress 进度值
     */
    public synchronized void setProgress(int progress) {
        if (progress < 0) {
            throw new IllegalArgumentException("progress not less than 0");
        }
        if (progress > max) {
            progress = max;
        }
        this.progress = progress;
        // 刷新界面调用postInvalidate()能在非UI线程刷新
        postInvalidate();
    }
}

配文字环形进度条的使用

1、页面控件配置
自定义控件在页面中使用时，要使用类名来作为标签，自定义属性要通过命名空间引入，整体如：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    ...
    tools:context="com.dommy.loading.TextRoundActivity">

    ...

    <com.dommy.loading.widget.TextRoundProgress
        android:id="@+id/trp_0"
        android:layout_width="100dip"
        android:layout_height="100dip"
        android:layout_gravity="center"
        app:trp_max="100"
        app:trp_numSize="22sp"
        app:trp_progressColor="@color/red_web"
        app:trp_roundColor="@color/pro_bg"
        app:trp_roundWidth="6dip"
        app:trp_startAngle="0"
        app:trp_text="空气质量"
        app:trp_textColor="@color/red_web"
        app:trp_textSize="10sp" />

    ...
</LinearLayout>

界面编写时的preview效果：  

2、Activity代码控制
通过调用方法

com.dommy.loading.widget.TextRoundProgress#setProgress

就可以设置控件显示指定的进度，如：

trp0.setProgress(49);1

3、让进度动起来
通过Thread+Handler动态增加的方法，不断更新界面就可以达到动起来的效果：

改变效果

1、更改外观
进度的宽度、颜色、字体大小等可以通过自定义属性直接修改。

2、更改字体
在上述代码中我们保留了使用自定义字体的属性，如果app:trp_userCustomFont属性设置为true，则使用我们自定义的字体。

自定义文字字体

1、新建asserts目录
在项目目录main上右键按图步骤新建出asserts目录。

2、引入外部字体
在asserts目录下放置我们需要用的外部字体，我们这里放在fonts文件夹下，有一个数字字体，用在百分比上面的。

3、使用外部字体
在配文字环形进度条绘制过程中：

paint.setTypeface(AppResource.getTypeface(getContext())); // 设置字体

这行代码就实现了文字字体的更改，其中AppResource.getTypeface方法的源码为：

package com.dommy.loading.util;

import android.content.Context;
import android.graphics.Typeface;

/**
 * APP资源配置
 *
 * @author Dommy
 */
public class AppResource {
    private static Typeface typeface = null; // 公共字体

    /**
     * 获取自定义字体
     *
     * @param context
     * @return Typeface 字体
     */
    public static Typeface getTypeface(Context context) {
        if (typeface == null) {
            typeface = Typeface.createFromAsset(context.getAssets(), "fonts/AkzidenzGrotesk-LightCond.otf");
        }
        return typeface;
    }
}

此处使用数字字体AkzidenzGrotesk-LightCond，体现到进度条上的效果为：

更换字体后的数字显得比较纤细，可以根据需要选择更多的字体和自定义扩展属性。

源码下载

待上传后补上。

原文出处