/mescroll

精致的下拉刷新和上拉加载 js框架.支持vue,完美运行于移动端和主流PC浏览器 (JS framework for pull-refresh and pull-up-loading)

Primary LanguageVueMIT LicenseMIT

mescroll

mescroll -- 精致的下拉刷新和上拉加载js框架 (JS framework for pull-refresh and pull-up-loading)

  1. 原生js, 支持vue, 不依赖jquery,zepto

  2. 一套代码多端运行. 完美运行于android,iOS,手机浏览器,兼容PC主流浏览器

  3. 参数自由搭配, 随心定制, 轻松拓展

  4. 主流APP案例, 丰富经典

  5. MIT协议, 免费商用, 欢迎pull requests ~

  6. mescroll交流群: 633126761

目录:

功能亮点 :

  1. 自动判断和提示列表无任何数据或无更多数据

  2. 支持监听列表滚动事件,无需手动判断处理列表的页码,时间等变量

  3. 可指定列表滚动到任何位置,附带平滑效果一键滚动到顶部或底部

  4. 可配置列表数据不满屏时,自动加载下一页

  5. 一个界面可支持多个下拉刷新,上拉加载

  6. 可临时锁定下拉刷新和上拉加载

  7. 支持图片懒加载,可配置各种占位图与显示动画,上手超简单

NPM

特别感谢 @channg 帮忙整理发布NPM

    npm install --save mescroll.js    //不要使用cnpm安装

快速入门 :

1. 引用 mescroll.min.css , mescroll.min.js

2. 拷贝以下布局结构:

        <div id="mescroll" class="mescroll"> //id可以改,而"mescroll"的class不能删
            <div> //这个div不能删, 可以改成ul或者其他容器标签.
            	//内容...
            </div>
        </div>  

3. 固定mescroll的div高度. 推荐通过定位的方式,简单快捷: (点此查看其他方法)

       .mescroll{
		position: fixed;
		top: 44px;
		bottom: 0;
		height: auto; /*如设置bottom:50px,则需height:auto才能生效*/
	}

4. 创建MeScroll对象:

        var mescroll = new MeScroll("mescroll", { //第一个参数"mescroll"对应上面布局结构div的id (1.3.5版本支持传入dom对象)
    		down: {
			callback: downCallback //下拉刷新的回调,别写成downCallback(),多了括号就自动执行方法了
		},
		up: {
			callback: upCallback, //上拉加载回调,简写callback:function(page){upCallback(page);}
			//以下是一些常用的配置,当然不写也可以的.
			page: {
				num: 0, //当前页 默认0,回调之前会加1; 即callback(page)会从1开始
				size: 10, //每页数据条数,默认10
			},
			htmlNodata: '<p class="upwarp-nodata">亲,没有更多数据了~</p>',
			noMoreSize: 5, //如果列表已无数据,可设置列表的总数量要大于5才显示无更多数据;避免列表数据过少(比如只有一条数据),显示无更多数据会不好看.这就是为什么无更多数据 有时候不显示的原因了.
			toTop: {
				//回到顶部按钮
				src: "../img/mescroll-totop.png", //图片路径,默认null,支持网络图
				offset: 1000, //列表滚动1000px才显示回到顶部按钮			
			},
			empty: {
				//列表第一页无任何数据时,显示的空提示布局; 需配置warpId才显示
				warpId:	"xxid", //父布局的id (1.3.5版本支持传入dom元素)
				icon: "../img/mescroll-empty.png", //图标,默认null,支持网络图
				tip: "暂无相关数据~" //提示
			},
			lazyLoad: {
		        	use: true, // 是否开启懒加载,默认false
		        	attr: 'imgurl', // 网络图片地址的属性名 (图片加载成功会自动移除改属性): <img imgurl='网络图  src='占位图''/>
				offset: 200 // 超出可视区域多少px的图片仍可触发懒加载 默认200. 目的是提前加载可视区域外的部分图片
		    	}
		}
	});
温馨提示:
1. 如果您的下拉刷新是重置列表数据,那么down完全可以不用配置,具体用法参考第一个基础案例
解析: down内部默认调用的是mescroll.resetUpScroll(),而resetUpScroll会将page.num=1,再触发up.callback,从而实现刷新列表数据
2. 如果您的项目是在iOS的微信,QQ,Safari等浏览器访问的,建议配置up的isBounce为false,禁止ios的回弹效果; 解析(必读)

