⼀起学Vue⾃定义组件之进度条
在⽇常开发中,随着需求的个性化,逻辑的复杂化,⾃定义组件也变得越来越常见,⽽且组件具有扩展性强,易复⽤,封装复杂的代码逻辑等优点,可以⽤⼩组件来构建⼤型应⽤系统。本⽂以⼀个简单的⼩例⼦,简述Vue进⾏组件开发的常见步骤,如有不⾜之处,还请指正。
涉及知识点
本⽂案例,不仅⽤到了之前的基础知识,如:v-if, 样式绑定,属性传值等,还⽤到了组件的特有知识,如下所⽰:
组件:可复⽤的Vue实例,具有封装,复⽤等特点。
Vue项⽬构建:⼀个vue后缀的⽂件,就表⽰⼀个组件。但是浏览器并不认识vue⽂件,所有需要进⾏编译才能运⾏,Vue提供了⼀个脚⼿架(CLI)来编译运⾏项⽬。
组件构成:由props(属性),computed(计算属性),method(⽅法)等构成,来⽀持组件的不同需求。
开发⼯具:Visual Studio Code
运⾏⼯具:Vue CLI 运⾏命令:vue serve
设计思路
1. 进度条分类:线性进度条(采⽤DIV嵌套实现),环形进度条(采⽤SVG实现)。
2. 提取共性特征:颜⾊,⾼度,显⽰内容,图标样式等属性值的提取,根据属性来区分展⽰的,采⽤计算属性实现。
3. 图标样式:本例中的图标样式采⽤Wingdings字体实现,可通过windows-->附件-->字符映射表去查询。
⽰例效果图
线性进度条:分为进度显⽰在右侧,还是内侧且跟随进度条移动。如下所⽰:
环形进度条:⼤⼩可以设置,显⽰内容和线性进度条⼀致。如下所⽰:
核⼼代码
本例所有代码进⾏封装【Progress.vue】主要包含三部分:模板(template)脚本(script)样式(style)。
⼀个template下只能包含⼀个div,但是div下可以包含多个⼦节点。如下所⽰:
1<template>
2<div class="progress " :class="'progress--'+ptype">
3<!-- 条形进度条 -->
4<div class="progress-bar" v-if="ptype==='line'">
5<div class="progress-bar__outer" :>
6<div class="progress-bar__inner" :>
7<!-- 进度条内显⽰百分⽐ -->
8<div v-if="textInside" class="progress__text" > {{percentage}}% </div>
9</div>
10</div>
11
12</div>
13<!-- 环形进度条采⽤SVG实现 -->
14<div class="progress_circle" : v-else>
15<svg viewBox="0 0 100 100" :>
16<!-- 背景圆形 -->
17<path :d="trackPath" fill="none" :stroke-width="relativeStrokeHeight" stroke="#e5e9f2"/>
18<!-- 进度圆形 -->
19<path :d="trackPath" fill="none" :stroke-width="relativeStrokeHeight" :stroke="stroke" : stroke-linecap="round"/> 20</svg>
21</div>
22<div v-if="!textInside" class="progress__text" :>
23<template v-if="!status"> {{percentage}}% </template>
24<i v-else class="icon" :class="iconCls"></i>
25</div>
26</div>
27</template>
View Code
script部分,本例主要⽤到props,和computed,如下所⽰:
1 <script>
2 export default {
3 props:{
4 strokeHeight:{
5// 进度条⾼度
6// required:true,
7 type:Number,
8default:10
9 },
10 percentage:{
11// 进度条百分⽐
12 type:Number,
13default:0,
14 required:true,
15 valiator(value){
16return value>=0 && value<=100
17 },
18 },
19 status:{
20// 进度条状态:正常状态,成功状态,异常状态
21 type:String,
22
23 },
24 ptype:{
margin属性值可以为百分比25// 进度条样式:条形,还是圆形
26 type:String,
27default:'line',
28 validator:val=>['circle','line'].includes(val)
29 },
30 textInside:{
31// ⽂字是否內显
32 type:Boolean,
33default:false,
34 },
35 pcolor:{
36// 进度条颜⾊
37 type:String
38 },
39 cwidth:{
40 type:Number,
41default:126,
42 }
43 },
44 computed:{
45 progressTextSize(){
46return 9+this.strokeHeight*0.4;
47 },
48 stroke(){
49 let color;
50if(this.pcolor){
51return this.pcolor;
52 }
53switch(this.status){
54case 'success':
55 color='#13ce66';
56break;
57case 'failure':
58 color='#ff4949';
59break;
60default:
61 color='#20a0ff';
62break;
63 }
64return color;
65 },
66 barStyle(){
67// 计算属性调⽤其他计算属性,必须加this关键字,否则不到
68return {width:this.percentage+'%',backgroundColor:this.stroke}
69 },
70 iconCls(){
71if( this.ptype ==='line'){
72// 如果是线性进度条
73return this.status ==='success'?'icon-circle-check':'icon-circle-close';
74 }else{
75return this.status ==='success'?'icon-check':'icon-close';
76 }
77 },
78 trackPath(){
79 const radius = lativeStrokeHeight/2;
80return 'M 50 50 m 0 -'+radius+' a '+radius+' '+radius+' 0 1 1 0 '+radius*2+' a '+radius+' '+radius+' 0 1 1 0 -'+radius*2+' ' ;
81 },
82 relativeStrokeHeight(){
83return this.strokeHeight*100 / this.cwidth;
84 },
85 perimeter(){
86 const radius = lativeStrokeHeight/2;
87return 2*Math.PI*radius;
88 },
89 circlePathStyle(){
90 const perimeter = this.perimeter;
91return{
92 strokeDasharray:''+perimeter+'px,'+perimeter+'px',
93 strokeDashoffset:(1-this.percentage/100)*perimeter+'px',
94
95 }
96 }
97 }
98 }
99 </script>
View Code
style部分,本例使⽤了伪元素(::before)显⽰图标,如下所⽰:
1<style>
2 .progress{
3 margin: 10px;
4/* border: 1px solid #ffbbff; */
5 }
6 .progress-bar{
7 display:inline-block;
8 width: 98%;
9 box-sizing: border-box; /* 盒模型的⽅式 */
10 margin-right: -50px;
11 padding-right: 50px;
12 }
13 .progress-bar__outer{
14 width: 100%;
15 border-radius: 10px;
16 background-color: #ebeef5;
17 }
18 .progress-bar__inner{
19/* width: 60%; */
20 background-color: rebeccapurple;
21 border-radius: 10px;
22 height: 100%;
23 transition: width 0.6s ease;
24 text-align: right;
25 line-height: 80%;
26 }
27 .progress__text{
28 font-size: 12px;
29 margin-left: 6px;
30 display: inline-block;
31 vertical-align: middle;
32 margin-right: 5px;
33 }
34 .icon-circle-close,.icon-close{
35 font-family: 'Wingdings' !important;
36 color:red;
37 }
38 .icon-circle-check,.icon-check{
39 font-family: 'Wingdings' !important;
40 color:seagreen;
41 }
42
43 .icon-circle-close::before{
44 content: '\FD';
45 }
46 .icon-close::before{
47 content: '\FB';
48 }
49 .icon-circle-check::before{
50 content: '\FE';
51 }
52 .icon-check::before{
53 content: '\FC';
54 }
55
56 .progress_circle{
57/* 环形进度条 */
58 }
59 .progress--circle{
60 display: inline-block;
61 position: relative;
62 }
63
64 .progress--circle .progress__text{
65 position:absolute;
66 top:50%;
67 transform: translateY(-50%);
68 margin-left: 0px;
69 text-align: center;
70 width: 100%;
71 }
72
73</style>
View Code
组件调⽤源码
⾸先引⼊组件,并注册组件,如下所⽰:
1 <script>
2// 组件名称⼤⼩写敏感,不能和已经存在的HTML⾥⾯的控件同名,如果是驼峰形式,则可以⽤短横线的⽅式(如:d=progress)或者和名称保持⼀致
3 import dProgress from './Progress';
4 export default {
5 components:{
6 dProgress
7 },
8
9 }
10 </script>
View Code
然后进⾏调⽤即可,如下所⽰:
1<template>
2
3<div>
4<H2>线性进度条--百分⽐外显</H2>
5<dProgress :percentage="0"/>
6<dProgress :percentage="40" pcolor="orange"/>
7<dProgress :percentage="60" status="success"/>
8<dProgress :percentage="80" status="failure"/>
9<H2>线性进度条--百分⽐内显</H2>
10<dProgress :percentage="0" :text-inside="true" :stroke-height="16"/>
11<dProgress :percentage="40" :text-inside="true" :stroke-height="16"/>
12<dProgress :percentage="60" status="success" :text-inside="true" :stroke-height="16"/>
13<dProgress :percentage="80" status="failure" :text-inside="true" :stroke-height="16"/>
14<h2>环形进度条</h2>
15<dProgress :percentage="0" ptype="circle"/>
16<dProgress :percentage="40" ptype="circle"/>
17<dProgress :percentage="60" ptype="circle" status="success"/>
18<dProgress :percentage="80" ptype="circle" status="failure"/>
19</div>
20</template>
View Code
如需本例完整代码,可以点击代码链接进⾏下载
备注
【曲⽟管】
作者:柳永[宋]
陇⾸云飞,江边⽇晚,烟波满⽬凭阑久。
⼀望关河萧索,千⾥清秋,忍凝眸?
杳杳神京,盈盈仙⼦,别来锦字终难偶。断雁⽆凭,冉冉飞下汀洲,思悠悠。
暗想当初,有多少、幽欢佳会,
岂知聚散难期,翻成⾬恨云愁?
阻追游。每登⼭临⽔,惹起平⽣⼼事,⼀场消黯,永⽇⽆⾔,却下层楼。
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论