更新记录

1.3.3(2021-02-01)

1.3.3(2020-09-15) 新增下拉刷新成功和失败的文本配置, 可在 mescroll-uni-option.js 配置修改 新增 me-video 视频组件, 解决APP端视频下拉悬浮错位的问题, 参考最新 mescroll-options.vue 示例 更新 mescroll-comp.vue 示例, 支持 mescroll-body 子子..子组件 , 包括 mescroll-more.vue 也支持写在子子..子组件 mescroll-uni 的 down.offset 由原来的 80 调整为 150 , 避免超快速滑动列表到底部,偶尔出现无法再翻页的问题 (mescroll-body无此问题) 修复 mescroll-more.vue 和 mescroll-swiper.vue 的示例在字节跳动小程序2.0.0以上新版编辑器无法正常运行的问题 修复淘宝和美团的示例下拉卡顿的问题 ( 案例需重新下载 ) -by mescroll 1.3.2(2020-08-05) mescroll.scrollTo(y)的y支持css选择器, 包括跨自定义组件的后代选择器, 支持滚动到子组件的view (参考 mescroll-options.vue) mescroll-body新增sticky属性, 简化吸顶悬浮sticky.vue的示例 QQ小程序支持wxs,解决QQ小程序卡顿和无法隐藏加载状态的问题 -by 小瑾同学 1.3.1(2020-07-27) 修复Android小程序下拉刷新时, image 和 swiper 脱离文档流的问题 修复H5端, 当配置down.use为false时, 返回其他页面无法滚动的问题 mescroll-comp.js支持mescroll-body写在子子子...组件中 (以前版本仅支持写在一级子组件) 吸顶悬浮提供了sticky样式和监听滚动条实现的示例: sticky.vue 和 sticky-scroll.vue (推荐使用sticky样式实现) -by 小瑾同学 1.3.0(2020-07-10) 微信小程序, app, h5使用高性能wxs和renderjs, 下拉刷新更流畅丝滑, 尤其能明显解决Android小程序下拉卡顿的问题 使用wxs和renderjs优化所有案例, 尤其是中高级案例, 建议大家重新下载最新的案例 废弃down的isBounce配置, 已通过renderjs自动判断, 无需配置mescroll-touch 废弃down的fps配置, 已通过wxs提高性能, 无需手动节流 新增 "局部区域滚动" 的案例: mescroll-body-part.vue 和 mescroll-uni-part.vue 解决swiper切换时,有时会触发下拉刷新的问题, 已避免swiper和下拉刷新相互冲突 解决钉钉小程序mescroll-uni下拉刷新有时无法触发的问题 解决上拉加载进度在部分Android手机显示不全的问题 提高 me-tabs 组件在部分Android手机的兼容性 -by 小瑾同学 1.2.8(2020-06-28) 解决 mescroll-uni 再某些情况下列表数据渲染不完全的问题 ( mescroll-body无此问题 ) 优化 me-tabs 组件, 使用支付宝小程序可隐藏滚动条, 同时修复字节跳动小程序tab切换时渲染延迟的问题 -by 小瑾同学 1.2.7(2020-06-24) 上拉加载结束隐藏底部加载区域,避免加载区域占位 h5端的tab页默认偏移TabBar的高度,避免h5端列表被TabBar遮住 (如不想偏移,可通过配置 :bottombar="false" 取消) 新增 me-tabs 组件,tabs支持水平滑动; 优化mescroll-more和mescroll-swiper的案例, 顶部tab支持水平滑动 1.2.6(2020-06-16) mescroll-uni 和 mescroll-body 的 scrollTo 正式支持 scroll-into-view (传入的 y 为view的id即可生效) topbar 顶部是否预留状态栏的高度, 默认false; 这个版本还可支持设置状态栏背景: 如 '#ffff00', 'url(xxx)', 'linear-gradient(xx)' down.bgColor 和 up.bgColor 加载区域的背景,不仅支持色值, 而且还是支持背景图和渐变: 如 'url(xxx)', 'linear-gradient(xx)' 通过css方式适配iPhoneX, 比之前通过style方式具有更好的兼容性, 也同时消除了edge浏览器重复设置相同属性的警告 移除非必须的标签选择器,避免微信小程序提示组件内不可使用标签选择器的警告 修复当配置up的use为false时,默认的下拉刷新有时候无法自动隐藏的问题 修复当配置down的native为true时,auto失效的问题 修复空布局在某些情况下图片和文本错位的问题 1.2.5(2020-03-15) mescroll-body 的 props 支持 safearea 的配置 (需要适配iPhoneX时,配置为 true 即可, 默认 false) mescroll-uni 的 scrollTo 支持 scroll-into-view (当传入的 y 为view的id时, 即可生效) 新增 下拉加载聊天记录的案例 list-msg.vue, 类似微信QQ的聊天记录 1.2.4(2020-03-11) down和up分别新增 bgColor 的配置: 下拉区域背景颜色,默认"transparent" down和up分别新增 textColor 的配置: 下拉文本的颜色,默认"gray" (当bgColor配置了颜色,而textColor未配置时,则自动默认为白色) 调整mescroll-more-item.js, 使mescroll-more的案例支持初始化tabIndex大于0的tab页 mescroll-body支持isBounce的配置, 解决H5下拉刷新失效的问题 解决mescroll-body在Android真机小程序下拉卡顿的问题 (mescroll-uni无此问题) 1.2.3(2020-02-18) 新增3个mescroll的mixins, 极大简化了mescroll-comp, mescroll-more, mescroll-swiper的案例