5. 处理回调:

        //下拉刷新的回调
        function downCallback(){
            $.ajax({
                url: 'xxxxxx',
                success: function(data){
                	//联网成功的回调,隐藏下拉刷新的状态;
        		mescroll.endSuccess();//无参,注意此处无参
        		//设置数据
        		//setXxxx(data);//自行实现 TODO
               },
               error: function(data){
               		//联网失败的回调,隐藏下拉刷新的状态
        	        mescroll.endErr();
                }
            });
        }

        //上拉加载的回调 page = {num:1, size:10}; num:当前页 从1开始, size:每页数据条数
        function upCallback(page){
            $.ajax({
                url: 'xxxxxx?num='+ page.num +"&size="+ page.size,
                success: function(curPageData){
			//联网成功的回调,隐藏下拉刷新和上拉加载的状态;
			//mescroll会根据传的参数,自动判断列表如果无任何数据,则提示空;列表无下一页数据,则提示无更多数据;
					
			//方法一(推荐): 后台接口有返回列表的总页数 totalPage
			//必传参数(当前页的数据个数, 总页数)
			//mescroll.endByPage(curPageData.length, totalPage);
					
			//方法二(推荐): 后台接口有返回列表的总数据量 totalSize
			//必传参数(当前页的数据个数, 总数据量)
			//mescroll.endBySize(curPageData.length, totalSize);
					
			//方法三(推荐): 您有其他方式知道是否有下一页 hasNext
			//必传参数(当前页的数据个数, 是否有下一页true/false)
			//mescroll.endSuccess(curPageData.length, hasNext);
					
			//方法四 (不推荐),会存在一个小问题:比如列表共有20条数据,每页加载10条,共2页.
			//如果只根据当前页的数据个数判断,则需翻到第三页才会知道无更多数据
			//如果传了hasNext,则翻到第二页即可显示无更多数据.
			//mescroll.endSuccess(curPageData.length);
			
			//提示:curPageData.length必传的原因:
			// 1.使配置的noMoreSize生效
			// 2.判断是否有下一页的首要依据: 当传的值小于page.size时,则一定会认为无更多数据. 比传入的totalPage, totalSize, hasNext具有更高的判断优先级
			// 3.当传的值等于page.size时,才会取totalPage, totalSize, hasNext判断是否有下一页. 传totalPage, totalSize, hasNext主要目的是避免方法四描述的小问题
					
			//设置列表数据
			//setListData(curPageData);//自行实现 TODO
                },
                error: function(){
                	//联网失败的回调,隐藏下拉刷新和上拉加载的状态
	                mescroll.endErr();
                }
         });
        }

--- 以上为mescroll最基本的用法,强烈建议您下载并查看 mescroll基础案例 , 发现mescroll更强大的功能 ~
--- 基础案例一共6个, 每个案例3分钟, 一共花您18分钟; 这18分钟您将了解mescroll在不同情况下应如何快速配置 ~
--- 特别建议您, 手动改改 mescroll-options 的每项配置, 观察修改后的效果, 轻松理解各项参数, 还会有意想不到的发现哦 ~
--- 磨刀不误砍柴工,心急吃不了热豆腐. 请静下心来体验与理解mescroll, 一定会让您事半功倍 ~
--- 如使用中有疑问, 请先查看 常见问题专区 ~

图片懒加载

mescroll的图片懒加载功能是1.3.6新增的,使用超简单 :

1. 确保mescroll至少更新到1.3.6版本
2. 初始化mescroll的时候,在up中配置lazyLoad的use为true :
var mescroll = new MeScroll("mescroll", {
	up: {
		lazyLoad: {
	        	use: true, // 是否开启懒加载,默认false
		        attr: 'imgurl', // 网络图片地址的属性名 (图片加载成功会自动移除改属性): <img imgurl='网络图  src='占位图''/>
		        showClass: 'mescroll-lazy-in', // 图片加载成功的显示动画: 渐变显示,参见mescroll.css
		        delay: 500, // 列表滚动的过程中每500ms检查一次图片是否在可视区域,如果在可视区域则加载图片
		        offset: 200 // 超出可视区域200px的图片仍可触发懒加载,目的是提前加载部分图片
	    	}
	}
})
3. 设置img或div的 imgurl 属性, 值为图片的网络地址
img标签: <img imgurl="网络图" src="占位图"/> // 占位图直接在src设置; 图片加载成功,就会替换src的占位图
div或其他标签: <div imgurl="网络图" style="background-image: url(占位图)"></div>; // 占位图在css中设置; 图片以背景图的形式展示
4. 至此mescroll的懒加载功能已经可以正常使用了,mescroll在列表滚动时会自动加载可视区域内的图片.另外,有时候您可能会动态添加或修改图片,希望手动触发一下懒加载, 那么只需调用 mescroll.lazyLoad() 或 mescroll.endByPage() 或 mescroll.endBySize() 或 mescroll.endSuccess() 即可.
5. mescroll的所有案例都开启了懒加载,您可参考体验. 当然这里还有专门介绍懒加载的案例~

vue-cli

在vue单文件中的使用步骤 (至少更新到1.3.5版本):

