yshi/fuintUniapp/uview-ui/components/u-circle-progress/u-circle-progress.vue

<template>
    <view
        class="u-circle-progress"
        :style="{
            width: widthPx + 'px',
            height: widthPx + 'px',
            backgroundColor: bgColor
        }"
    >
        <!-- 支付宝小程序不支持canvas-id属性，必须用id属性 -->
        <canvas
            class="u-canvas-bg"
            :canvas-id="elBgId"
            :id="elBgId"
            :style="{
                width: widthPx + 'px',
                height: widthPx + 'px'
            }"
        ></canvas>
        <canvas
            class="u-canvas"
            :canvas-id="elId"
            :id="elId"
            :style="{
                width: widthPx + 'px',
                height: widthPx + 'px'
            }"
        ></canvas>
        <slot></slot>
    </view>
</template>

<script>
/**
 * circleProgress 环形进度条
 * @description 展示操作或任务的当前进度，比如上传文件，是一个圆形的进度条。注意：此组件的percent值只能动态增加，不能动态减少。
 * @tutorial https://www.uviewui.com/components/circleProgress.html
 * @property {String Number} percent 圆环进度百分比值，为数值类型，0-100
 * @property {String} inactive-color 圆环的底色，默认为灰色(该值无法动态变更)（默认#ececec）
 * @property {String} active-color 圆环激活部分的颜色(该值无法动态变更)（默认#19be6b）
 * @property {String Number} width 整个圆环组件的宽度，高度默认等于宽度值，单位rpx（默认200）
 * @property {String Number} border-width 圆环的边框宽度，单位rpx（默认14）
 * @property {String Number} duration 整个圆环执行一圈的时间，单位ms（默认呢1500）
 * @property {String} type 如设置，active-color值将会失效
 * @property {String} bg-color 整个组件背景颜色，默认为白色
 * @example <u-circle-progress active-color="#2979ff" :percent="80"></u-circle-progress>
 */