1.2.2(2020-02-16) 调整mescroll-more和mescroll-swiper的案例,确保各小程序平台可正确获取到mescroll对象 修复字节跳动小程序初始化时的异常警告: 详情 1.2.1(2020-02-08) 新增 组件, 用来填补 的不足. mescroll-body基于原生页的滚动,支持写入原生组件和fixed元素,不必固定高度,不必配置pages.json,简单性能好. mescroll-body可配置down的native:true, 可直接代理系统自带的下拉组件, 参考 mescroll-native 示例 新增mescroll-mixins.js,简化代码,兼容更多小程序平台 修复字节跳动小程序和支付宝小程序的部分异常警告 1.2.0(2020-01-06) mescroll-uni.vue的props新增height. // 简单快捷设置mescroll的高度, 此项有值,则不使用fixed. 使用场景: 当在弹窗或浮层中使用fixed固定mescroll高度比较麻烦时, 配置此项就很方便了 支持20, "20rpx", "20px", "20%"格式的值, 其中纯数字则默认单位rpx, 百分比则相对于windowHeight mescroll-uni.vue的props新增safearea. // bottom的偏移量是否加上底部安全区的距离, 默认false (需要适配iPhoneX时使用,此项值对回到顶部按钮生效) mescroll-uni.vue的props中,top和bottom不仅仅支持数字, 还支持"20rpx", "20px", "20%"格式的值 补充锁定上拉加载mescroll.lockUpScroll的方法 down.fps默认值提高至80 独立出空布局的组件, 以便在不使用mescroll的界面也能统一管理空布局

import MescrollEmpty from '@/components/mescroll-uni/components/mescroll-empty.vue';
export default {
    components: {
        MescrollEmpty
    },
    ...
}