1. 执行npm命令安装mescroll :     npm install --save mescroll.js //不要使用cnpm安装
2. 引入mescroll.min.js :     import MeScroll from 'mescroll.js'
3. 引入mescroll.min.css :     import 'mescroll.js/mescroll.min.css'
4. vue单文件示例 :
<template>
  <div>
    <!--mescroll滚动区域的基本结构,为避免id重复导致的多次初始化,这里使用ref-->
    <div ref="mescroll" class="mescroll">
      <div>
        <!--内容...-->
      </div>
    </div>
  </div>
</template>

<script>
//引入mescroll.min.js和mescroll.min.css
import MeScroll from 'mescroll.js'
import 'mescroll.js/mescroll.min.css'

export default {
  name: 'xxx',
  data() {
    return {
      mescroll: null, //mescroll实例对象
      dataList:[] //列表数据
    }
  },
  mounted: function () {
    //创建MeScroll对象
    this.mescroll = new MeScroll(this.$refs.mescroll, { // 在vue的mounted生命周期初始化mescroll,确保此处配置的ref有值
    	// down:{}, //下拉刷新的配置. (如果下拉刷新和上拉加载处理的逻辑是一样的,则down可不用写了)
      up: {
        callback: this.upCallback,
        // 以下是一些常用的配置,当然不写也可以的.
	page: {
		num: 0, //当前页 默认0,回调之前会加1; 即callback(page)会从1开始
		size: 10, //每页数据条数,默认10
	},
	htmlNodata: '<p class="upwarp-nodata">亲,没有更多数据了~</p>',
	noMoreSize: 5, //如果列表已无数据,可设置列表总数大于5才显示无更多数据;避免列表数据过少(比如只有一条数据),显示无更多数据会不好看
	toTop: {
		//回到顶部按钮
		src: "./static/mescroll/mescroll-totop.png", //图片路径,默认null,支持网络图
		offset: 1000, //列表滚动1000px才显示回到顶部按钮			
	},
	empty: {
		//列表第一页无任何数据时,显示的空提示布局; 需配置warpId才显示
		warpId:	"xxid", //父布局的id (1.3.5版本支持传入dom元素)
		icon: "./static/mescroll/mescroll-empty.png", //图标,默认null,支持网络图
		tip: "暂无相关数据~", //提示
	}
      }
    });
  },
  methods: {
    //上拉回调 page = {num:1, size:10}; num:当前页 ,默认从1开始; size:每页数据条数,默认10
    upCallback(page) {
      //联网请求
      axios.get("xxxxxx", {
        params: {
          num: page.num, //页码
          size: page.size //每页长度
        }
      }).then((response)=> {
        //请求的列表数据
        let arr = response.data;
        //如果是第一页需手动制空列表
        if (page.num == 1) this.dataList = [];
        //把请求到的数据添加到列表
        this.dataList = this.dataList.concat(arr);
        //数据渲染成功后,隐藏下拉刷新的状态
        this.$nextTick(() => {
          this.mescroll.endSuccess(arr.length);
        })
      }).catch((e)=> {
        //联网失败的回调,隐藏下拉刷新和上拉加载的状态;
        this.mescroll.endErr();
      })
    }
  },
  // 进入路由时,恢复列表状态
  beforeRouteEnter (to, from, next) {  // 如果没有配置回到顶部按钮或isBounce,则beforeRouteEnter不用写
    next(vm => {
      if (vm.mescroll) {
      	// 恢复到之前设置的isBounce状态
        if (vm.mescroll.lastBounce != null) vm.mescroll.setBounce(vm.mescroll.lastBounce)
        // 滚动到之前列表的位置 (注意:路由使用keep-alive才生效)
        if (vm.mescroll.lastScrollTop) {
          vm.mescroll.setScrollTop(vm.mescroll.lastScrollTop)
          setTimeout(() => { // 需延时,因为setScrollTop内部会触发onScroll,可能会渐显回到顶部按钮
            vm.mescroll.setTopBtnFadeDuration(0)// 设置回到顶部按钮显示时无渐显动画
          }, 16)
        }
      }
    })
  },
  // 离开路由时,记录列表状态
  beforeRouteLeave (to, from, next) {  // 如果没有配置回到顶部按钮或isBounce,则beforeRouteLeave不用写
    if (this.mescroll) {
      this.mescroll.lastBounce = this.mescroll.optUp.isBounce// 记录当前是否禁止ios回弹
      this.mescroll.setBounce(true) // 允许bounce
      this.mescroll.lastScrollTop = this.mescroll.getScrollTop()// 记录当前滚动条的位置
      this.mescroll.hideTopBtn(0)// 隐藏回到顶部按钮,无渐隐动画
    }
    next()
  }
}
</script>

