“下拉刷新”和“上滑加载更多”功能在前端、尤其是移动端项目中非常重要,这里笔者由曾经做过的vue项目中的“blink”功能和各位探讨下【下拉刷新】组件的开发:

JavaScript正式开篇

在前端项目的 components 文件夹下新建 pullRefreshView 文件夹,在其中新建组件 index.vue:(它代表“整个屏幕”,通过slot插入页面其他内容而不是传统的设置遮罩层触发下拉刷新)

首先需要编写下拉刷新组件的 template,这里用到 <slot>,代码如下:

 1<template>
 2    <div class="pullRefreshView" @touchmove="touchmove" @touchstart="touchstart" @touchend="touchend">
 3        <div ref="circleIcon" class="circle-icon">
 4            <div ref="circleIconInner" class="circle-icon-inner"></div>
 5        </div>
 6        <slot></slot>
 7    </div>
 8</template>

上面代码中,最外层使用了一个 div 用来包裹,作为事件绑定的容器,同时新建一个圆形 icon 的 div .circleIcon,我们将此 icon 样式设置在屏幕外,达到隐藏的效果,代码如下:

 1<style>
 2    .circle-icon{
 3        position: absolute;
 4        left: 0.625rem;
 5        top: -1.875rem;
 6    }
 7    .circle-icon-inner{
 8        width: 1.5625rem;
 9        height: 1.5625rem;
10        background-image: url('圆圈图片地址');
11        background-size: cover;
12    }
13    .circle-rotate{
14        animation: xuzhuan .8s linear infinite;
15    }
16    @keyframes xuzhuan{
17        0%{}
18        25%{}
19        50%{}
20        75%{}
21        100%{}
22    }
23</style>

下拉刷新组件的 UI 基本编写完毕,接下来就要绑定事件了,通过上述分析,加上我们之前章节开发图片查看器的原理,我们需要用到移动端 touchstart,touchmove,touchend 事件,可以实现下拉刷新效果。

首先,监听 touchstart 事件:

 1touchstart(evt){
 2    this.pullRefresh.dragStart=evt.targetTouches[0].clientY
 3    this.$refs.circleIcon.style.webkitTransition='none'
 4},

在 touchstart 事件中,我们主要做的是记录一些初始值,包括手指第一次接触屏幕时的位置,然后将圆形 icon 的动画效果先隐藏。

然后,监听 touchmove 事件:

 1touchmove(evt){
 2    if(this.pullRefresh.dragStart===null){
 3        return
 4    }
 5    let target=evt.targetTouches[0]
 6    // 向上滑为正,向下拉为负
 7    this.pullRefresh.percentage=(this.pullRefresh.dragStart-target.clientY)/window.screen.height
 8    let scrollTop=document.documentElement.scrollTop || document.body.scrollTop
 9    if(scrollTop===0){
10        //this.pullRefresh指data中的pullRefresh对象(下方有),而evt即事件event参数
11        if(this.pullRefresh.percentage<0 && evt.cancelable){
12            evt.preventDefault()
13            this.pullRefresh.joinRefreshFlag=true
14            let translateY=-this.pullRefresh.percentage*this.pullRefresh.moveCount
15            if(Math.abs(this.pullRefresh.percentage)<=this.pullRefresh.dragThreshold){
16                let rotate=translateY/30*360
17                this.$refs.circleIcon.style.webkitTransform='translate3d(0'+translateY+'px,0) rotate('+rotate+'deg)'
18            }
19        }else{
20            if(this.pullRefresh.joinRefreshFlag===null){
21                this.pullRefresh.joinRefreshFlag=false
22            }
23        }
24    }else{
25        if(this.pullRefresh.joinRefreshFlag===null){
26            this.pullRefresh.joinRefreshFlag=false
27        }
28    }
29},

