码迷,mamicode.com
首页 > 其他好文 > 详细

手把手教你实现一个 Vue 进度条组件!

时间:2018-11-16 11:41:57      阅读:192      评论:0      收藏:0      [点我收藏+]

标签:xxx   图片   nbsp   消失   ati   开始   Fix   时间   特效   

技术分享图片

最近在个人的项目中,想对页面之间跳转的过程进行优化,想到了很多文档或 npm 等都用到的页面跳转进度条,于是便想自己去实现一个,特此记录。

来看下 npm 搜索组件时候的效果:

技术分享图片

so 下面咱们一起动手实现一下呗。

 定义使用方式 

想实现一个组件的前提,一定要想好你的需求是什么,还要自己去定义一个舒服的使用方法,这其中也是有原则的,对使用者来说,使用方式越简单越好。那么对应的代价就是写这个组件的复杂度会变高。

我想要的使用方式是这样的:可以在任意的地方去调用到这个方法,可以随时控制其状态。

 看下对应的代码:

    async someFunction () {

        this.$progress.start()

        try {

              const ret = await axios.get(‘/xxx‘)

              // some code ...

          this.$progress.finish()

        } catch (err) {

              // cache err ...

              this.$progress.fail()

        }

    }

当然,想在任意地方使用,少不了一个步骤,就是在全局注册这个组件:

 

    import progressBar from ‘xxx/progress-bar‘

    

    Vue.use(progressBar, { // some config ... })

如果不想全局注册,你也可以在某个组件内单独使用,只要你开心就好。

实现过程 

先来建立一个文件夹和其中两个文件:

    progress-bar

        - 01 progress-bar.vue

        - 02 index.js

打开progress-bar.vue,先来写结构和样式,这里很简单:

 

 

    <template>

          <div :style=‘style‘></div>

    </template>

    

    <style scoped>

          .bar {

            position: fixed;

            z-index: 99999;

            opacity: 1;

          }

    </style>

在注册组件的时候,我想可以自定义一些功能,比如

  • 成功的颜色

  • 失败的颜色

  • 进度条的位置

  • 动画过渡时间

  • 加载方向

  • 高度

  • 是否可以自动完成

当然只要你想到的都可以添加,那么这些可以定制的属性,自然而然就成为了组件的 props:

 

技术分享图片技术分享图片

export default {

      name: ‘progressBar‘,

      props: {

        options: {

          type: Object,

          default () {

            return {

              succColor: ‘rgb(76, 164, 214)‘,

              failColor: ‘rgb(218, 26, 101)‘,

              position: ‘top‘,

              transition: {

                widthSpeed: 200,

                opacitySpeed: 400,

                duration: 300  // 定义消失时间 ms

              },

              inverse: false,  // 进度条的加载方向

              thickness: 2  // 进度条的高度

            }

          }

        }

      }

}

</script>

除了要定义的属性以外,那么组件本身总要有一些自己的属性,用来控制自己的状态,比如这个组件,你要控制进度条的长度、显示和隐藏等状态。

添加 vue 的 data 属性:

 

    data () {

          return {

          percent: 0,  // 进度条长度

                show: false, // 显示和隐藏

                canSuccess: true  // 是否是成功的状态

          }

    }

有了这些属性,这个进度条就要根据这些属性的变化来“自己动”。所以这个时候首先想到的当然就是 Vue 的计算属性:

 

 

computed: {

  style () {

    // 先拿到乱七八糟的属性

    const { succColor, failColor, location, transition, inverse, thickness } = this.options

    const { widthSpeed, opacitySpeed } = transition

    const { canSuccess, preset, show } = this

    

 // 定义 css 样式

    const style = {

      backgroundColor: canSuccess ? succColor : failColor,

      opacity: show ? 1 : 0

    }

 

    if (position !== ‘top‘ || position !== ‘bottom‘) {

      throw new Error(‘The wrong config of position!‘)

    }

 

    style[position] = 0

 

    if (inverse) {

      style.left = 0

    } else {

      style.right = 0

    }

 

    style.width = preset + ‘%‘  // 设置进度条长度

    style.height = thickness + ‘px‘  // 设置显示高度

    style.transition = `width ${widthSpeed}ms, opacity ${opacitySpeed}ms`  // 设置过度样式

 

    return style

  }

}

到这里这个 vue 组件其实就完成了,接下来就是如何去控制它。打开index.js,先来写一个标准的组件格式:

 

 

    import progressBar from ‘./progress-bar.vue‘

    

    export default {

      install (Vue, options = {}) {

      // 注册组件

        Vue.component(progressBar.name, progressBar)

      }

    }

之后咱们要用到 Vue 提供的扩展方法,来完成咱们的需求。

第一步,添加 autoFinish 属性,用来设定动画是否可以自动完成,默认是 true,当然如果某个路由或请求一直处于 pending 状态,你可以可以设置让其永远不完成动画的动作。

 

第二步,来写一个对象,其中包含 start 、 finish 、 fail 方法以及动画代码。

 

第三步,将这个对象挂在到 Vue 的原型

 

 完整的代码和说明如下:

import progressBar from ‘./progress-bar.vue‘

 

export default {

  install (Vue, options = {}) {

    // 注册组件

    Vue.component(progressBar.name, progressBar)

 

    // 创建一个 Vue 子类

    const Component = Vue.extend(progressBar)

    // 拿到自定义的属性

    const { autoFinish, ...res } = options

    // 创建组件实例

    const vm = new Component({

      data: {

        autoFinish: typeof autoFinish === ‘boolean‘ ? autoFinish : true

      }

    })

    // 将 progressBar 的默认 options 与 自定义的 options 合并

    options = Object.assign(vm.$props.options, { ...res })

 

    //合并新的 props

    vm.$propsData = options

    vm.$mount()

 

    // 如果是服务端渲染那么不继续执行

    if (!vm.$isServer) {

      document.body.appendChild(vm.$el)

    }

 

    let timer = null

 

    const progress = {

      start () {

        if (Vue.$isServer) return

 

        // 每次调用 start 都重新初始化一次,比如多次点击某个按钮连续请求,那么每次都从0开始

        vm.percent = 0

        vm.show = true

        vm.canSuccess = true

 

        // 定一个增量,这个值可以改成参数,也可以按照使用经验来设定

        const CUT_SCALE = 5

 

        // 定义每 100 秒来执行一次动画

        timer = setInterval(() => {

          // 每次执行增量动画

          this.increase((CUT_SCALE - 1) * Math.random() + 1)

          // 如果进度大于 95%,并且设置了自动完成,那么执行结束动作

          if (vm.percent > 95 && vm.autoFinish) {

            this.finish()

          }

        }, 100)

      },

 

      increase (cut) {

        vm.percent = Math.min(99, vm.percent + cut)

      },

 

      hide () {

        clearInterval(timer)

        // 这里面有2个定时器,外层定时器是让用户可以看到这个 进度已经完成啦

        // 内层定时器,由于 opacity 消失需要一定的过渡时间,所以要等待它消失以后

        // 在将其进度设置为0,等待下次调用,如果不延迟,那么会看到进度到100后又回到0的动画

        setTimeout(() => {

          vm.show = false

          setTimeout(() => {

            vm.percent = 0

            timer = null

          }, vm.options.transition.opacitySpeed)

        }, vm.options.transition.duration)

      },

 

      // 下面这2个方法就很简单了,只需要完成进度,然后执行隐藏即可

      finish () {

        if (Vue.$isServer) return

        vm.percent = 100

        this.hide()

      },

 

      fail () {

        if (Vue.$isServer) return

        // 修改未成功的状态,实际效果就是改变最后的颜色

        vm.canSuccess = false

        vm.percent = 100

        this.hide()

      }

    }

 

    // 最后挂在到全局

    Vue.prototype.$progress = progress

  }

}

 

到这里,一个进度条组件就完成了。大家可以自己动手实践一下,起一个项目,使用 vue-router 的 beforeResolve 声明周期钩子,或者写一个定时器模拟异步来测试一下。

以上是笔者归纳总结,如有误之处,欢迎指出。

 

往期文章推荐:

 

觉得本文对你有帮助?请分享给更多人

关注【妙味前端】加星标,关注更多内容

 

订阅号ID:Miaovclass

 

关注妙味订阅号:“妙味前端”,为您带来优质前端技术干货;

手把手教你实现一个 Vue 进度条组件!

标签:xxx   图片   nbsp   消失   ati   开始   Fix   时间   特效   

原文地址:https://www.cnblogs.com/Highdoudou/p/9968249.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!