<style scope>
  /*通过fixed固定mescroll的高度*/
  .mescroll {
    position: fixed;
    top: 44px;
    bottom: 0;
    height: auto;
  }
</style>

以上写法有些繁琐,在vue中强烈建议使用mescroll组件,简单快捷:

mescroll组件

mescroll组件使用步骤 (至少更新到1.3.5版本):

1. 执行npm命令安装mescroll :     npm install --save mescroll.js //不要使用cnpm安装
2. 引入mescroll组件 :     import MescrollVue from 'mescroll.js/mescroll.vue'
3. vue单文件示例 :
<template>
  <div>
    <!--mescroll滚动区域的基本结构-->
    <mescroll-vue ref="mescroll" :down="mescrollDown" :up="mescrollUp" @init="mescrollInit">
      <!--内容...-->
    </mescroll-vue>
  </div>
</template>

<script>
// 引入mescroll的vue组件
import MescrollVue from 'mescroll.js/mescroll.vue'

export default {
  name: 'xxx',
  components: {
    MescrollVue // 注册mescroll组件
  },
  data () {
    return {
      mescroll: null, // mescroll实例对象
      mescrollDown:{}, //下拉刷新的配置. (如果下拉刷新和上拉加载处理的逻辑是一样的,则mescrollDown可不用写了)
      mescrollUp: { // 上拉加载的配置.
        callback: this.upCallback, // 上拉回调,此处可简写; 相当于 callback: function (page, mescroll) { getListData(page); }
        //以下是一些常用的配置,当然不写也可以的.
	page: {
		num: 0, //当前页 默认0,回调之前会加1; 即callback(page)会从1开始
		size: 10 //每页数据条数,默认10
	},
	htmlNodata: '<p class="upwarp-nodata">亲,没有更多数据了~</p>',
	noMoreSize: 5, //如果列表已无数据,可设置列表总数大于5才显示无更多数据;避免列表数据过少(比如只有一条数据),显示无更多数据会不好看
	toTop: {
		//回到顶部按钮
		src: "./static/mescroll/mescroll-totop.png", //图片路径,默认null,支持网络图
		offset: 1000 //列表滚动1000px才显示回到顶部按钮			
	},
	empty: {
		//列表第一页无任何数据时,显示的空提示布局; 需配置warpId才显示
		warpId: "xxid", //父布局的id (1.3.5版本支持传入dom元素)
		icon: "./static/mescroll/mescroll-empty.png", //图标,默认null,支持网络图
		tip: "暂无相关数据~" //提示
	}
      },
      dataList: [] // 列表数据
    }
  },
  beforeRouteEnter (to, from, next) { // 如果没有配置回到顶部按钮或isBounce,则beforeRouteEnter不用写
    next(vm => {
      vm.$refs.mescroll.beforeRouteEnter() // 进入路由时,滚动到原来的列表位置,恢复回到顶部按钮和isBounce的配置
    })
  },
  beforeRouteLeave (to, from, next) { // 如果没有配置回到顶部按钮或isBounce,则beforeRouteLeave不用写
    this.$refs.mescroll.beforeRouteLeave() // 退出路由时,记录列表滚动的位置,隐藏回到顶部按钮和isBounce的配置
    next()
  },
  methods: {
    // mescroll组件初始化的回调,可获取到mescroll对象
    mescrollInit (mescroll) {
      this.mescroll = mescroll
    },
    // 上拉回调 page = {num:1, size:10}; num:当前页 ,默认从1开始; size:每页数据条数,默认10
    upCallback (page, mescroll) {
      // 联网请求
      axios.get('xxxxxx', {
        params: {
          num: page.num, // 页码
          size: page.size // 每页长度
        }
      }).then((response) => {
        // 请求的列表数据
        let arr = response.data
        // 如果是第一页需手动制空列表
        if (page.num === 1) this.dataList = []
        // 把请求到的数据添加到列表
        this.dataList = this.dataList.concat(arr)
        // 数据渲染成功后,隐藏下拉刷新的状态
        this.$nextTick(() => {
          mescroll.endSuccess(arr.length)
        })
      }).catch((e) => {
        // 联网失败的回调,隐藏下拉刷新和上拉加载的状态;
        mescroll.endErr()
      })
    }
  }
}
</script>

<style scope>
  /*以fixed的方式固定mescroll的高度*/
  .mescroll {
    position: fixed;
    top: 44px;
    bottom: 0;
    height: auto;
  }
</style>

API文档 :

