小程序wxs实现一个好用的下拉刷新

使用wxs实现一个好用的下拉刷新

啥都不说,先上一张效果图:

image

可能有点糊但是因为图床关系,文件不能超过1m,所以各位将就一下就好。

下面开始介绍如何使用wxs来实现一个自定义的下拉刷新。

前言

要想实现wxs的下拉刷新,首先我们需要为什么我们需要这么做,为啥需要wxs呢? 这个东西究竟有啥用呢? 所以在开始之前,我们就先来简单介绍一下wxs是什么。

wxs

wxs的出现,根据官方文档中的描述,是为了处理2个页面之间的频繁交互,导致事件不停的传递从而出现的性能影响问题。

举个例子: 现在有A页面和B页面,A页面touchmove手势会伴随着B页面也跟着移动,所以一次touchmove的响应过程是:

  1. touchemove事件从视图层 传递到 逻辑层
  2. 逻辑层处理了touchmove的行为后 再通过 setData 来改变B的位置(即又从逻辑层传递到了视图层)

一次 touchmove 的响应需要经过 2 次的逻辑层和渲染层的通信以及一次渲染,通信的耗时比较大。此外 setData 渲染也会阻塞其它脚本执行,导致了整个用户交互的动画过程会有延迟

而wxs就是为了减少页面间的通讯,让事件再视图层响应。在这里又需要引申出一点,就是小程序的框架结构。

image

而我们使用wxs的目的就是为了让代码直接运行才视图层中,如下图:

image

开始实现

讲完了上面的基础知识,现在开始编写代码来实现我们想要的效果

  1. 首先,我们需要在components文件中新建一个wxs文件。结构目录如下:
image

然后我们首先来编写components中的逻辑代码

    //components  dropdown.wxml 
    <scroll-view 
    style="height:400px"
    scroll-y="{{true}}"
    bind:touchstart="{{scroll.touchStart}}"
    bind:touchmove="{{scroll.touchmove}}"
    bind:touchend="{{scroll.touchend}}"
    >
    
    <view class="container" change:prop="{{scroll.completeRefresh}}" prop="{{isCompleteRefresh}}">
        <view class="dropdown">
            <view class="loading-icon" ></view>
        </view>
    </view>
    <slot></slot> 
    </scroll-view>

我们先来分析一下上面的代码:

  1. 首先我们在最外层用一个scrollView标签包裹,是为了能够使用对应的事件,这里需要主要,scroll-view必须要规定好高度,我这里为了方便测试,所以写死,真实开发的时候可以把他作为一个参数传进来。

  2. 这一点比较核心,我们可以看到我们使用了 change:propprop 这两个属性。这里的意思其实就是每当prop(也就是组件接收到新得传参的时候),就会触发change:prop绑定的对应的方法。我们这里绑定的是wxs中的方法。

  3. slot 就是我们用来存放你的正常页面内容的地方。

我们接着来编写最关键wxs部分

    // components dropdown.wxs
    var touchStartPosition = 0; // 开始的位置
    var touchMoveDistance = 0;  // 下拉的距离
    var touchMoveMaxDistance = 0; //下拉的最大距离(阈值)

    var isLoading = false;  // 当前是否处于下拉刷新状态 (锁)

    var touchStart = function (event, ownerInstance) {
        if(isLoading){
            return false
        }
        // 设置手指刚点下去的位置的值
        touchStartPosition = event.touches[0].clientY
        touchMoveDistance  = 0
    }

    var touchMove = function(event, ownerInstance) {
        // 记录下拉的距离
        touchMoveDistance = event.touches[0].clientY - touchStartPosition
        
        // 此时手指是向上移动,直接拦截
        if(touchMoveDistance <= 0){
            return false
        }
        // 正在刷新也退出
        if(isLoading) {
            return false
        }
        // 达到指定要求的阈值
        if(touchMoveDistance >= (touchMoveMaxDistance * 1.4)) {
            // 改变指定对象的样式
            ownerInstance.selectComponent('.dropdown').setStyle({
                // *1.4 是为了让下拉可以跟着手指移动超出阈值要求的部分,让效果看起来有弹性
                top: touchMoveMaxDistance * 1.4 + 'px'
            })
        } else {
                // 如果没有超出极限距离,则直接移动到指定阈值的位置
            ownerInstance.selectComponent('.dropdown').setStyle({
                top: touchMoveDistance + 'px'
            })
        }
        return false
    }

    var touchEnd = function (event, ownerInstance) {
        if(isLoading) {
            return false
        }
        // 如果往下滑结束行为
        if(touchMoveDistance <= 0){
            return false
        }
        // 下拉距离并没到达阈值
        if(touchMoveDistance < touchMoveMacDistance ) {
            ownerInstance.selectComponent('.dropdown').setStyle({
                transition: 'all .8s',
                top: '0px'
            })
        } else {
            // 开始刷新
            isLoading = true
            ownerInstance.selectComponent('.dropdown').setStyle({
                transition: 'all .8s',
                top: touchMoveMaxDistance + 'px'
            })
            // 调用外部组件的方法(即执行相应的下拉刷新操作)
            ownerInstance.callMethod('dropLoading')
        }
        // 重置
        touchStartPosition = 0
    }

    var completeRefresh = function(newValue, oldValue, ownerInstance) {
        // 执行完相应的下拉刷新操作之后,会被调用并且重置样式。
        ownerInstance.selectComponent('.dropdown').setStyle({
            transition: 'all .8s',
            top: '0px'
        })
        initFunction()
    }

    var initFunction = function () {  // 重置函数
        touchStartPosition = 0;
        touchMoveDistance = 0;
        touchMoveMaxDistance = 80;
        isLoading = false
        isRefreshLower = false
    }

    module.exports = {
        touchStart: touchStart,
        touchMove: touchMove,
        touchEnd: touchEnd,
        completeRefresh: completeRefresh,
    }