export default {
    name: 'u-circle-progress',
    props: {
        // 圆环进度百分比值
        percent: {
            type: Number,
            default: 0,
            // 限制值在0到100之间
            validator: val => {
                return val >= 0 && val <= 100;
            }
        },
        // 底部圆环的颜色（灰色的圆环）
        inactiveColor: {
            type: String,
            default: '#ececec'
        },
        // 圆环激活部分的颜色
        activeColor: {
            type: String,
            default: '#19be6b'
        },
        // 圆环线条的宽度，单位rpx
        borderWidth: {
            type: [Number, String],
            default: 14
        },
        // 整个圆形的宽度，单位rpx
        width: {
            type: [Number, String],
            default: 200
        },
        // 整个圆环执行一圈的时间，单位ms
        duration: {
            type: [Number, String],
            default: 1500
        },
        // 主题类型
        type: {
            type: String,
            default: ''
        },
        // 整个圆环进度区域的背景色
        bgColor: {
            type: String,
            default: '#ffffff'
        }
    },
    data() {
        return {
            // #ifdef MP-WEIXIN
            elBgId: 'uCircleProgressBgId', // 微信小程序中不能使用this.$u.guid()形式动态生成id值，否则会报错
            elId: 'uCircleProgressElId',
            // #endif
            // #ifndef MP-WEIXIN
            elBgId: this.$u.guid(), // 非微信端的时候，需用动态的id，否则一个页面多个圆形进度条组件数据会混乱
            elId: this.$u.guid(),
            // #endif
            widthPx: uni.upx2px(this.width), // 转成px后的整个组件的背景宽度
            borderWidthPx: uni.upx2px(this.borderWidth), // 转成px后的圆环的宽度
            startAngle: -Math.PI / 2, // canvas画圆的起始角度，默认为3点钟方向，定位到12点钟方向
            progressContext: null, // 活动圆的canvas上下文
            newPercent: 0, // 当动态修改进度值的时候，保存进度值的变化前后值，用于比较用
            oldPercent: 0 // 当动态修改进度值的时候，保存进度值的变化前后值，用于比较用
        };
    },
    watch: {
        percent(nVal, oVal = 0) {
            if (nVal > 100) nVal = 100;
            if (nVal < 0) oVal = 0;
            // 此值其实等于this.percent，命名一个新
            this.newPercent = nVal;
            this.oldPercent = oVal;
            setTimeout(() => {
                // 无论是百分比值增加还是减少，需要操作还是原来的旧的百分比值
                // 将此值减少或者新增到新的百分比值
                this.drawCircleByProgress(oVal);
            }, 50);
        }
    },
    created() {
        // 赋值，用于加载后第一个画圆使用
        this.newPercent = this.percent;
        this.oldPercent = 0;
    },
    computed: {
        // 有type主题时，优先起作用
        circleColor() {
            if (['success', 'error', 'info', 'primary', 'warning'].indexOf(this.type) >= 0) return this.$u.color[this.type];
            else return this.activeColor;
        }
    },
    mounted() {
        // 在h5端，必须要做一点延时才起作用，this.$nextTick()无效(HX2.4.7)
        setTimeout(() => {
            this.drawProgressBg();
            this.drawCircleByProgress(this.oldPercent);
        }, 50);
    },
    methods: {
        drawProgressBg() {
            let ctx = uni.createCanvasContext(this.elBgId, this);
            ctx.setLineWidth(this.borderWidthPx); // 设置圆环宽度
            ctx.setStrokeStyle(this.inactiveColor); // 线条颜色
            ctx.beginPath(); // 开始描绘路径
            // 设置一个原点(110,110)，半径为100的圆的路径到当前路径
            let radius = this.widthPx / 2;
            ctx.arc(radius, radius, radius - this.borderWidthPx, 0, 2 * Math.PI, false);
            ctx.stroke(); // 对路径进行描绘
            ctx.draw();
        },
        drawCircleByProgress(progress) {
            // 第一次操作进度环时将上下文保存到了this.data中，直接使用即可
            let ctx = this.progressContext;
            if (!ctx) {
                ctx = uni.createCanvasContext(this.elId, this);
                this.progressContext = ctx;
            }
            // 表示进度的两端为圆形
            ctx.setLineCap('round');
            // 设置线条的宽度和颜色
            ctx.setLineWidth(this.borderWidthPx);
            ctx.setStrokeStyle(this.circleColor);
            // 将总过渡时间除以100，得出每修改百分之一进度所需的时间
            let time = Math.floor(this.duration / 100);
            // 结束角的计算依据为：将2π分为100份，乘以当前的进度值，得出终止点的弧度值，加起始角，为整个圆从默认的
            // 3点钟方向开始画图，转为更好理解的12点钟方向开始作图，这需要起始角和终止角同时加上this.startAngle值
            let endAngle = ((2 * Math.PI) / 100) * progress + this.startAngle;
            ctx.beginPath();
            // 半径为整个canvas宽度的一半
            let radius = this.widthPx / 2;
            ctx.arc(radius, radius, radius - this.borderWidthPx, this.startAngle, endAngle, false);
            ctx.stroke();
            ctx.draw();
            // 如果变更后新值大于旧值，意味着增大了百分比
            if (this.newPercent > this.oldPercent) {
                // 每次递增百分之一
                progress++;
                // 如果新增后的值，大于需要设置的值百分比值，停止继续增加
                if (progress > this.newPercent) return;
            } else {
                // 同理于上面
                progress--;
                if (progress < this.newPercent) return;
            }
            setTimeout(() => {
                // 定时器，每次操作间隔为time值，为了让进度条有动画效果
                this.drawCircleByProgress(progress);
            }, time);
        }
    }
};
</script>

<style lang="scss" scoped>
@import "../../libs/css/style.components.scss";
.u-circle-progress {
    position: relative;
    /* #ifndef APP-NVUE */
    display: inline-flex;        
    /* #endif */
    align-items: center;
    justify-content: center;
}

.u-canvas-bg {
    position: absolute;
}

.u-canvas {
    position: absolute;
}
</style>