//创建mescroll对象
var mescroll = new MeScroll(id或dom对象, { down: {下拉刷新的配置参数}, up: {上拉加载的配置参数} });
down 下拉刷新的配置参数
参数名 默认值 说明
use true 是否启用下拉刷新
auto true 是否在初始化完毕之后自动执行下拉刷新的回调
autoShowLoading false 当设置auto=true时(在初始化完毕之后自动执行下拉刷新的回调)
是否显示下拉刷新的进度
需配置down的callback才生效
isLock false 是否锁定下拉刷新
isBoth false 下拉刷新时,如果滑动到列表底部是否可以同时触发上拉加载
offset 80 在列表顶部,下拉大于80px,松手即可触发下拉刷新的回调
outOffsetRate 0.2 在列表顶部,下拉的距离大于offset时,改变下拉区域高度比例;值越接近0,高度变化越小,表现为越往下越难拉
bottomOffset 20 当手指touchmove位置在距离body底部20px范围内的时候结束上拉刷新,避免Webview嵌套导致touchend事件不执行
这是1.2.1版本新增的配置,请检查最新版~
minAngle 45 触发下拉最少要偏移的角度(滑动的轨迹与水平线的锐角值),取值区间 [0,90];默认45度,即向下滑动的角度大于45度(方位角为45°~145°及225°~315°)则触发下拉;而小于45度,将不触发下拉,避免与左右滑动的轮播等组件冲突;
注意:没有必要配置超出[0,90]区间的值,否则角度限制无效; 因为假设配置60, 生效的方位角就已经是60°到120° 和 240°到300°的范围了;
这是1.1.6版本新增的配置,请检查最新版~
hardwareClass "mescroll-hardware" 硬件加速样式,解决iOS下拉因隐藏进度条而闪屏的问题,参见mescroll.css
warpClass "mescroll-downwarp" 下拉刷新的布局容器样式,参见mescroll.css
mustToTop
1.3.7版本新增
false 是否滚动条必须在顶部,才可以下拉刷新.默认false. 当您发现下拉刷新会闪白屏时,设置true即可修复.
warpId null 可配置下拉刷新的布局添加到指定id的div
默认不配置,默认添加到mescrollId
resetClass "mescroll-downwarp-reset" 下拉刷新高度重置的动画,参见mescroll.css
textInOffset
1.3.7版本新增
'下拉刷新' 下拉的距离在offset范围内的提示文本
textOutOffset
1.3.7版本新增
'释放更新' 下拉的距离大于offset范围的提示文本
textLoading
1.3.7版本新增
'加载中 ...' 加载中的提示文本
htmlContent '<p class="downwarp-progress"></p><p class="downwarp-tip"></p>' 下拉刷新的布局内容
inited function(mescroll, downwarp) { ... } 下拉刷新初始化完毕的回调(mescroll实例对象,下拉刷新容器dom对象)
inOffset function(mescroll) { ... } 下拉的距离进入offset范围内那一刻的回调(mescroll实例对象)
outOffset function(mescroll) { ... } 下拉的距离大于offset那一刻的回调(mescroll实例对象)
onMoving function(mescroll, rate, downHight) { ... } 下拉过程中的回调,滑动过程一直在执行; rate下拉区域当前高度与指定距离的比值(inOffset: rate<1; outOffset: rate>=1); downHight当前下拉区域的高度
beforeLoading function(mescroll, downwarp) { return false; } 准备触发下拉刷新的回调; 如果要完全自定义下拉刷新,那么return true,此时将不触发showLoading和callback回调; 参考案例【淘宝 v6.8.0】
showLoading function(mescroll) { ... } 显示下拉刷新进度的回调
afterLoading function(mescroll) { return 0 } 结束加载中,准备隐藏下拉的回调
返回结束下拉的延时执行时间,默认0ms
常用于结束下拉之前再显示另外一小段动画,才去隐藏下拉刷新的场景, 参考案例【dotJump】
callback function(mescroll) { mescroll.resetUpScroll(); } 下拉刷新的回调; 默认重置上拉加载列表为第一页

