cover_image

开发 | 手把手,教你在小程序里做一个圆形进度条

cloud小程序微信开发自定义组件倒计时圆形进度条
凌歌

<p><img class="aligncenter size-large" src="https://images.ifanr.cn/wp-content/uploads/2017/07/minapp-dev-final-feature.jpg" width="1200" height="750" /></p> <p>今天想把之前在微信小程序开发过程中,制作的一个圆形进度条做成一个组件,方便以后直接拿来用。</p> <h3><span style="color: #605eac;">创建自定义组件</span></h3> <p><strong>一、创建项目结构</strong></p> <p>打开微信开发者工具创建一个项目, 新建 与 <code>pages</code> 同级目录 <code>components</code>,在 <code>components</code> 中新建一个目录 <code>circle</code> ,<code>circle</code> 中新建 <code>Component</code> 命名为 circle,此时将自动生成 <code>json</code>、<code>wxml、</code><code>wxss</code>、<code>js</code> 4 个文件。结构如下:</p> <p><img class="aligncenter size-full wp-image-987741" src="https://images.ifanr.cn/wp-content/uploads/2018/02/1-7.png" alt="" width="312" height="510" /></p> <p><strong>二、编写组件</strong></p> <p><strong>首先需要在 <code>json</code> 文件中进行自定义组件声明</strong>(将 <code>component</code> 字段设为 <code>true</code>,可将这一组文件设为自定义组件)。</p> <pre><code>{ "component": true }</code></pre> <p>同时,<strong>还要在 <code>wxml</code> 文件中编写组件模版,在 <code>wxss</code> 文件中加入组件样式</strong>,这里编写圆环进度条的模板和样式,参见微信小程序之圆形进度条。</p> <p>要注意 <code>canvas</code> 绘制的是 px 为单位的,所以这里统一用 px 单位;其中 <code>size</code> 是根据 <code>canvas</code> 绘制的圆环的直径,后面在 <code>js</code> 中会提到。</p> <p>在组件的 <code>wxml</code> 中可以包含 <code>slot</code> 节点,用于承载组件使用者提供的 <code>wxml</code> 结构。</p> <pre><code>&lt;!-- components/circle/circle.wxml --&gt; &lt;view class="circle_box" style="width:{{size}}px;height:{{size}}px"&gt; &lt;canvas class="circle_bg" canvas-id="{{bg}}" style="width:{{size}}px;height:{{size}}px"&gt;&lt;/canvas&gt; &lt;canvas class="circle_draw" canvas-id="{{draw}}" style="width:{{size}}px;height:{{size}}px"&gt;&lt;/canvas&gt; &lt;slot&gt;&lt;/slot&gt; &lt;/view&gt; </code></pre> <p>注意:在组件 <code>wxss</code> 中不应使用 ID 选择器、属性选择器和标签名选择器。</p> <pre><code>/* components/circle/circle.wxss */ .circle_box,.circle_draw{ position: relative; } .circle_bg{position: absolute;}</code></pre> <h3><span style="color: #605eac;">编写 js</span></h3> <p>在自定义组件的 <code>js</code> 文件中,需要使用 <code>Component()</code> 来注册组件,并提供组件的属性定义、内部数据和自定义方法。</p> <p>组件的属性值和内部数据将被用于组件 <code>wxml</code> 的渲染,其中,属性值是可由组件外部传入的。更多细节参考 <span style="color: #605eac;"><a style="color: #605eac;" href="https://mp.weixin.qq.com/debug/wxadoc/dev/framework/custom-component/component.html">Component 构造器</a></span>。</p> <pre><code>/* components/circle/circle.js */ Component({ …… methods: { /* id : canvas 组件的唯一标识符 canvas-id ,x : canvas 绘制圆形的半径, w : canvas 绘制圆环的宽度 */ drawCircleBg: function (id, x, w) { // 设置圆环外面盒子大小 宽高都等于圆环直径 this.setData({ size: 2 * x }); // 使用 wx.createContext 获取绘图上下文 ctx 绘制背景圆环 var ctx = wx.createCanvasContext(id) ctx.setLineWidth(w / 2); ctx.setStrokeStyle('#20183b'); ctx.setLineCap('round') ctx.beginPath();//开始一个新的路径 //设置一个原点(x,y),半径为r的圆的路径到当前路径 此处x=y=r ctx.arc(x, x, x - w, 0, 2 * Math.PI, false); ctx.stroke();//对当前路径进行描边 ctx.draw(); }, drawCircle: function (id, x, w, step) { // 使用 wx.createContext 获取绘图上下文 context 绘制彩色进度条圆环 var context = wx.createCanvasContext(id); // 设置渐变 var gradient = context.createLinearGradient(2 * x, x, 0); gradient.addColorStop("0", "#2661DD"); gradient.addColorStop("0.5", "#40ED94"); gradient.addColorStop("1.0", "#5956CC"); context.setLineWidth(w); context.setStrokeStyle(gradient); context.setLineCap('round') context.beginPath();//开始一个新的路径 // step 从0到2为一周 context.arc(x, x, x - w, -Math.PI / 2, step * Math.PI - Math.PI / 2, false); context.stroke();//对当前路径进行描边 context.draw() }, _runEvent() { //触发自定义组件事件 this.triggerEvent("runEvent") } }, …… })</code></pre> <p>自定义组件圆形进度条到此已经完成。</p> <h3><span style="color: #605eac;">使用自定义组件</span></h3> <p>下面我们在 index 中使用自定义组件圆形进度条。</p> <p><strong>一、<code>json</code> 文件中进行引用声明</strong></p> <p>使用已注册的自定义组件前,<strong>首先要在页面的 json 文件中进行引用声明。</strong>此时需要提供每个自定义组件的标签名和对应的自定义组件文件路径:</p> <pre><code>{ "usingComponents": { "circle": "/components/circle/circle" } }</code></pre> <p><strong>二、<code>wxml</code> 文件中使用自定义组件</strong></p> <p>这样,在页面的 wxml 中就可以像使用基础组件一样使用自定义组件。节点名即自定义组件的标签名,节点属性即传递给组件的属性值。</p> <ul> <li>节点名即自定义组件的标签名:circle;</li> <li>节点属性即传递给组件的属性值:bg,draw;</li> <li>当自定义组件触发 runEvent 事件时,调用_runEvent 方法。</li> </ul> <pre><code>&lt;!--index.wxml--&gt; &lt;view class="container"&gt; &lt;circle id='circle1' bg='circle_bg1' draw='circle_draw1' bind:runEvent="_runEvent" &gt; &lt;!-- 这部分内容将被放置在组件 &lt;slot&gt; 的位置上 --&gt; &lt;view class="circle_info" bindtap="changeTime"&gt; &lt;view class="circle_dot"&gt;&lt;/view&gt; &lt;text class='circle_txt'&gt; {{txt}} &lt;/text&gt; &lt;/view&gt; &lt;/circle&gt; &lt;/view&gt;</code></pre> <p>自定义组件的 <code>wxml</code> 节点结构在与数据结合之后,将被插入到引用位置内。在 <code>wxss</code> 给 <code>slot</code> 位置上的内容添加一些样式。</p> <pre><code>/**index.wxss**/ /*圆环进度条文字*/ .circle_info{ position: absolute; width: 100%; left: 50%; top: 50%; transform: translate(-50%,-50%); display: flex; align-items: center; justify-content: center } .circle_dot{ width:16rpx; height: 16rpx; border-radius: 50%; background-color: #fb9126; } .circle_txt{ padding-left: 10rpx; color: #fff; font-size: 36rpx; letter-spacing: 2rpx; }</code></pre> <p><strong>三、<code>js</code> 文件中调用自定义组件中的方法</strong></p> <p>在 <code>wxml</code> 中我们用到一个数据 <code>{{txt}}</code>,我们需要在 <code>js</code> 中设置一下 <code>data</code>,然后在 <code>onReady</code> 中使用 <code>selectComponent</code> 选择组件实例节点。</p> <pre><code>//index.js data: { txt: "正在匹配中..." }, onReady: function () { // 获得circle组件 this.circle = this.selectComponent("#circle1"); // 绘制背景圆环 this.circle.drawCircleBg('circle_bg1', 100, 8) // 绘制彩色圆环 this.circle.drawCircle('circle_draw1', 100, 8, 2); },</code></pre> <p>效果如下:<br /> <code>this.circle.drawCircle('circle_draw1', 100, 8, 0.5);</code><br /> <img class="aligncenter size-full wp-image-987743" src="https://images.ifanr.cn/wp-content/uploads/2018/02/3-4.png" alt="" width="234" height="230" /></p> <p><code>this.circle.drawCircle('circle_draw1', 100, 8, 1);</code><br /> <img class="aligncenter size-full wp-image-987742" src="https://images.ifanr.cn/wp-content/uploads/2018/02/2-5.png" alt="" width="229" height="223" /></p> <p><code>this.circle.drawCircle('circle_draw1', 100, 8, 2);</code><br /> <img class="aligncenter size-full wp-image-987744" src="https://images.ifanr.cn/wp-content/uploads/2018/02/4-4.png" alt="" width="237" height="224" /></p> <p>接下来要写定时器方法了,在定时器中每隔一段时间调用一次 <code>this.circle.drawCircle(id, x, w, step)</code>,通过改变 <code>step</code> 的值来动态绘制圆环。</p> <ol> <li>在 <code>data</code> 中设置几个初始值</li> <li>定义一个定时器方法 <code>countInterval</code>,假设每隔 100 毫秒 <code>count</code> 递增<br /> +1,当 <code>count</code> 递增到 100 的时候刚好是一个圆环,然后改变 <code>txt</code> 值并且清除定时器</li> <li>在 <code>onReady</code> 中调用这个定时器方法</li> </ol> <pre><code> data: { txt: "正在匹配中...", count: 0,//计数器,初始值为0 maxCount: 100, // 绘制一个圆环所需的步骤 countTimer: null,//定时器,初始值为null }, countInterval: function () { // 设置倒计时 定时器 假设每隔100毫秒 count递增+1,当 count递增到两倍maxCount的时候刚好是一个圆环( step 从0到2为一周),然后改变txt值并且清除定时器 this.countTimer = setInterval(() =&gt; { if (this.data.count &lt;= 2 * this.data.maxCount) { // 绘制彩色圆环进度条 this.circle.drawCircle('circle_draw1', 100, 8, this.data.count / this.data.maxCount) this.data.count++; } else { this.setData({ txt: "匹配成功" }); clearInterval(this.countTimer); } }, 100) }, onReady: function () { // 获得circle组件 this.circle = this.selectComponent("#circle1"); // 绘制背景圆环 this.circle.drawCircleBg('circle_bg1', 100, 8) // 绘制彩色圆环 // this.circle.drawCircle('circle_draw1', 100, 8, 2); this.countInterval() },</code></pre> <h3><span style="color: #605eac;">最终效果</span></h3> <p><img class="aligncenter size-full wp-image-987745" src="https://images.ifanr.cn/wp-content/uploads/2018/02/3241946026-5a7c34c8edb30_articlex.gif" alt="" width="242" height="250" /></p> <hr /> <h3><span style="color: #605eac;">再次使用自定义组件做倒计时</span></h3> <p><code>count</code> 可以递增,当然可以递减。这里就不在赘述,直接上代码:<br /> <code>wxml</code></p> <pre><code>&lt;circle id='circle' bg='circle_bg' draw='circle_draw' bind:runEvent="_runEvent" &gt; &lt;view class="circle_text" bindtap="changeTime"&gt; &lt;text class='circle_time'&gt; {{time}} s&lt;/text&gt;&lt;/view&gt; &lt;/circle&gt;</code></pre> <p><code>wxss</code></p> <pre><code>/*圆环倒计时*/ .circle_text{ position: absolute; left: 50%; top: 50%; transform: translate(-50%,-50%); } .circle_time{ color: #fff; font-size: 32rpx; padding-left: 16rpx; }</code></pre> <p><code>js</code></p> <pre><code>const app = getApp() Page({ …… stepInterval: function () { var n = this.data.num / 2 // 设置倒计时 定时器 this.stepTimer = setInterval(() =&gt; { if (this.data.num &gt;= 0) { this.data.step = this.data.num / n; this.circle.drawCircle('circle_draw', 40, 4, this.data.step)// 绘制彩色圆环进度条 if ((/(^[1-9]\d*$)/.test(this.data.num / 10))) { this.setData({ // 当时间为整数秒的时候 改变时间 time: this.data.num / 10 }); } this.data.num--; } else { this.setData({ time: 0 }); } }, 100) }, changeTime: function () { clearInterval(this.stepTimer); this.setData({ num: 100 }); this.stepInterval() // 重新开启倒计时 this._runEvent() // 触发自定义组件事件 }, …… })</code></pre> <h3><span style="color: #605eac;">最终效果</span></h3> <p><img class="aligncenter size-full wp-image-987746" src="https://images.ifanr.cn/wp-content/uploads/2018/02/853229202-5a7da2a190587_articlex.gif" alt="" width="262" height="285" /></p> <p><strong>关注「<span style="color: #605eac;">知晓程序</span>」微信公众号,回复「<span style="color: #605eac;">开发</span>」,让你的小程序性能再上一层楼。</strong></p> <p><strong><img class="aligncenter size-full wp-image-932929" src="https://images.ifanr.cn/wp-content/uploads/2017/11/20171101173458.jpg" alt="" width="1000" height="200" srcset="http://www.ifanr.com/wp-content/uploads/2017/11/20171101173458.jpg 1000w, http://www.ifanr.com/wp-content/uploads/2017/11/20171101173458-360x72.jpg 360w, http://www.ifanr.com/wp-content/uploads/2017/11/20171101173458-768x154.jpg 768w" sizes="(max-width: 1000px) 100vw, 1000px" /></strong></p> <p><img class="size-full wp-image-963729 aligncenter" src="https://images.ifanr.cn/wp-content/uploads/2018/01/qrcode.gif" alt="" width="750" height="375" srcset="http://www.ifanr.com/wp-content/uploads/2018/01/qrcode.gif 750w, http://www.ifanr.com/wp-content/uploads/2018/01/qrcode-360x180.gif 360w" sizes="(max-width: 750px) 100vw, 750px" /></p>