小结
上面的代码有点多,但是其实注释已经写得十分清晰了。其实需要处理得流程就是分为三步:

  1. 手指刚触碰屏幕得时候

这个时候需要记录手指的初始位置,以便后面的操作进行

  1. 手指在屏幕移动得时候

此处逻辑最多,主要是根据前面拿到的位置判断对比,主要是动画的执行(橡皮筋动画)

  1. 手指离开屏幕的时候

最终手指离开的位置,是否达到阈值,调用外部方法,并且执行相应得动画

上面讲完了主要得逻辑代码之后,下面的内容就比较容易了,主要围绕着如何使用来展开,咱们继续

我们的components 还差最后一步就完成了,那就是编写jswxss。我们还是贴上代码,并且在注释中对代码进行解析

    // 设置传参的值,这个值也是wxml 中 change:prop 监听的值
    properties: {
        // 完成下拉刷新
        isCompleteRefresh:{
        type:Boolean,
        },
    },
    //.... data
    method:{
        // 这里的dropLoading 就是 wxs 中 callMethod 调用的方法
        dropLoading(){
            // 暴露一个接口,让外面请求
            this.triggerEvent('dropLoading')
        },
    }
    /* components dropdown.wxss */
    /* 这里没啥好讲的,直接上代码就好了 */
    .container {
        width: 100%;
        z-index: 9999;
        transition-timing-function: ease;
    }
    .dropdown {
        position: absolute;
        top: 0px;
        width: 100%;
        height: 80px;
        display: flex;
        align-items: center;
        justify-content: center;
        transform-origin: top center;
        background: transparent;
        transform: translateY(-100%) ;
    }
    .loading-icon{
        width: 20px;
        height: 20px;
        border: 3px solid;
        border-color: #f59a23 #f59a23 #f59a23 transparent;
        border-radius: 100%;
        animation: scale 1s linear infinite;
    }
    @keyframes scale {
        100%{
            transform: rotate(360deg);
        }
    }

以上就完成了components组件部分的开发,下面我就到index中进行使用了。马上就要完成!

  1. 首先我们需要在json文件中注册组件,这里就不贴代码了,你们应该能明白

  2. 然后我们在wxml文件中调用组件

    <view class="container">
        <view class="header" style="height:100px;"></view>
        <dropdown
        bind:dropLoading="dropdownRefresh" 
        isCompleteRefresh="{{isCompleteRefresh}}">
            <view class="content">
            // 页面内容 slot中插入
            </view>
        </dropdown>
    </view>

最后再在js中配置对应需要调用的方法

    dropdownRefresh(){
        console.log('下拉刷新中....')
        setTimeout(res=>{
            // 放你的逻辑代码
        console.log('刷新完成了..')
            this.setData({
                isCompleteRefresh:true
            })
        },3000)
        
    }

这样就大功告成了!

以上就是利用wxs实现自定义的下拉刷新的全部流程。感谢您的阅读,如有说得不好的地方还请您多多包涵

以上

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 230,501评论 6 544
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 99,673评论 3 429
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 178,610评论 0 383
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 63,939评论 1 318
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 72,668评论 6 412
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 56,004评论 1 329
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 44,001评论 3 449
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 43,173评论 0 290
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 49,705评论 1 336
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 41,426评论 3 359
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 43,656评论 1 374
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 39,139评论 5 364
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 44,833评论 3 350
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 35,247评论 0 28
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 36,580评论 1 295
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 52,371评论 3 400
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 48,621评论 2 380

推荐阅读更多精彩内容

  • 前言最近一段时间在研究微信小程序的开发,相比于原生app来说,确实上手要容易不少,也能够提升项目的开发速度。但与此...
    飘逸解构阅读 2,204评论 3 2
  • 标签(空格分隔): 小程序 小程序的一套脚本语言,结合 WXML,可以构建出页面的结构 WXS 的运行环境和其他 ...
    鱼竿23333阅读 974评论 0 1
  • 在小程序中实现左滑删除(侧滑删除)并不是一个很轻松的事情,因为有几个问题(坑)是需要我们考虑的: 小程序的事件系统...
    季小白的时间阅读 1,669评论 0 3
  • WXS函数响应事件 从官方文档所描述: 在WXS函数接受2个参数,第一个是event,在event的基础上加eve...
    达文西_Huong阅读 295评论 0 0
  • 久违的晴天,家长会。 家长大会开好到教室时,离放学已经没多少时间了。班主任说已经安排了三个家长分享经验。 放学铃声...
    飘雪儿5阅读 7,550评论 16 22