up 上拉加载的配置参数
参数名 默认值 说明
use true 是否启用上拉加载
auto false 是否在初始化完毕之后自动执行上拉加载的回调
isLock false 是否锁定上拉加载
isBoth false 上拉加载时,如果滑动到列表顶部是否可以同时触发下拉刷新
isBounce true 是否允许ios的bounce回弹;默认true,允许回弹 (v 1.3.0新增)
offset 100 列表滚动到距离底部小于100px,即可触发上拉加载的回调
noMoreSize 5 如果列表已无数据,可设置列表的总数量要大于5条才显示无更多数据;避免列表数据过少(比如只有一条数据),显示无更多数据会不好看
toTop {
warpId: null,
src: null,
html: null,
offset: 1000,
warpClass: "mescroll-totop",
showClass: "mescroll-fade-in",
hideClass: "mescroll-fade-out",
duration: 300,
supportTap: false
btnClick : null
}
回到顶部按钮的配置:
warpId: 父布局的id; 默认添加在body中 (1.3.5版本支持传入dom元素)
src: 图片路径,必须配置src才会显示回到顶部按钮,不配置不显示
html: 标签内容,默认null; 如果同时设置了src,则优先取src (2017/12/10新增)
offset: 列表滚动1000px显示回到顶部按钮
warpClass: 按钮样式,参见mescroll.css
showClass: 显示样式,参见mescroll.css
hideClass: 隐藏样式,参见mescroll.css
duration: 回到顶部的动画时长,默认300ms
supportTap: 如果您的运行环境支持tap,则可配置true,可减少点击延时,快速响应事件;默认false,通过onclick添加点击事件; (v 1.3.0 新增) (注:微信和PC无法响应tap事件)
btnClick: 点击按钮的回调; 提示:如果在回调里return true,将不执行回到顶部的操作
loadFull {
use: false,
delay: 500
}
use: 列表数据过少,不足以滑动触发上拉加载,是否自动加载下一页,直到满屏或者无更多数据为止; 默认false,因为可通过调高page.size避免这个情况
delay: 延时执行的毫秒数; 延时是为了保证列表数据或占位的图片都已初始化完成,且下拉刷新上拉加载中区域动画已执行完毕;
empty {
warpId: null,
icon: null,
tip: "暂无相关数据~",
btntext: "",
btnClick: null,
supportTap: false
}
列表第一页无任何数据时,显示的空提示布局; 需配置warpId或clearEmptyId才生效
warpId: 父布局的id; 如果此项有值,将不使用clearEmptyId的值; (1.3.5版本支持传入dom元素)
icon: 空布局的图标路径
tip: 提示文本
btntext: 按钮文本
btnClick: 点击按钮的回调
supportTap: 如果您的运行环境支持tap,则可配置true,可减少点击延时,快速响应事件;默认false,通过onclick添加点击事件; (v 1.3.0 新增) (注:微信和PC无法响应tap事件)
clearId null 加载第一页时需清空数据的列表id; 如果此项有值,将不使用clearEmptyId的值; 在vue中使用,则无需配置此项
clearEmptyId null 相当于同时设置了clearId和empty.warpId; 简化写法; 在vue中使用,不能配置此项 (1.3.5版本支持传入dom元素)
hardwareClass "mescroll-hardware" 硬件加速样式,使动画更流畅,参见mescroll.css
warpClass "mescroll-upwarp" 上拉加载的布局容器样式,参见mescroll.css
warpId null 可配置上拉加载的布局添加到指定id的div;默认不配置,默认添加到mescrollId
htmlLoading '<p class="upwarp-progress mescroll-rotate"></p><p class="upwarp-tip">加载中..</p>' 上拉加载中的布局,参见mescroll.css
htmlNodata '<p class="upwarp-nodata">-- END --</p>' 无数据的布局,参见mescroll.css
inited function(mescroll, upwarp){} 初始化完毕的回调; 回调(mescroll实例, upwarp上拉加载的布局Dom对象)
showLoading function(mescroll, upwarp){ ... } 显示上拉加载中的回调; 回调(mescroll实例, upwarp上拉加载的布局Dom对象)
showNoMore function(mescroll, upwarp){ ... } 显示无更多数据的回调; 回调(mescroll实例, upwarp上拉加载的布局Dom对象)
onScroll null 列表滑动监听, 默认null
例 onScroll : function(mescroll, y, isUp){ ... };
y为列表当前滚动条的位置;
isUp=true向上滑,isUp=false向下滑)
isUp是1.2.1版本新增的配置,请检查最新版~
callback function(page,mescroll){} 上拉加载的回调; 回调(page对象,mescroll实例), 其中page={num:页码, size:每页数据的数量, time:第一页数据的时间}
page {
num:0,
size:10,
time:null
}
num: 当前页码,默认0,回调之前会加1,即callback(page)会从1开始;
size: 每页数据的数量;
time: 加载第一页数据服务器返回的时间;防止用户翻页时,后台新增了数据从而导致下一页数据重复;
scrollbar {
  use : ... ,
  barClass : "mescroll-bar"
}
use : 是否开启自定义滚动条; PC端默认true开启自定义滚动条; 移动端默认false不使用
barClass : 自定义滚动条的样式; 参见mescroll.css
lazyLoad
(1.3.6新增)
{
use: false,
attr: 'imgurl',
showClass: 'mescroll-lazy-in',
delay: 500,
offset: 200
}
use: 是否开启懒加载,默认false
attr: 标签中网络图片地址的属性名,默认"imgurl"
showClass: 显示样式:渐变显示,参见mescroll.css
delay: 列表滚动的过程中检查一次图片是否在可视区域的时间间隔,默认500 (单位ms)
offset: 超出可视区域多少px的图片仍可触发懒加载 默认200

常用方法 :