在 touchmove 事件里,我们主要做的是根据手指移动的量来实时将圆形 icon 移动并旋转,这里有几点确实要说明一下:

  • 我们的下拉刷新触发的时机是在页面处于屏幕顶部并且手指向下拖动,这两个条件,缺一不可,在代码中,我们利用 scrollTop == 0this.pullRefresh.percentage < 0 来判断。
  • 在进入下拉刷新状态时,此时手指不断向下拖动,首先圆形 icon.circleIcon 会向下滚动并旋转,当滚动到临界值时就只原地旋转。
  • 如果手指在向上拖动,圆形 icon.circleIcon 就会向上滚动并旋转。
  • 直到手指离开屏幕前,都不会触发下拉刷新,只是圆形 icon.circleIcon 在不停的上下移动。

监听 touchend 事件:

 1touchend(evt){
 2    if(this.pullRefresh.percentage===0){
 3        return
 4    }
 5    if(Math.abs(this.pullRefresh.percentage)>this.pullRefresh.dragThreshold && this.pullRefresh.joinRefreshFlag){
 6        this.$emit('onRefresh')
 7        this.$refs.circleIconInner.classList.add('circle-rotate')
 8        setTimeout(()=>{
 9            this.$refs.circleIconInner.classList.remove('circle-rotate')
10            this.$refs.circleIcon.style.webkitTransition='330ms'
11            this.$refs.circleIcon.style.webkitTransform='translate3d(0,0,0) rotate(0deg)'
12        },700)
13    }else{
14        if(this.pullRefresh.joinRefreshFlag){
15            this.$refs.circleIcon.style.webkitTransition='330ms'
16            this.$refs.circleIcon.style.webkitTransform='translate3d(0,0,0) rotate(0deg)'
17        }
18    }
19    this.pullRefresh.joinRefreshFlag=null
20    this.pullRefresh.dragStart=null
21    this.pullRefresh.percentage=0
22}

在 touchend 事件中,我们主要是做一些动画执行的操作,大家可以看看代码中的注释,这里说明一下:

  1. 此时手指离开屏幕,位移量达到临界值时,并且也有进入下拉刷新的标志位,就表明要触发正在刷新。此时圆形 icon原地旋转,并触发下拉刷新回调方法,延迟 700ms 后向上收起。
  2. 我们在实现圆形 icon 时的旋转和位移动画时,用了两个 div,在 touchmove 时,我们主要对外层的 div 也就是 ref=circleIcon,来实现位移和旋转。
  3. 在 touchend 时,我们主要给内层的 div 也就是 ref=circleIconInner 来加 animation 动画,因为无法给一个 div 同时使用位移旋转和 animation 动画,所以这里一个技巧就是给父元素设置位移和旋转,它的子元素在不设置任何 CSS 动画样式时,是会随着父元素而生效的。

最后,我们看下【data】中都有什么:

 1data(){
 2    return{
 3        pullRefresh:{
 4            dragStart:null,   //开始抓取标志位
 5            percentage:0,   //拖动量(百分比)
 6            dragThreshold:0.3,   //临界值
 7            moveCount:200,   //位移系数,可以调节圆形图片icon的运动速率
 8            joinRefreshFlag:null,   //进入刷新状态的标志位(true)
 9        }
10    }
11},

补充:slot

<template>中为什么有<slot>

slot有三种形式:

  1. 普通插槽
  2. 具名插槽
  3. 作用域插槽

可能我们一般用具名slot的时候比较多,但是第一种也格外好用——正因为它没有名字,所以引用这个组件的另一个组件中包裹其中的所有内容都归这个slot所有:

假定my-component组件中有如下模板:

 1<div>
 2    <h2>我是子组件</h2>
 3    <slot>只有在没有内容分发的情况下这句话才会出现</slot>
 4</div>

父组件模板:

 1<div>
 2    <h1>这是父组件地盘</h1>
 3    <my-component>
 4        <p>这是一些初始内容</p>
 5        <p>这是更多的内容</p>
 6    </my-component>
 7</div>

最后就会被渲染成这样:

 1<div> 
 2    <h1>这是父组件地盘</h1>
 3    <div> 
 4        <h2>我是子组件</h2>
 5        <p>这是一些初始内容</p>
 6        <p>这是更多的内容</p>
 7    </div> 
 8</div>

所以这里这样做,就是为了在“父组件”中调用时让“下拉的动画”更自然,但又不会增加一个文件的负担。

个人笔记记录 2021 ~ 2025