221 lines
		
	
	
		
			7.0 KiB
		
	
	
	
		
			Vue
		
	
	
	
			
		
		
	
	
			221 lines
		
	
	
		
			7.0 KiB
		
	
	
	
		
			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>
 |