方法名 说明
mescroll.endByPage(dataSize, totalPage, systime);
(v 1.2.1 新增)
隐藏下拉刷新和上拉加载的状态, 在联网获取数据成功后调用
dataSize : 当前页获取的数据总数(注意是当前页)
totalPage : 列表的总页数
systime : 加载第一页数据的服务器时间 (可空);
mescroll.endBySize(dataSize, totalSize, systime);
(v 1.2.1 新增)
隐藏下拉刷新和上拉加载的状态, 在联网获取数据成功后调用
dataSize : 当前页获取的数据总数(注意是当前页)
totalSize : 列表的总数据量
systime : 加载第一页数据的服务器时间 (可空);
mescroll.endSuccess(dataSize, hasNext, systime);
(v 1.2.1 调整)
隐藏下拉刷新和上拉加载的状态, 在联网获取数据成功后调用
dataSize : 当前页获取的数据量(注意是当前页)
hasNext : 是否有下一页数据true/false
systime : 加载第一页数据的服务器时间 (可空);
mescroll.endErr(); 隐藏下拉刷新和上拉加载的状态, 在联网获取数据失败后调用;
mescroll内部会自动恢复原来的页码,时间等变量;
mescroll.resetUpScroll( isShowLoading ); 重置列表为第一页 (常用于列表筛选条件变化或切换菜单时重新刷新列表数据)
内部实现: 把page.num=1,再主动触发up.callback
isShowLoading 是否显示进度布局;
1.默认null,不传参,则显示上拉加载的进度布局
2.传参true, 则显示下拉刷新的进度布局
3.传参false,则不显示上拉和下拉的进度 (常用于静默更新列表数据)
mescroll.triggerDownScroll(); 主动触发下拉刷新
mescroll.triggerUpScroll(); 主动触发上拉加载
mescroll.setPageNum(num);
(v 1.2.5 新增)
设置当前page.num的值
mescroll.setPageSize(size);
(v 1.2.5 新增)
设置当前page.size的值
mescroll.scrollTo( y, t ); 滚动列表到指定位置 ( y=0回到列表顶部; 如需滚动到列表底部,可设置y很大的值,比如y=99999 ); t时长,单位ms,默认300
mescroll.optDown; 获取下拉刷新的配置
mescroll.optUp; 获取上拉加载的配置
mescroll.lockDownScroll( isLock ); 锁定下拉刷新 ( isLock=ture,null 锁定 ; isLock=false 解锁 )
mescroll.lockUpScroll( isLock ); 锁定上拉加载 ( isLock=ture,null 锁定 ; isLock=false 解锁 )
mescroll.os
(v 1.2.5 新增)
mescroll.os.ios 为true, 则是ios设备;
mescroll.os.android 为true, 则是android设备;
mescroll.os.pc 为true, 则是PC端;
mescroll.setBounce(boolean)
(v 1.3.0 新增)
mescroll.setBounce(true) 允许bounce;
mescroll.setBounce(false) 禁止bounce
mescroll.lazyLoad(delay)
(v 1.3.6 新增)
主动触发懒加载: 自动加载可视区域的图片.
delay:延时加载图片的时间,默认500ms.目的是确保dom元素已渲染完成.

其他方法 :

