Vue实现下拉刷新组件(简单明了)

时间:2024-12-19 20:14:08

笔者在写这篇文章时,刚刚完成了下拉组件的封装,还热乎着。迫不及待的想分享给大家。在这之前,如果你跟我一样带着些迷惑和好奇,想要自己动手完成一些框架中的组件并了解其原理。希望这篇文章可以帮到你。

一、首先分析一下,他的核心是什么,你或许应该想到了,那就是下拉到一定位置后,手指离开屏幕就触发一个函数,听起来不难,但过程中我还是遇到了一些逻辑的问题,逻辑搞懂了,so easy,我就直接上代码了

<template>
  <div
    class="weui-pull-refresh"
    ref="scrollBox"
    :style="style"
    @touchstart="touchStart"
    @touchmove="touchMove"
    @touchend="touchEnd">
    <div class="weui-pull-refreshing-box">
      <div v-if="moveState < 2">{{ moveState === 0 ? '下拉即可刷新...' : '释放即可刷新...' }}</div>
      <div v-else><i class="weui-loading"/> 加载中...</div>
    </div>
    <div class="weui-pull-present-box">
      <slot/>
    </div>
  </div>
</template>

<script>
//如果你想直接拿来用,把create干掉
import { create } from '../../utils'
//create()干掉
export default create({
  name: 'pull-refresh',
  data () {
    return {
      startY: '',    //保存touch时的Y坐标
      moveDistance: 0,    //保存向下滑动的距离
      moveState: 0,        //开始滑动到结束后状态的变化 0:下拉即可刷新 1:释放即可刷新 2:加载中
      duration: 0        //动画持续时间,0就是没有动画
    }
  },
  computed: {
    style () {
      return {
        transition: `${}ms`,
        transform: `translate3d(0,${}px, 0)`
      }
    }
  },
  methods: {
    touchStart (e) {
       = 0 // 关闭动画
       = 0 // 滑动距离归0
       = [0].clientY  // 获得开始Y坐标
    },
    touchMove (e) {    //这里是整个下拉刷新的核心
      let scrollTop =  || 
        //首先判断我们有没有滚动条,如果有,我们下拉刷新就不能启用。
      if (scrollTop > 0) return

      let move = [0].clientY - 
        //判断手指滑动的距离,只有为正数才代表用户下拉了。
      if (move > 0) {
        //阻止默认事件,在微信浏览器中尤为有用,至于为什么,你去试就知道了。
        ()
        //增加滑动阻力的感觉
         = (move, 0.8)
        if ( > 50) {
        //如果滑动距离大于50 那我就告诉你,释放即可刷新
          if ( === 1) return
           = 1
        } else {
        //否则 恢复原样
          if ( === 0) return
           = 0
        }
      }
    },
    touchEnd (e) {
      // 只要手指拿开,我都需要加上结束时的动画,这里为300ms
       = 300
      if ( > 50) {
        //这里逻辑跟touchMove一样,但是需要真的加载数据了,那moveState变为2 所以加载动画在这出现
         = 2
        //因为还没加载完,我得让加载动画显示着,所以这里移动距离为50
         = 50
        this.$emit('refresh', () => {
            //这里就是成功后的回调了,如果该函数被调用,那就以为着加载数据完成,所以状态要回到0,当然需要在父组件调用。
           = 0
        })
      } else {
        //否则 给我老老实实恢复原样
         = 0
      }
    }
  },
  watch: {
    //这里是给用户操作返回的核心
    moveState (state) {
      //我们监听moveState的状态,
      //0意味着开始也意味着结束,这里是结束,并且只有动画生效我们才能 moveDistance 设为0,
      //为什么动画生效才行,因为动画生效意味着手指离开了屏幕,如果不懂去看touchEnd方法,这时
      //我们让距离变为0才会有动画效果。
      if (state === 0 &&  === 300) {
         = 0
      }
    }
  }
})
</script>
<!-- css我就不讲了,你肯定比我厉害 -->
<style scoped lang="scss">
  .weui-pull-refresh {
      display: flex;
      height: calc(100vh - 50px);
      flex-direction: column;
      margin-top: -50px;
      .weui-pull-refreshing-box {
          line-height: 50px;
          height: 50px;
          font-size: 14px;
          color: rgba(69,90,100,.6);
          text-align: center;
          margin-bottom:20px;
      }
      .weui-pull-present-box {
          background-color: lighten(#fff, 10%);
      }
  }
</style>

二、调用:

<template>
  <wv-pull-refresh @refresh="refresh">
    <div class="content">
      <p class="text">基础用法</p>
      刷新次数:{{ num }}
    </div>
  </wv-pull-refresh>
</template>

<script>
export default {
  data () {
    return {
      num: 0
    }
  },
  methods: {
    refresh (done) {
      setTimeout(() => {
        ++
        done()    //我就想说这里,把状态归0
      }, 500)
    }
  }
}
</script>

<style scoped lang="scss">
.content{
  padding:0 15px;
  .text{
    font-size: 14px;
    color: rgba(69,90,100,.6);
  }
}
</style>

这就完成了,如果你用的过程中出现BUG,欢迎留言。若有好的建议,欢迎来探讨。