为了更快速自定义回到顶部按钮, up.toTop新增以下配置项: toTop: { zIndex: 9990, // fixed定位z-index值 right: 20, // 到右边的距离, 默认20 (支持"20rpx", "20px", "20%"格式的值, 纯数字则默认单位rpx) bottom: 120, // 到底部的距离, 默认120 (支持"20rpx", "20px", "20%"格式的值, 纯数字则默认单位rpx) safearea: false, // bottom的偏移量是否加上底部安全区的距离, 默认false. 需要适配iPhoneX时使用 (具体的界面如果不配置此项,则取mescroll-uni.vue的safearea值) width: 72, // 回到顶部图标的宽度, 默认72 (支持"20rpx", "20px", "20%"格式的值, 纯数字则默认单位rpx) radius: "50%", // 圆角, 默认"50%" (支持"20rpx", "20px", "20%"格式的值, 纯数字则默认单位rpx) left: null, // 到左边的距离, 默认null. 此项有值时,right不生效. (支持"20rpx", "20px", "20%"格式的值, 纯数字则默认单位rpx) duration: 300, // 回到顶部的动画时长,默认300ms (当值为0或300则使用系统自带回到顶部,更流畅; 其他值则通过step模拟,部分机型可能不够流畅,所以非特殊情况不建议修改此项) src: null, // (已有配置) offset: 1000 // (已有配置) } 1.1.9(2019-12-16) 解决左右滑动屏幕,某些情况下会触发上拉回调的bug mescroll-uni.vue的props新增topbar: top的偏移量是否加上状态栏高度 (当fixed为false时不生效; 使用场景:取消原生导航栏时,配置此项可自动加上状态栏高度的偏移量) 1.1.8(2019-11-01) 解决Android小程序快速上拉可能会导致不断翻页的bug 过滤某些情况下touch的警告输出 1.1.7(2019-10-15) 重点解决下拉刷新卡顿,特别是Android小程序卡顿的问题 补充之前版本遗漏的mescroll.lockUpScroll方法 支持数据不满屏时,仍可触发翻页的回调 1.1.60(2019-10-15) 重点解决下拉刷新卡顿,特别是Android小程序卡顿的问题 (所以down的supply配置项也相应移除了) 补充之前版本遗漏的mescroll.lockUpScroll方法 1.1.6(2019-10-15) 重点解决下拉刷新卡顿,特别是Android小程序卡顿的问题 (所以down的supply配置项也相应移除了)

1.1.5(2019-07-25) up新增isBounce的配置, 默认值为false. 目的是解决H5在ios下拉出现灰色背景和android端无法正常下拉的问题. 详见: http://www.mescroll.com/qa.html?v=190725#q25 修复setClientHeight某些情况下会提示undefined的问题 修复在mescroll-uni-option.js配置page会导致分页异常的问题 1.1.2(2019-07-19) 一. 修复和优化的内容:

修复列表不满屏时,无法上拉的问题 修复列表滚动到底部,有时无法上拉的问题 修复快速滚动到顶部时,滚动条的位置有时不为0的问题 修复配置page.num不生效的问题 修复小程序android端下拉卡顿的问题 (可配置down的supply,复杂的列表可适当调大值) 修复H5多mescroll的情况下回到顶部按钮错位的问题 优化和简化逻辑,去除冗余代码 二. 完善获取节点信息的方式:

获取mescroll的唯一元素id: mescroll.viewId (可通过uni.createSelectorQuery进一步获取更多信息) 获取滚动内容的高度: mescroll.getScrollHeight() 获取mescroll的高度: mescroll.getClientHeight() 获取滚动条位置: mescroll.getScrollTop() 获取到底部的距离: mescroll.getScrollBottom() 获取滚动的方向: mescroll.isScrollUp // true向上滑; false向下滑 更多信息详见mescroll-options的示例 1.1.1(2019-07-16) 修复滚动到顶部,有时无法下拉的问题 修复禁止上拉时,列表底部有空白区域的问题 1.1.0(2019-07-01) 一. 简化使用:

无需在page.json中配置onReachBottomDistance 无需在页面中注册onReachBottom 和 onPageScroll 初始化时@init不再是必须配置项 极大的简化 list-mescroll-more.vue 的案例 全面支持在swiper中使用,详见 mescroll-swiper.vue 的案例 二. 优化性能:

支持fixed定位,可实现局部区域滚动 支持swiper,scrollview嵌套使用 优化下拉逻辑,修复下拉刷新卡顿和抖动的问题 优化默认样式,避免某些情况出现双滚动条的问题 up废弃errDistance配置, 内部已优化处理相关问题 三. 新增配置:

down和up新增fps节流配置.(默认40fps, 值越大每秒刷新频率越高) up新增offset配置: 距底部多远时,触发upCallback (默认80, 代替page.json的onReachBottomDistance) up新增onScroll配置: 是否监听滚动事件,默认false < mescroll-uni 新增 @scroll="scroll" 获取滚动条的位置和滚动方向, 需配置up的onScroll为true, 详见 mescroll-options.vue 的示例 < mescroll-uni 新增 :fixed="true/false" 是否支持fixed定位, 默认 true. 当:fixed="true", 此时 :top 和 :bottom 为 fixed 的 top 和 bottom 当:fixed="false", 此时 :top 和 :bottom 为 padding-top 和 padding-bottom 四. 案例优化:

所有基础案例都有所简化, 建议重新下载参考. (以前版本向下兼容) 所有中高级案例自定义的部分,改动比较大, 必须重新下载参考. (不兼容以前版本)


平台兼容性

mescroll --【wxs+renderjs实现】高性能的下拉刷新上拉加载组件 mescroll的uni版本 是专门用在uni-app的下拉刷新和上拉加载的组件, 支持一套代码编译到iOS、Android、H5、小程序等多个平台

mescroll的uni版本 继承了mescroll.js的实用功能: 自动处理分页, 自动控制无数据, 空布局提示, 回到顶部按钮 ..

mescroll的uni版本 丰富的案例, 自由灵活的api, 超详细的注释, 可让您快速自定义真正属于自己的下拉上拉组件

最新文档(1.3.3版本): http://www.mescroll.com/uni.html

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问