以下方法不常用,您可灵活运用于更复杂的场景
mescroll.showDownScroll(); 显示下拉刷新的进度布局
mescroll.triggerDownScroll() 和 mescroll.resetUpScroll() 内部有调用
mescroll.endDownScroll(); 隐藏下拉刷新的进度布局
mescroll.endSuccess() 和 mescroll.endErr() 内部有调用
mescroll.showUpScroll(); 显示上拉加载的进度布局
mescroll.triggerDownScroll() 和 mescroll.resetUpScroll() 内部有调用
mescroll.showNoMore(); 显示上拉无更多数据的布局
mescroll.endUpScroll() 内部有调用
mescroll.hideUpScroll(displayAble); 隐藏上拉加载的布局
mescroll.endUpScroll() 内部有调用
1.3.5新增参数 displayAble: 是否通过display:none隐藏, 默认false通过visibility:hidden的方式隐藏
mescroll.clearDataList(); 清空上拉加载的数据列表
mescroll.resetUpScroll() 和 mescroll.endSuccess() 内部有调用
mescroll.loadFull(); 检查如果加载的数据过少,无法触发上拉加载时,则自动加载下一页,直到满屏或无数据
此方法最好在列表的图片数据加载完成之后调用,以便计算列表内容高度的准确性
mescroll.endSuccess() 内部有调用
mescroll.showEmpty(); 显示无任何数据的空布局
mescroll.endSuccess() 内部有调用
mescroll.removeEmpty(); 移除无任何数据的空布局
mescroll.endSuccess() 内部有调用
mescroll.showTopBtn(time); 显示回到顶部的按钮
time: 显示的动画时长,默认0.5秒 (1.3.5版本新增参数)
mescroll.hideTopBtn(time); 隐藏回到顶部的按钮
time: 隐藏的动画时长,默认0.5秒 (1.3.5版本新增参数)
mescroll.setTopBtnFadeDuration(time);
(1.3.5版本新增)
设置回到顶部按钮的显示和隐藏的动画时长
time: 显示隐藏动画时长,默认0.5秒
mescroll.getScrollTop(); 获取滚动条的位置y; 也可以在up配置onScroll监听滚动条的位置
mescroll.getBodyHeight(); 获取body的高度
mescroll.getClientHeight(); 获取滚动容器的高度
mescroll.getScrollHeight(); 获取滚动内容的高度
mescroll.getToBottom();
(v 1.3.0新增)
获取当前滚动条到底部的距离
mescroll.getStep(star, end, callback, t, rate);
(v 1.2.8 新增)
star : 开始值;
end : 结束值;
callback(step,timer) : 回调 function(step,timer),
t : 计步时长; 传0则直接回调end值; 不传则默认300ms ;
rate : 周期; 不传则默认30ms计步一次 ;
此方法相当于默认在300ms内,每30ms返回star到end之间的阶梯值step; 可用于模拟帧动画
比如mescroll的回到顶部缓冲动画,轮播导航案例的顶部菜单滚动都是通过getStep实现
(注: 您可根据实际情况在 callback 通过 window.clearInterval(timer) 提前结束计步器)
mescroll.version;
(v 1.3.0新增)
mescroll的版本号
mescroll.destroy(); 销毁mescroll

基础案例 base demos :

1. 【商品列表】演示下拉刷新重置列表数据

---------- 在线体验 ---------- 查看源码 ----------



2. 【新闻列表】演示下拉刷新添加新数据到列表顶部

---------- 在线体验 ---------- 查看源码 ----------



3. 【单mescroll】演示每次切换菜单都重置列表,不缓存数据

---------- 在线体验 ---------- 查看源码 ----------



4. 【多mescroll】演示每个菜单列表仅初始化一次,切换菜单缓存数据

---------- 在线体验 ---------- 查看源码 ----------



5. 【满屏加载与锁定滑动】演示自动满屏加载,可临时锁定上拉刷新和下拉加载

---------- 在线体验 ---------- 查看源码 ----------



6. 【mescroll所有配置项】源码展示mescroll所有配置项, 快速理解与调试mescroll

---------- 在线体验 ---------- 查看源码 ----------



中级案例 intermediate demos :

1. 【知乎 v3.53.0】APP的下拉刷新上拉加载

---------- 在线体验 ---------- 查看源码 ----------



2. 【新浪微博 v7.6.1】APP的下拉刷新上拉加载

---------- 在线体验 ---------- 查看源码 ----------



3. 【贝贝 v6.0.0】APP的下拉刷新上拉加载

---------- 在线体验 ---------- 查看源码 ----------



4. 【雅布力 v2.4.0】APP的下拉刷新上拉加载

---------- 在线体验 ---------- 查看源码 ----------



5. 【吸顶悬浮效果】

---------- 在线体验 ---------- 查看源码 ----------



6. 【关键词搜索】

---------- 在线体验 ---------- 查看源码 ----------



7. 【轮播切换效果】

---------- 在线体验 ---------- 查看源码 ----------



8. 【轮播导航菜单】

---------- 在线体验 ---------- 查看源码 ----------



高级案例 senior demos :

1. 【淘宝 v6.8.0】APP的下拉刷新上拉加载



2. 【京东 v6.1.0】APP的下拉刷新上拉加载



3. 【美团 v8.2.3】APP的下拉刷新上拉加载



4. 【美囤妈妈 v2.0.5】APP的下拉刷新上拉加载



下载基础中级案例源码 :

mescroll.css mescroll.js mescroll所有基础案例源码 mescroll所有中级案例源码
【立即下载】

获取高级案例源码 :

mescroll高级案例源码 -- 淘宝 v6.8.0
mescroll高级案例源码 -- 京东 v6.1.0
mescroll高级案例源码 -- 美团 v8.2.3
mescroll高级案例源码 -- 美囤妈妈 v2.0.5
【 获取方法一 】
我是大神 , 我为mescroll添砖加瓦
在 GitHub 上 Star 和 Fork 了 mescroll
并提出优化或改进建议,获得了采纳 ~
【 获取方法二 】
我爱分享 , 编写mescroll相关案例
联系 QQ 2260429223 投稿
评审优化后,在mescroll官网展示
源码指向您的GitHub
【 获取方法三 】
我不做伸手党, 打赏任意金额
联系 QQ 2260429223 获取高级案例源码
打赏排行 榜上有名