mescroll.js 52 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155
  1. /*! mescroll -- 精致的下拉刷新和上拉加载js框架 ( a great JS framework for pull-refresh and pull-up-loading )
  2. * version 1.3.8
  3. * 2018-09-29
  4. * author: wenju < mescroll@qq.com > 文举
  5. * *
  6. * 官网: http://www.mescroll.com
  7. * 动态: https://github.com/mescroll/mescroll/releases
  8. * 问答: http://www.mescroll.com/qa.html
  9. * issues: https://github.com/mescroll/mescroll/issues
  10. * QQ交流群: 633126761
  11. */
  12. (function (name, definition) {
  13. if (typeof define === 'function') {
  14. // AMD环境或CMD环境
  15. define(definition);
  16. } else if (typeof module !== 'undefined' && module.exports) {
  17. // 定义为普通Node模块
  18. module.exports = definition();
  19. } else {
  20. // 将模块的执行结果挂在window变量中,在浏览器中this指向window对象
  21. this[name] = definition();
  22. }
  23. })('MeScroll', function () {
  24. var MeScroll = function (mescrollId, options) {
  25. var me = this;
  26. me.version = '1.3.8'; // mescroll版本号
  27. me.isScrollBody = (!mescrollId || mescrollId === 'body'); // 滑动区域是否为body
  28. me.scrollDom = me.isScrollBody ? document.body : me.getDomById(mescrollId); // MeScroll的滑动区域
  29. if (!me.scrollDom) return;
  30. me.options = options || {}; // 配置
  31. var u = navigator.userAgent;
  32. var isIOS = !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/); // 是否为ios设备
  33. var isPC = typeof window.orientation === 'undefined'; // 是否为PC端
  34. var isAndroid = u.indexOf('Android') > -1 || u.indexOf('Adr') > -1;// 是否为android端
  35. me.os = {
  36. ios: isIOS,
  37. pc: isPC,
  38. android: isAndroid
  39. }
  40. me.isDownScrolling = false; // 是否在执行下拉刷新的回调
  41. me.isUpScrolling = false; // 是否在执行上拉加载的回调
  42. var hasDownCallback = me.options.down && me.options.down.callback; // 是否配置了down的callback
  43. // 初始化下拉刷新
  44. me.initDownScroll();
  45. // 初始化上拉加载,则初始化
  46. me.initUpScroll();
  47. // 自动加载
  48. setTimeout(function () { // 待主线程执行完毕再执行,避免new MeScroll未初始化,在回调获取不到mescroll的实例
  49. // 自动触发下拉刷新 (只有配置了down的callback才自动触发下拉刷新)
  50. if (me.optDown.use && me.optDown.auto && hasDownCallback) {
  51. if (me.optDown.autoShowLoading) {
  52. me.triggerDownScroll(); // 显示下拉进度,执行下拉回调
  53. } else {
  54. me.optDown.callback && me.optDown.callback(me); // 不显示下拉进度,直接执行下拉回调
  55. }
  56. }
  57. // 自动触发上拉加载
  58. me.optUp.use && me.optUp.auto && !me.isUpAutoLoad && me.triggerUpScroll();
  59. }, 30); // 需让me.optDown.inited和me.optUp.inited先执行
  60. }
  61. /* 配置参数:下拉刷新 */
  62. MeScroll.prototype.extendDownScroll = function (optDown) {
  63. // 下拉刷新的配置
  64. MeScroll.extend(optDown, {
  65. use: true, // 是否启用下拉刷新; 默认true
  66. auto: true, // 是否在初始化完毕之后自动执行下拉刷新的回调; 默认true
  67. autoShowLoading: false, // 如果设置auto=true(在初始化完毕之后自动执行下拉刷新的回调),那么是否显示下拉刷新的进度; 默认false
  68. isLock: false, // 是否锁定下拉刷新,默认false;
  69. isBoth: false, // 下拉刷新时,如果滑动到列表底部是否可以同时触发上拉加载;默认false,两者不可同时触发;
  70. offset: 80, // 在列表顶部,下拉大于80px,松手即可触发下拉刷新的回调
  71. outOffsetRate: 0.2, // 在列表顶部,下拉的距离大于offset时,改变下拉区域高度比例;值小于1且越接近0,高度变化越小,表现为越往下越难拉
  72. bottomOffset: 20, // 当手指touchmove位置在距离body底部20px范围内的时候结束上拉刷新,避免Webview嵌套导致touchend事件不执行
  73. minAngle: 45, // 向下滑动最少偏移的角度,取值区间 [0,90];默认45度,即向下滑动的角度大于45度则触发下拉;而小于45度,将不触发下拉,避免与左右滑动的轮播等组件冲突;
  74. hardwareClass: 'mescroll-hardware', // 硬件加速样式,解决部分手机闪屏或动画不流畅的问题
  75. mustToTop: false, // 是否滚动条必须在顶部,才可以下拉刷新.默认false. 当您发现下拉刷新会闪白屏时,设置true即可修复.
  76. warpId: null, // 可配置下拉刷新的布局添加到指定id的div;默认不配置,默认添加到mescrollId
  77. warpClass: 'mescroll-downwarp', // 下拉刷新的布局容器样式,参见mescroll.css
  78. resetClass: 'mescroll-downwarp-reset', // 下拉刷新高度重置的动画,参见mescroll.css
  79. textInOffset: '下拉刷新', // 下拉的距离在offset范围内的提示文本
  80. textOutOffset: '释放更新', // 下拉的距离大于offset范围的提示文本
  81. textLoading: '加载中 ...', // 加载中的提示文本
  82. htmlContent: '<p class="downwarp-progress"></p><p class="downwarp-tip"></p>', // 布局内容
  83. inited: function (mescroll, downwarp) {
  84. // 下拉刷新初始化完毕的回调
  85. mescroll.downTipDom = downwarp.getElementsByClassName('downwarp-tip')[0];
  86. mescroll.downProgressDom = downwarp.getElementsByClassName('downwarp-progress')[0];
  87. },
  88. inOffset: function (mescroll) {
  89. // 下拉的距离进入offset范围内那一刻的回调
  90. if (mescroll.downTipDom) mescroll.downTipDom.innerHTML = mescroll.optDown.textInOffset;
  91. if (mescroll.downProgressDom) mescroll.downProgressDom.classList.remove('mescroll-rotate');
  92. },
  93. outOffset: function (mescroll) {
  94. // 下拉的距离大于offset那一刻的回调
  95. if (mescroll.downTipDom) mescroll.downTipDom.innerHTML = mescroll.optDown.textOutOffset;
  96. },
  97. onMoving: function (mescroll, rate, downHight) {
  98. // 下拉过程中的回调,滑动过程一直在执行; rate下拉区域当前高度与指定距离的比值(inOffset: rate<1; outOffset: rate>=1); downHight当前下拉区域的高度
  99. if (mescroll.downProgressDom) {
  100. var progress = 360 * rate;
  101. mescroll.downProgressDom.style.webkitTransform = 'rotate(' + progress + 'deg)';
  102. mescroll.downProgressDom.style.transform = 'rotate(' + progress + 'deg)';
  103. }
  104. },
  105. beforeLoading: function (mescroll, downwarp) {
  106. // 准备触发下拉刷新的回调
  107. return false; // 如果return true,将不触发showLoading和callback回调; 常用来完全自定义下拉刷新, 参考案例【淘宝 v6.8.0】
  108. },
  109. showLoading: function (mescroll) {
  110. // 显示下拉刷新进度的回调
  111. if (mescroll.downTipDom) mescroll.downTipDom.innerHTML = mescroll.optDown.textLoading;
  112. if (mescroll.downProgressDom) mescroll.downProgressDom.classList.add('mescroll-rotate');
  113. },
  114. afterLoading: function (mescroll) {
  115. // 准备结束下拉的回调. 返回结束下拉的延时执行时间,默认0ms; 常用于结束下拉之前再显示另外一小段动画,才去隐藏下拉刷新的场景, 参考案例【dotJump】
  116. return 0
  117. },
  118. callback: function (mescroll) {
  119. // 下拉刷新的回调;默认重置上拉加载列表为第一页
  120. mescroll.resetUpScroll();
  121. }
  122. })
  123. }
  124. /* 配置参数:上拉加载 */
  125. MeScroll.prototype.extendUpScroll = function (optUp) {
  126. // 是否为PC端,如果是scrollbar端,默认自定义滚动条
  127. var isPC = this.os.pc;
  128. // 上拉加载的配置
  129. MeScroll.extend(optUp, {
  130. use: true, // 是否启用上拉加载; 默认true
  131. auto: true, // 是否在初始化完毕之后自动执行上拉加载的回调; 默认true
  132. isLock: false, // 是否锁定上拉加载,默认false;
  133. isBoth: false, // 上拉加载时,如果滑动到列表顶部是否可以同时触发下拉刷新;默认false,两者不可同时触发;
  134. isBounce: true, // 是否允许ios的bounce回弹;默认true,允许; 如果设置为false,则除了mescroll, mescroll-touch, mescroll-touch-x, mescroll-touch-y能够接收touchmove事件,其他部分均无法滑动,能够有效禁止bounce
  135. callback: null, // 上拉加载的回调;function(page,mescroll){ }
  136. page: {
  137. num: 0, // 当前页码,默认0,回调之前会加1,即callback(page)会从1开始
  138. size: 10, // 每页数据的数量
  139. time: null // 加载第一页数据服务器返回的时间; 防止用户翻页时,后台新增了数据从而导致下一页数据重复;
  140. },
  141. noMoreSize: 5, // 如果列表已无数据,可设置列表的总数量要大于等于5条才显示无更多数据;避免列表数据过少(比如只有一条数据),显示无更多数据会不好看
  142. offset: 100, // 列表滚动到距离底部小于100px,即可触发上拉加载的回调
  143. toTop: {
  144. // 回到顶部按钮,需配置src才显示
  145. warpId: null, // 父布局的id; 默认添加在body中
  146. src: null, // 图片路径,默认null;
  147. html: null, // html标签内容,默认null; 如果同时设置了src,则优先取src
  148. offset: 1000, // 列表滚动多少距离才显示回到顶部按钮,默认1000
  149. warpClass: 'mescroll-totop', // 按钮样式,参见mescroll.css
  150. showClass: 'mescroll-fade-in', // 显示样式,参见mescroll.css
  151. hideClass: 'mescroll-fade-out', // 隐藏样式,参见mescroll.css
  152. fadeDuration: 0.5, // 回到顶部按钮的显示隐藏动画时长,默认0.5秒. (注意:showClass和hideClass设置的动画时长不会生效.)
  153. duration: 300, // 回到顶部的动画时长,默认300ms
  154. supportTap: false, // 如果您的运行环境支持tap,则可配置true;
  155. btnClick: null // 点击按钮的回调; 小提示:如果在回调里return true,将不执行回到顶部的操作.
  156. },
  157. loadFull: {
  158. use: false, // 列表数据过少,不足以滑动触发上拉加载,是否自动加载下一页,直到满屏或者无更多数据为止;默认false,因为可通过调高page.size避免这个情况
  159. delay: 500 // 延时执行的毫秒数; 延时是为了保证列表数据或占位的图片都已初始化完成,且下拉刷新上拉加载中区域动画已执行完毕;
  160. },
  161. empty: {
  162. // 列表第一页无任何数据时,显示的空提示布局; 需配置warpId或clearEmptyId才生效;
  163. warpId: null, // 父布局的id; 如果此项有值,将不使用clearEmptyId的值;
  164. icon: null, // 图标路径
  165. tip: '暂无相关数据~', // 提示
  166. btntext: '', // 按钮
  167. btnClick: null, // 点击按钮的回调
  168. supportTap: false // 如果您的运行环境支持tap,则可配置true;
  169. },
  170. clearId: null, // 加载第一页时需清空数据的列表id; 如果此项有值,将不使用clearEmptyId的值;
  171. clearEmptyId: null, // 相当于同时设置了clearId和empty.warpId; 简化写法;默认null; 注意vue中不能配置此项
  172. hardwareClass: 'mescroll-hardware', // 硬件加速样式,使上拉动画流畅
  173. warpId: null, // 可配置上拉加载的布局添加到指定id的div;默认不配置,默认添加到mescrollId
  174. warpClass: 'mescroll-upwarp', // 上拉加载的布局容器样式
  175. htmlLoading: '<p class="upwarp-progress mescroll-rotate"></p><p class="upwarp-tip">加载中..</p>', // 上拉加载中的布局
  176. htmlNodata: '<p class="upwarp-nodata">-- END --</p>', // 无数据的布局
  177. inited: function (mescroll, upwarp) {
  178. // 初始化完毕的回调,可缓存dom 比如 mescroll.upProgressDom = upwarp.getElementsByClassName("upwarp-progress")[0];
  179. },
  180. showLoading: function (mescroll, upwarp) {
  181. // 上拉加载中.. mescroll.upProgressDom.style.display = "block" 不通过此方式显示,因为ios快速滑动到底部,进度条会无法及时渲染
  182. upwarp.innerHTML = mescroll.optUp.htmlLoading;
  183. },
  184. showNoMore: function (mescroll, upwarp) {
  185. // 无更多数据
  186. upwarp.innerHTML = mescroll.optUp.htmlNodata;
  187. },
  188. onScroll: null, // 列表滑动监听,默认null; 例如 onScroll: function(mescroll, y, isUp){ }; //y为列表当前滚动条的位置; isUp=true向上滑,isUp=false向下滑
  189. scrollbar: {
  190. use: isPC, // 默认只在PC端自定义滚动条样式
  191. barClass: 'mescroll-bar'
  192. },
  193. lazyLoad: {
  194. use: false, // 是否开启懒加载,默认false
  195. attr: 'imgurl', // 网络图片地址的属性名 (图片加载成功会自动移除改属性): <img imgurl='网络图 src='占位图''/>
  196. showClass: 'mescroll-lazy-in', // 显示样式,参见mescroll.css
  197. delay: 500, // 列表滚动的过程中每500ms检查一次图片是否在可视区域,如果在可视区域则加载图片
  198. offset: 200 // 超出可视区域200px的图片仍可触发懒加载,目的是提前加载部分图片
  199. }
  200. })
  201. }
  202. /* 配置参数 */
  203. MeScroll.extend = function (userOption, defaultOption) {
  204. if (!userOption) return defaultOption;
  205. for (var key in defaultOption) {
  206. if (userOption[key] == null) {
  207. userOption[key] = defaultOption[key];
  208. } else if (typeof userOption[key] === 'object') {
  209. MeScroll.extend(userOption[key], defaultOption[key]); // 深度匹配
  210. }
  211. }
  212. return userOption;
  213. }
  214. /* -------初始化下拉刷新------- */
  215. MeScroll.prototype.initDownScroll = function () {
  216. var me = this;
  217. // 配置参数
  218. me.optDown = me.options.down || {};
  219. // 具体参数配置
  220. me.extendDownScroll(me.optDown);
  221. // 鼠标或手指的按下事件
  222. me.touchstartEvent = function (e) {
  223. if (me.isScrollTo) me.preventDefault(e); // 如果列表执行滑动事件,则阻止事件,优先执行scrollTo方法
  224. me.startPoint = me.getPoint(e); // 记录起点
  225. me.lastPoint = me.startPoint; // 重置上次move的点
  226. me.maxTouchmoveY = me.getBodyHeight() - me.optDown.bottomOffset; // 手指触摸的最大范围(写在touchstart避免body获取高度为0的情况)
  227. me.inTouchend = false; // 标记不是touchend
  228. var scrollTop = me.getScrollTop();// 滚动条的位置
  229. me.isKeepTop = scrollTop === 0; // 标记滚动条起点为0
  230. if (me.os.pc && scrollTop <= 0) {
  231. // 在顶部给PC端添加move事件
  232. me.scrollDom.addEventListener('mousemove', me.touchmoveEvent, {
  233. passive: false
  234. });
  235. document.ondragstart = function () { // 在顶部禁止PC端拖拽图片,避免与下拉刷新冲突
  236. return false;
  237. }
  238. }
  239. }
  240. me.scrollDom.addEventListener('mousedown', me.touchstartEvent); // PC端鼠标事件
  241. me.scrollDom.addEventListener('touchstart', me.touchstartEvent); // 移动端手指事件
  242. // 鼠标或手指的滑动事件
  243. me.touchmoveEvent = function (e) {
  244. if (!me.startPoint) return;
  245. var scrollTop = me.getScrollTop(); // 当前滚动条的距离
  246. if (scrollTop > 0) me.isKeepTop = false; // 在移动过程中,只要滚动条有一次大于0,则标记false
  247. var curPoint = me.getPoint(e); // 当前点
  248. var moveY = curPoint.y - me.startPoint.y; // 和起点比,移动的距离,大于0向下拉,小于0向上拉
  249. // 向下拉
  250. if (moveY > 0) {
  251. // 在顶部
  252. if (scrollTop <= 0) {
  253. me.preventDefault(e); // 阻止浏览器默认的滚动,避免触发bounce
  254. // 可下拉的条件
  255. if (me.optDown.use && !me.inTouchend && !me.isDownScrolling && !me.optDown.isLock && (!me.isUpScrolling || (me.isUpScrolling && me.optUp.isBoth))) {
  256. if (me.optDown.mustToTop && !me.isKeepTop) return; // 是否配置了必须在顶部才可以下拉
  257. // 下拉的角度是否在配置的范围内
  258. var x = Math.abs(me.lastPoint.x - curPoint.x);
  259. var y = Math.abs(me.lastPoint.y - curPoint.y);
  260. var z = Math.sqrt(x * x + y * y);
  261. if (z !== 0) {
  262. var angle = Math.asin(y / z) / Math.PI * 180; // 两点之间的角度,区间 [0,90]
  263. if (angle < me.optDown.minAngle) return; // 如果小于配置的角度,则不往下执行下拉刷新
  264. }
  265. // 如果手指的位置超过配置的距离,则提前结束下拉,避免Webview嵌套导致touchend无法触发
  266. if (me.maxTouchmoveY > 0 && curPoint.y >= me.maxTouchmoveY) {
  267. me.inTouchend = true; // 标记执行touchend
  268. me.touchendEvent(); // 提前触发touchend
  269. return;
  270. }
  271. var diff = curPoint.y - me.lastPoint.y; // 和上次比,移动的距离 (大于0向下,小于0向上)
  272. if (!me.downHight) me.downHight = 0; // 下拉区域的高度
  273. // 下拉距离 < 指定距离
  274. if (me.downHight < me.optDown.offset) {
  275. if (me.movetype !== 1) {
  276. me.movetype = 1; // 加入标记,保证只执行一次
  277. me.optDown.inOffset(me); // 进入指定距离范围内那一刻的回调,只执行一次
  278. me.downwarp.classList.remove(me.optDown.resetClass); // 移除高度重置的动画
  279. me.isMoveDown = true; // 标记下拉区域高度改变,在touchend重置回来
  280. if (me.os.ios && !me.isKeepTop) { // 下拉过程中,滚动条一直在顶部的,则不必取消回弹,否则会闪白屏
  281. me.scrollDom.classList.add(me.optDown.hardwareClass); // 开启硬件加速,解决iOS下拉因隐藏进度条而闪屏的问题
  282. me.scrollDom.style.webkitOverflowScrolling = 'auto'; // 取消列表回弹效果,避免与下面me.downwarp.style.height混合,而导致界面抖动闪屏
  283. me.isSetScrollAuto = true; // 标记设置了webkitOverflowScrolling为auto
  284. }
  285. }
  286. me.downHight += diff;
  287. // 指定距离 <= 下拉距离
  288. } else {
  289. if (me.movetype !== 2) {
  290. me.movetype = 2; // 加入标记,保证只执行一次
  291. me.optDown.outOffset(me); // 下拉超过指定距离那一刻的回调,只执行一次
  292. me.downwarp.classList.remove(me.optDown.resetClass); // 移除高度重置的动画
  293. me.isMoveDown = true; // 标记下拉区域高度改变,在touchend重置回来
  294. if (me.os.ios && !me.isKeepTop) { // 下拉过程中,滚动条一直在顶部的,则不必取消回弹,否则会闪白屏
  295. me.scrollDom.classList.add(me.optDown.hardwareClass); // 开启硬件加速,解决iOS下拉因隐藏进度条而闪屏的问题
  296. me.scrollDom.style.webkitOverflowScrolling = 'auto'; // 取消列表回弹效果,避免与下面me.downwarp.style.height混合,而导致界面抖动闪屏
  297. me.isSetScrollAuto = true; // 标记设置了webkitOverflowScrolling为auto
  298. }
  299. }
  300. if (diff > 0) { // 向下拉
  301. me.downHight += diff * me.optDown.outOffsetRate; // 越往下,高度变化越小
  302. } else { // 向上收
  303. me.downHight += diff; // 向上收回高度,则向上滑多少收多少高度
  304. }
  305. }
  306. me.downwarp.style.height = me.downHight + 'px'; // 实时更新下拉区域高度
  307. var rate = me.downHight / me.optDown.offset; // 下拉区域当前高度与指定距离的比值
  308. me.optDown.onMoving(me, rate, me.downHight); // 下拉过程中的回调,一直在执行
  309. }
  310. }
  311. // 向上拉
  312. } else if (moveY < 0) {
  313. var scrollHeight = me.getScrollHeight(); // 滚动内容的高度
  314. var clientHeight = me.getClientHeight(); // 滚动容器的高度
  315. var toBottom = scrollHeight - clientHeight - scrollTop; // 滚动条距离底部的距离
  316. // 如果在底部,则阻止浏览器默认事件
  317. if (!me.optUp.isBounce && toBottom <= 0) me.preventDefault(e);
  318. // 如果不满屏或者已经在底部,无法触发scroll事件,此时需主动触发上拉回调
  319. if (me.optUp.use && !me.optUp.isLock && me.optUp.hasNext && !me.isUpScrolling && (!me.isDownScrolling || (me.isDownScrolling && me.optDown.isBoth)) && (clientHeight + me.optUp.offset >= scrollHeight || toBottom <= 0)) {
  320. me.triggerUpScroll();
  321. }
  322. }
  323. me.lastPoint = curPoint; // 记录本次移动的点
  324. }
  325. // 移动端手指的滑动事件
  326. me.scrollDom.addEventListener('touchmove', me.touchmoveEvent, {
  327. passive: false
  328. });
  329. // 鼠标或手指的离开事件
  330. me.touchendEvent = function () {
  331. // 如果下拉区域高度已改变,则需重置回来
  332. if (me.optDown.use && me.isMoveDown) {
  333. if (me.downHight >= me.optDown.offset) {
  334. // 符合触发刷新的条件
  335. me.triggerDownScroll();
  336. } else {
  337. // 不符合的话 则重置
  338. me.downwarp.classList.add(me.optDown.resetClass); // 加入高度重置的动画,过渡平滑
  339. me.downHight = 0;
  340. me.downwarp.style.height = 0;
  341. }
  342. if (me.isSetScrollAuto) {
  343. me.scrollDom.style.webkitOverflowScrolling = 'touch';
  344. me.scrollDom.classList.remove(me.optDown.hardwareClass);
  345. me.isSetScrollAuto = false;
  346. }
  347. me.movetype = 0;
  348. me.isMoveDown = false;
  349. }
  350. if (me.os.pc) {
  351. me.scrollDom.removeEventListener('mousemove', me.touchmoveEvent); // 移除pc端的move事件
  352. document.ondragstart = function () { // 解除PC端禁止拖拽图片
  353. return true;
  354. }
  355. }
  356. }
  357. me.scrollDom.addEventListener('mouseup', me.touchendEvent); // PC端鼠标抬起事件
  358. me.scrollDom.addEventListener('mouseleave', me.touchendEvent); // PC端鼠标离开事件
  359. me.scrollDom.addEventListener('touchend', me.touchendEvent); // 移动端手指事件
  360. me.scrollDom.addEventListener('touchcancel', me.touchendEvent); // 移动端系统停止跟踪触摸
  361. // 在页面中加入下拉布局
  362. if (me.optDown.use) {
  363. me.downwarp = document.createElement('div');
  364. me.downwarp.className = me.optDown.warpClass;
  365. me.downwarp.innerHTML = '<div class="downwarp-content">' + me.optDown.htmlContent + '</div>';
  366. var downparent = me.optDown.warpId ? me.getDomById(me.optDown.warpId) : me.scrollDom;
  367. if (me.optDown.warpId && downparent) {
  368. downparent.appendChild(me.downwarp);
  369. } else {
  370. if (!downparent) downparent = me.scrollDom;
  371. downparent.insertBefore(me.downwarp, me.scrollDom.firstChild);
  372. }
  373. // 初始化完毕的回调
  374. setTimeout(function () { // 待主线程执行完毕再执行,避免new MeScroll未初始化,在回调获取不到mescroll的实例
  375. me.optDown.inited(me, me.downwarp);
  376. }, 0)
  377. }
  378. }
  379. /* 阻止浏览器默认滚动事件 */
  380. MeScroll.prototype.preventDefault = function (e) {
  381. // cancelable:是否可以被禁用; defaultPrevented:是否已经被禁用
  382. if (e && e.cancelable && !e.defaultPrevented) e.preventDefault()
  383. }
  384. /* 根据点击滑动事件获取第一个手指的坐标 */
  385. MeScroll.prototype.getPoint = function (e) {
  386. return {
  387. x: e.touches ? e.touches[0].pageX : e.clientX,
  388. y: e.touches ? e.touches[0].pageY : e.clientY
  389. }
  390. }
  391. /* 触发下拉刷新 */
  392. MeScroll.prototype.triggerDownScroll = function () {
  393. if (!this.optDown.beforeLoading(this, this.downwarp)) { // 准备触发下拉的回调,return true则处于完全自定义状态;默认return false;
  394. this.showDownScroll(); // 下拉刷新中...
  395. this.optDown.callback && this.optDown.callback(this); // 执行回调,联网加载数据
  396. }
  397. }
  398. /* 显示下拉进度布局 */
  399. MeScroll.prototype.showDownScroll = function () {
  400. this.isDownScrolling = true; // 标记下拉中
  401. this.optDown.showLoading(this); // 下拉刷新中...
  402. this.downHight = this.optDown.offset; // 更新下拉区域高度
  403. this.downwarp.classList.add(this.optDown.resetClass); // 加入高度重置的动画,过渡平滑
  404. this.downwarp.style.height = this.optDown.offset + 'px'; // 调整下拉区域高度
  405. }
  406. /* 结束下拉刷新 */
  407. MeScroll.prototype.endDownScroll = function () {
  408. var me = this;
  409. // 结束下拉刷新的方法
  410. var endScroll = function () {
  411. me.downHight = 0;
  412. me.downwarp.style.height = 0;
  413. me.isDownScrolling = false;
  414. if (me.downProgressDom) me.downProgressDom.classList.remove('mescroll-rotate');
  415. }
  416. // 结束下拉刷新时的回调
  417. var delay = me.optDown.afterLoading(me); // 结束下拉刷新的延时,单位ms
  418. if (typeof delay === 'number' && delay > 0) {
  419. setTimeout(endScroll, delay);
  420. } else {
  421. endScroll();
  422. }
  423. }
  424. /* 锁定下拉刷新:isLock=ture,null锁定;isLock=false解锁 */
  425. MeScroll.prototype.lockDownScroll = function (isLock) {
  426. if (isLock == null) isLock = true;
  427. this.optDown.isLock = isLock;
  428. }
  429. /* -------初始化上拉加载------- */
  430. MeScroll.prototype.initUpScroll = function () {
  431. var me = this;
  432. // 配置参数
  433. me.optUp = me.options.up || {
  434. use: false
  435. };
  436. // 具体参数配置
  437. me.extendUpScroll(me.optUp);
  438. // 自定义滚动条 (默认只在PC端设置)
  439. if (me.optUp.scrollbar.use) me.scrollDom.classList.add(me.optUp.scrollbar.barClass);
  440. // 不允许ios的bounce时,需禁止webview的touchmove事件
  441. if (!me.optUp.isBounce) me.setBounce(false);
  442. if (me.optUp.use === false) return; // 配置不使用上拉加载时,则不初始化上拉布局
  443. me.optUp.hasNext = true; // 如果使用上拉,则默认有下一页
  444. // 在页面中加入上拉布局
  445. me.upwarp = document.createElement('div');
  446. me.upwarp.className = me.optUp.warpClass;
  447. var upparent;
  448. if (me.optUp.warpId) upparent = me.getDomById(me.optUp.warpId);
  449. if (!upparent) upparent = me.scrollDom;
  450. upparent.appendChild(me.upwarp);
  451. // 滚动监听
  452. me.preScrollY = 0;
  453. me.lazyStartTime = new Date().getTime();// 懒加载的初始间隔时间
  454. me.lazyTag = 'mescroll-lazying';// 懒加载时,图片正在加载的标记
  455. me.scrollEvent = function () {
  456. // 列表内容顶部卷去的高度(含列表边框)
  457. var scrollTop = me.getScrollTop();
  458. // 向上滑还是向下滑动
  459. var isUp = scrollTop - me.preScrollY > 0;
  460. me.preScrollY = scrollTop;
  461. // 如果没有在加载中
  462. if (!me.isUpScrolling && (!me.isDownScrolling || (me.isDownScrolling && me.optDown.isBoth))) {
  463. // offsetheight 列表高度(内容+内边距+边框),滚动条在边框之内,所以使用clientHeight即可
  464. // clientHeight 列表高度(内容+内边距),不含列表边框
  465. // scrollHeight 列表内容撑开的高度
  466. if (!me.optUp.isLock && me.optUp.hasNext) {
  467. var toBottom = me.getScrollHeight() - me.getClientHeight() - scrollTop; // 滚动条距离底部的距离
  468. if (toBottom <= me.optUp.offset && isUp) {
  469. // 如果滚动条距离底部指定范围内且向上滑,则执行上拉加载回调
  470. me.triggerUpScroll();
  471. }
  472. }
  473. }
  474. // 顶部按钮的显示隐藏
  475. var optTop = me.optUp.toTop;
  476. if (optTop.src || optTop.html) {
  477. if (scrollTop >= optTop.offset) {
  478. me.showTopBtn();
  479. } else {
  480. me.hideTopBtn();
  481. }
  482. }
  483. // 懒加载
  484. if (me.optUp.lazyLoad.use) {
  485. // 节流:限制触发时间间隔
  486. var curTime = new Date().getTime();
  487. me.lazyTimer && clearTimeout(me.lazyTimer);
  488. if (curTime - me.lazyStartTime >= me.optUp.lazyLoad.delay) {
  489. me.lazyStartTime = curTime;
  490. me.lazyLoad(0);// 列表刚滚动的时候,懒加载一次
  491. } else {
  492. me.lazyTimer = me.lazyLoad();
  493. }
  494. }
  495. // 滑动监听
  496. me.optUp.onScroll && me.optUp.onScroll(me, scrollTop, isUp);
  497. }
  498. if (me.isScrollBody) {
  499. window.addEventListener('scroll', me.scrollEvent);
  500. } else {
  501. me.scrollDom.addEventListener('scroll', me.scrollEvent);
  502. }
  503. // 初始化完毕的回调
  504. setTimeout(function () { // 待主线程执行完毕再执行,避免new MeScroll未初始化,在回调获取不到mescroll的实例
  505. me.optUp.inited(me, me.upwarp);
  506. }, 0)
  507. }
  508. /* 是否允许ios的Bounce; true或null为允许; false禁止bounce */
  509. MeScroll.prototype.setBounce = function (isBounce) {
  510. if (this.isScrollBody || !this.os.ios) return; // 不支持body为滚动区域和非ios设备
  511. if (isBounce === false) {
  512. this.optUp.isBounce = false; // 禁止
  513. window.addEventListener('touchmove', this.bounceTouchmove, {
  514. passive: false
  515. });
  516. } else {
  517. this.optUp.isBounce = true; // 允许
  518. window.removeEventListener('touchmove', this.bounceTouchmove);
  519. }
  520. }
  521. /* 处理bounce的touchmove事件 */
  522. MeScroll.prototype.bounceTouchmove = function (e) {
  523. var me = this;
  524. var el = e.target;
  525. // 当前touch的元素及父元素是否要拦截touchmove事件
  526. var isPrevent = true;
  527. while (el !== document.body && el !== document) {
  528. var cls = el.classList;
  529. if (cls) {
  530. if (cls.contains('mescroll') || cls.contains('mescroll-touch')) {
  531. isPrevent = false; // 如果是指定条件的元素,则无需拦截touchmove事件
  532. break;
  533. } else if (cls.contains('mescroll-touch-x') || cls.contains('mescroll-touch-y')) {
  534. // 如果配置了水平或者垂直滑动
  535. var curX = e.touches ? e.touches[0].pageX : e.clientX; // 当前第一个手指距离列表顶部的距离x
  536. var curY = e.touches ? e.touches[0].pageY : e.clientY; // 当前第一个手指距离列表顶部的距离y
  537. if (!me.preWinX) me.preWinX = curX; // 设置上次移动的距离x
  538. if (!me.preWinY) me.preWinY = curY; // 设置上次移动的距离y
  539. // 计算两点之间的角度
  540. var x = Math.abs(me.preWinX - curX);
  541. var y = Math.abs(me.preWinY - curY);
  542. var z = Math.sqrt(x * x + y * y);
  543. me.preWinX = curX; // 记录本次curX的值
  544. me.preWinY = curY; // 记录本次curY的值
  545. if (z !== 0) {
  546. var angle = Math.asin(y / z) / Math.PI * 180; // 角度区间 [0,90]
  547. if ((angle <= 45 && cls.contains('mescroll-touch-x')) || (angle > 45 && cls.contains('mescroll-touch-y'))) {
  548. isPrevent = false; // 水平滑动或者垂直滑动,不拦截touchmove事件
  549. break;
  550. }
  551. }
  552. }
  553. }
  554. el = el.parentNode; // 继续检查其父元素
  555. }
  556. // 拦截touchmove事件:是否可以被禁用&&是否已经被禁用 (这里不使用me.preventDefault(e)的方法,因为某些情况下会报找不到方法的异常)
  557. if (isPrevent && e.cancelable && !e.defaultPrevented) e.preventDefault();
  558. }
  559. /* 触发上拉加载 */
  560. MeScroll.prototype.triggerUpScroll = function () {
  561. if (this.optUp.callback && !this.isUpScrolling) {
  562. this.showUpScroll(); // 上拉加载中...
  563. this.optUp.page.num++; // 预先加一页,如果失败则减回
  564. this.isUpAutoLoad = true; // 标记上拉已经自动执行过,避免初始化时多次触发上拉回调
  565. this.optUp.callback(this.optUp.page, this); // 执行回调,联网加载数据
  566. }
  567. }
  568. /* 显示上拉加载中 */
  569. MeScroll.prototype.showUpScroll = function () {
  570. this.isUpScrolling = true; // 标记上拉加载中
  571. this.upwarp.classList.add(this.optUp.hardwareClass); // 添加硬件加速样式,使动画更流畅
  572. this.upwarp.style.visibility = 'visible'; // 显示上拉加载区域
  573. this.upwarp.style.display = 'block'; // 显示上拉加载区域
  574. this.optUp.showLoading(this, this.upwarp); // 加载中...
  575. }
  576. /* 显示上拉无更多数据 */
  577. MeScroll.prototype.showNoMore = function () {
  578. this.upwarp.style.visibility = 'visible'; // 显示上拉加载区域
  579. this.upwarp.style.display = 'block'; // 显示上拉加载区域
  580. this.optUp.hasNext = false; // 无更多数据
  581. this.optUp.showNoMore(this, this.upwarp); // 无更多数据
  582. }
  583. /* 隐藏上拉区域. displayAble: 是否通过display:none隐藏, 默认false通过visibility:hidden的方式隐藏**/
  584. MeScroll.prototype.hideUpScroll = function (displayAble) {
  585. if (displayAble) {
  586. this.upwarp.style.display = 'none'; // 通过display:none隐藏: 优点隐藏后不占位,缺点列表快速滑动到底部不能及时显示加载中
  587. } else {
  588. this.upwarp.style.visibility = 'hidden'; // 通过visibility:hidden的方式隐藏,优点当列表快速滑动到底部能及时显示加载中,缺点隐藏后会占位
  589. }
  590. this.upwarp.classList.remove(this.optUp.hardwareClass); // 移除硬件加速样式
  591. var upProgressDom = this.upwarp.getElementsByClassName('upwarp-progress')[0];
  592. if (upProgressDom) upProgressDom.classList.remove('mescroll-rotate');
  593. }
  594. /* 结束上拉加载 */
  595. MeScroll.prototype.endUpScroll = function (isShowNoMore, displayAble) {
  596. if (isShowNoMore != null) { // isShowNoMore=null,不处理下拉状态,下拉刷新的时候调用
  597. if (isShowNoMore) {
  598. this.showNoMore(); // isShowNoMore=true,显示无更多数据
  599. } else {
  600. this.hideUpScroll(displayAble); // isShowNoMore=false,隐藏上拉加载
  601. }
  602. }
  603. this.isUpScrolling = false; // 标记结束上拉加载
  604. }
  605. /* 重置上拉加载列表为第一页
  606. *isShowLoading 是否显示进度布局;
  607. * 1.默认null,不传参,则显示上拉加载的进度布局
  608. * 2.传参true, 则显示下拉刷新的进度布局
  609. * 3.传参false,则不显示上拉和下拉的进度 (常用于静默更新列表数据)
  610. */
  611. MeScroll.prototype.resetUpScroll = function (isShowLoading) {
  612. if (this.optUp && this.optUp.use) {
  613. var page = this.optUp.page;
  614. this.prePageNum = page.num; // 缓存重置前的页码,加载失败可退回
  615. this.prePageTime = page.time; // 缓存重置前的时间,加载失败可退回
  616. page.num = 1; // 重置为第一页
  617. page.time = null; // 重置时间为空
  618. if (!this.isDownScrolling && isShowLoading !== false) { // 如果不是下拉刷新触发的resetUpScroll并且不配置列表静默更新,则显示进度;
  619. if (isShowLoading == null) {
  620. this.removeEmpty(); // 移除空布局
  621. this.clearDataList(); // 先清空列表数据,才能显示到上拉加载的布局
  622. this.showUpScroll(); // 不传参,默认显示上拉加载的进度布局
  623. } else {
  624. this.showDownScroll(); // 传true,显示下拉刷新的进度布局,不清空列表
  625. }
  626. }
  627. this.isUpAutoLoad = true; // 标记上拉已经自动执行过,避免初始化时多次触发上拉回调
  628. this.optUp.callback && this.optUp.callback(page, this); // 执行上拉回调
  629. }
  630. }
  631. /* 设置page.num的值 */
  632. MeScroll.prototype.setPageNum = function (num) {
  633. this.optUp.page.num = num - 1;
  634. }
  635. /* 设置page.size的值 */
  636. MeScroll.prototype.setPageSize = function (size) {
  637. this.optUp.page.size = size;
  638. }
  639. /* 清空上拉加载的数据列表 */
  640. MeScroll.prototype.clearDataList = function () {
  641. var listId = this.optUp.clearId || this.optUp.clearEmptyId; // 优先使用clearId
  642. if (listId) {
  643. var listDom = this.getDomById(listId);
  644. if (listDom) listDom.innerHTML = '';
  645. }
  646. }
  647. /* 联网回调成功,结束下拉刷新和上拉加载
  648. * dataSize: 当前页的数据量(必传)
  649. * totalPage: 总页数(必传)
  650. * systime: 服务器时间 (可空)
  651. */
  652. MeScroll.prototype.endByPage = function (dataSize, totalPage, systime) {
  653. var hasNext;
  654. if (this.optUp.use && totalPage != null) hasNext = this.optUp.page.num < totalPage; // 是否还有下一页
  655. this.endSuccess(dataSize, hasNext, systime);
  656. }
  657. /* 联网回调成功,结束下拉刷新和上拉加载
  658. * dataSize: 当前页的数据量(必传)
  659. * totalSize: 列表所有数据总数量(必传)
  660. * systime: 服务器时间 (可空)
  661. */
  662. MeScroll.prototype.endBySize = function (dataSize, totalSize, systime) {
  663. var hasNext;
  664. if (this.optUp.use && totalSize != null) {
  665. var loadSize = (this.optUp.page.num - 1) * this.optUp.page.size + dataSize; // 已加载的数据总数
  666. hasNext = loadSize < totalSize; // 是否还有下一页
  667. }
  668. this.endSuccess(dataSize, hasNext, systime);
  669. }
  670. /* 联网回调成功,结束下拉刷新和上拉加载
  671. * dataSize: 当前页的数据个数(不是所有页的数据总和),用于上拉加载判断是否还有下一页.如果不传,则会判断还有下一页
  672. * hasNext: 是否还有下一页,布尔类型;用来解决这个小问题:比如列表共有20条数据,每页加载10条,共2页.如果只根据dataSize判断,则需翻到第三页才会知道无更多数据,如果传了hasNext,则翻到第二页即可显示无更多数据.
  673. * systime: 服务器时间(可空);用来解决这个小问题:当准备翻下一页时,数据库新增了几条记录,此时翻下一页,前面的几条数据会和上一页的重复;这里传入了systime,那么upCallback的page.time就会有值,把page.time传给服务器,让后台过滤新加入的那几条记录
  674. */
  675. MeScroll.prototype.endSuccess = function (dataSize, hasNext, systime) {
  676. var me = this;
  677. // 结束下拉刷新
  678. if (me.isDownScrolling) me.endDownScroll();
  679. // 结束上拉加载
  680. if (me.optUp.use) {
  681. var isShowNoMore; // 是否已无更多数据
  682. if (dataSize != null) {
  683. var pageNum = me.optUp.page.num; // 当前页码
  684. var pageSize = me.optUp.page.size; // 每页长度
  685. // 如果是第一页
  686. if (pageNum === 1) {
  687. me.clearDataList(); // 自动清空第一页列表数据
  688. if (systime) me.optUp.page.time = systime; // 设置加载列表数据第一页的时间
  689. }
  690. if (dataSize < pageSize || hasNext === false) {
  691. // 返回的数据不满一页时,则说明已无更多数据
  692. me.optUp.hasNext = false;
  693. if (dataSize === 0 && pageNum === 1) {
  694. // 如果第一页无任何数据且配置了空布局
  695. isShowNoMore = false;
  696. me.showEmpty();
  697. } else {
  698. // 总列表数少于配置的数量,则不显示无更多数据
  699. var allDataSize = (pageNum - 1) * pageSize + dataSize;
  700. if (allDataSize < me.optUp.noMoreSize) {
  701. isShowNoMore = false;
  702. } else {
  703. isShowNoMore = true;
  704. }
  705. me.removeEmpty(); // 移除空布局
  706. }
  707. } else {
  708. // 还有下一页
  709. isShowNoMore = false;
  710. me.optUp.hasNext = true;
  711. me.removeEmpty(); // 移除空布局
  712. }
  713. }
  714. // 隐藏上拉
  715. var displayAble = !me.optUp.hasNext; // 没有下一页且少于noMoreSize,则以display:none的方式隐藏上拉布局
  716. me.endUpScroll(isShowNoMore, displayAble);
  717. // 检查是否满屏自动加载下一页
  718. me.loadFull();
  719. // 懒加载
  720. me.optUp.lazyLoad.use && me.lazyLoad();
  721. }
  722. }
  723. /* 回调失败,结束下拉刷新和上拉加载 */
  724. MeScroll.prototype.endErr = function () {
  725. // 结束下拉,回调失败重置回原来的页码和时间
  726. if (this.isDownScrolling) {
  727. var page = this.optUp.page;
  728. if (page && this.prePageNum) {
  729. page.num = this.prePageNum;
  730. page.time = this.prePageTime;
  731. }
  732. this.endDownScroll();
  733. }
  734. // 结束上拉,回调失败重置回原来的页码
  735. if (this.isUpScrolling) {
  736. this.optUp.page.num--;
  737. this.endUpScroll(false);
  738. }
  739. }
  740. /* 检查如果加载的数据过少,无法触发上拉加载时,则自动加载下一页,直到满屏或者没有更多数据
  741. 此方法最好在列表的数据加载完成之后调用,以便计算列表内容高度的准确性 */
  742. MeScroll.prototype.loadFull = function () {
  743. var me = this;
  744. if (me.optUp.loadFull.use && !me.optUp.isLock && me.optUp.hasNext && me.optUp.callback && me.getScrollHeight() <= me.getClientHeight()) {
  745. setTimeout(function () {
  746. // 延时之后,还需再判断一下高度,因为可能有些图片在延时期间加载完毕撑开高度
  747. if (me.getScrollHeight() <= me.getClientHeight()) me.triggerUpScroll();
  748. }, me.optUp.loadFull.delay)
  749. }
  750. }
  751. /* 锁定上拉加载:isLock=ture,null锁定;isLock=false解锁 */
  752. MeScroll.prototype.lockUpScroll = function (isLock) {
  753. if (isLock == null) isLock = true;
  754. this.optUp.isLock = isLock;
  755. }
  756. /* --------无任何数据的空布局-------- */
  757. MeScroll.prototype.showEmpty = function () {
  758. var me = this;
  759. var optEmpty = me.optUp.empty; // 空布局的配置
  760. var warpId = optEmpty.warpId || me.optUp.clearEmptyId; // 优先使用warpId
  761. if (warpId == null) return;
  762. var emptyWarp = me.getDomById(warpId) // 要显示空布局的位置
  763. if (emptyWarp) {
  764. me.removeEmpty(); // 先移除,避免重复加入
  765. // 初始化无任何数据的空布局
  766. var str = '';
  767. if (optEmpty.icon) str += '<img class="empty-icon" src="' + optEmpty.icon + '"/>'; // 图标
  768. if (optEmpty.tip) str += '<p class="empty-tip">' + optEmpty.tip + '</p>'; // 提示
  769. if (optEmpty.btntext) str += '<p class="empty-btn">' + optEmpty.btntext + '</p>'; // 按钮
  770. me.emptyDom = document.createElement('div');
  771. me.emptyDom.className = 'mescroll-empty';
  772. me.emptyDom.innerHTML = str;
  773. emptyWarp.appendChild(me.emptyDom);
  774. if (optEmpty.btnClick) { // 点击按钮的回调
  775. var emptyBtn = me.emptyDom.getElementsByClassName('empty-btn')[0];
  776. if (optEmpty.supportTap) {
  777. emptyBtn.addEventListener('tap', function (e) {
  778. e.stopPropagation();
  779. me.preventDefault(e)
  780. optEmpty.btnClick();
  781. })
  782. } else {
  783. emptyBtn.onclick = function () {
  784. optEmpty.btnClick();
  785. }
  786. }
  787. }
  788. }
  789. }
  790. /* 移除空布局 */
  791. MeScroll.prototype.removeEmpty = function () {
  792. this.removeChild(this.emptyDom);
  793. }
  794. /* --------回到顶部的按钮-------- */
  795. MeScroll.prototype.showTopBtn = function (fadeDuration) {
  796. if (!this.topBtnShow) {
  797. this.topBtnShow = true; // 标记显示
  798. var me = this;
  799. var optTop = me.optUp.toTop; // 回到顶部的配置
  800. if (me.toTopBtn == null) {
  801. // 未加入按钮,则加入
  802. if (optTop.html) {
  803. me.toTopBtn = document.createElement('div');
  804. me.toTopBtn.innerHTML = optTop.html;
  805. } else {
  806. me.toTopBtn = document.createElement('img');
  807. me.toTopBtn.src = optTop.src;
  808. }
  809. me.toTopBtn.className = optTop.warpClass;
  810. if (optTop.supportTap) {
  811. me.toTopBtn.addEventListener('tap', function (e) {
  812. e.stopPropagation();
  813. me.preventDefault(e);
  814. var disToTop = optTop.btnClick && optTop.btnClick(); // 执行回调
  815. if (disToTop !== true) { // 如果回调里return true,将不执行回到顶部操作
  816. me.scrollTo(0, me.optUp.toTop.duration); // 置顶
  817. }
  818. })
  819. } else {
  820. me.toTopBtn.onclick = function () {
  821. var disToTop = optTop.btnClick && optTop.btnClick(); // 执行回调
  822. if (disToTop !== true) { // 如果回调里return true,将不执行回到顶部操作
  823. me.scrollTo(0, me.optUp.toTop.duration); // 置顶
  824. }
  825. }
  826. }
  827. var warpDom; // 是否配置父布局
  828. if (optTop.warpId) warpDom = me.getDomById(optTop.warpId);
  829. if (!warpDom) warpDom = document.body;
  830. warpDom.appendChild(me.toTopBtn);
  831. }
  832. // 显示--淡入动画
  833. me.toTopBtn.classList.remove(optTop.hideClass);
  834. me.toTopBtn.classList.add(optTop.showClass);
  835. me.setTopBtnFadeDuration(fadeDuration);
  836. }
  837. }
  838. /* 隐藏回到顶部的按钮 */
  839. MeScroll.prototype.hideTopBtn = function (fadeDuration) {
  840. if (this.topBtnShow && this.toTopBtn) {
  841. this.topBtnShow = false;
  842. this.toTopBtn.classList.remove(this.optUp.toTop.showClass);
  843. this.toTopBtn.classList.add(this.optUp.toTop.hideClass);
  844. this.setTopBtnFadeDuration(fadeDuration);
  845. }
  846. }
  847. /* 设置回到顶部按钮的显示隐藏动画时长,默认0.5秒 */
  848. MeScroll.prototype.setTopBtnFadeDuration = function (fadeDuration) {
  849. if (this.toTopBtn) {
  850. var duration = (fadeDuration != null ? fadeDuration : this.optUp.toTop.fadeDuration) + 's';
  851. this.toTopBtn.style.animationDuration = duration;
  852. this.toTopBtn.style.webkitAnimationDuration = duration;
  853. }
  854. }
  855. /* 滑动列表到指定位置--带缓冲效果 (y=0回到顶部;如果要滚动到底部可以传一个较大的值,比如99999);t时长,单位ms,默认300 */
  856. MeScroll.prototype.scrollTo = function (y, t) {
  857. var me = this;
  858. var star = me.getScrollTop();
  859. var end = y;
  860. if (end > 0) {
  861. var maxY = me.getScrollHeight() - me.getClientHeight(); // y的最大值
  862. if (end > maxY) end = maxY; // 不可超过最大值
  863. } else {
  864. end = 0; // 不可小于0
  865. }
  866. me.isScrollTo = true; // 标记在滑动中,阻止列表的触摸事件
  867. me.scrollDom.style.webkitOverflowScrolling = 'auto';
  868. me.getStep(star, end, function (step) {
  869. me.setScrollTop(step);
  870. if (step === end) {
  871. me.scrollDom.style.webkitOverflowScrolling = 'touch';
  872. me.isScrollTo = false;
  873. }
  874. }, t)
  875. }
  876. /* 计步器
  877. star: 开始值
  878. end: 结束值
  879. callback(step,timer): 回调step值,计步器timer,可自行通过window.clearInterval(timer)结束计步器;
  880. t: 计步时长,传0则直接回调end值;不传则默认300ms
  881. rate: 周期;不传则默认30ms计步一次
  882. * */
  883. MeScroll.prototype.getStep = function (star, end, callback, t, rate) {
  884. var diff = end - star; // 差值
  885. if (t === 0 || diff === 0) {
  886. callback && callback(end);
  887. return;
  888. }
  889. t = t || 300; // 时长 300ms
  890. rate = rate || 30; // 周期 30ms
  891. var count = t / rate; // 次数
  892. var step = diff / count; // 步长
  893. var i = 0; // 计数
  894. var timer = window.setInterval(function () {
  895. if (i < count - 1) {
  896. star += step;
  897. callback && callback(star, timer);
  898. i++;
  899. } else {
  900. callback && callback(end, timer); // 最后一次直接设置end,避免计算误差
  901. window.clearInterval(timer);
  902. }
  903. }, rate);
  904. }
  905. /* 加载可视区域的图片 */
  906. MeScroll.prototype.lazyLoad = function (delay) {
  907. var me = this;
  908. var t = delay != null ? delay : me.optUp.lazyLoad.delay; // delay需支持传0,不使用短路求值
  909. var timer = setTimeout(function () {
  910. var domArr = me.scrollDom.querySelectorAll('[' + me.optUp.lazyLoad.attr + ']');
  911. var len = domArr.length;
  912. for (var i = 0; i < len; i++) {
  913. var dom = domArr[i];
  914. if (dom.getAttribute(me.lazyTag) !== 'true' && me.isInSee(dom, me.optUp.lazyLoad.offset)) {
  915. var imgurl = dom.getAttribute(me.optUp.lazyLoad.attr);
  916. // 采用临时img标签加载网络图: 1.不影响占位图; 2.成功可设置渐变动画; 3.失败后可重新触发加载;
  917. var temp = new Image();
  918. temp.onload = function () {
  919. var imgurl = this.src;// 需通过this取值
  920. var dom = this.dom;
  921. var showClass = me.optUp.lazyLoad.showClass;// 渐变动画
  922. showClass && dom.classList.add(showClass);
  923. if (dom.tagName === 'IMG') {
  924. dom.src = imgurl;// 如果是img标签,则直接设置src
  925. } else {
  926. dom.style.backgroundImage = 'url(' + imgurl + ')';// 如果其他标签,则直接设置背景
  927. }
  928. dom.removeAttribute(me.optUp.lazyLoad.attr);
  929. dom.removeAttribute(me.lazyTag);
  930. }
  931. temp.onerror = function () {
  932. this.dom.removeAttribute(me.lazyTag);// 失败的时候取消加载中的标记
  933. }
  934. temp.onabort = function () {
  935. this.dom.removeAttribute(me.lazyTag);// 失败的时候取消加载中的标记
  936. }
  937. temp.src = imgurl;
  938. // 标记在加载中..
  939. dom.setAttribute(me.lazyTag, 'true');
  940. // 把dom挂载到temp,确保在for循环的temp.onload能够正确取到对应的dom
  941. temp.dom = dom;
  942. }
  943. }
  944. }, t)
  945. return timer;
  946. }
  947. /* 判断元素是否在列表垂直区域可视 (不考虑scrollLeft的情况,因为没法监听每个div的水平滚动事件,也不考虑translateY的情况,因为情况比较少,且会增加计算的复杂度) */
  948. MeScroll.prototype.isInSee = function (dom, offset) {
  949. offset = offset || 0; // 可视区域上下偏移的距离
  950. var topDom = this.getOffsetTop(dom);// 元素顶部到容器顶部的距离
  951. var topSee = this.getScrollTop() - offset;// 滚动条的位置(可视范围的顶部)
  952. var bottomDom = topDom + dom.offsetHeight;// 元素底部到容器顶部的距离
  953. var bottomSee = topSee + offset + this.getClientHeight() + offset;// 滚动条的位置+容器高度(可视范围的底部)
  954. // 图片顶部在可视范围内 || 图片底部在可视范围 ; 不考虑scrollLeft和translateY的情况
  955. return (topDom < bottomSee && topDom >= topSee) || (bottomDom <= bottomSee && bottomDom > topSee);
  956. }
  957. /* 获取元素到mescroll滚动列表顶部的距离 */
  958. MeScroll.prototype.getOffsetTop = function (dom) {
  959. var top = dom.offsetTop;
  960. var parent = dom.offsetParent;
  961. while (parent != null && parent !== this.scrollDom) {
  962. top += parent.offsetTop + parent.clientTop;
  963. parent = parent.offsetParent;
  964. }
  965. return top;
  966. }
  967. /* 滚动内容的高度 */
  968. MeScroll.prototype.getScrollHeight = function () {
  969. return this.scrollDom.scrollHeight;
  970. }
  971. /* 滚动容器的高度 */
  972. MeScroll.prototype.getClientHeight = function () {
  973. if (this.isScrollBody && document.compatMode === 'CSS1Compat') {
  974. return document.documentElement.clientHeight;
  975. } else {
  976. return this.scrollDom.clientHeight;
  977. }
  978. }
  979. /* body的高度 */
  980. MeScroll.prototype.getBodyHeight = function () {
  981. return document.body.clientHeight || document.documentElement.clientHeight;
  982. }
  983. /* 滚动条的位置 */
  984. MeScroll.prototype.getScrollTop = function () {
  985. if (this.isScrollBody) {
  986. return document.documentElement.scrollTop || document.body.scrollTop;
  987. } else {
  988. return this.scrollDom.scrollTop;
  989. }
  990. }
  991. /* 滚动条到底部的距离 */
  992. MeScroll.prototype.getToBottom = function () {
  993. return this.getScrollHeight() - this.getClientHeight() - this.getScrollTop();
  994. }
  995. /* 设置滚动条的位置 */
  996. MeScroll.prototype.setScrollTop = function (y) {
  997. if (typeof y === 'number') {
  998. if (this.isScrollBody) {
  999. document.documentElement.scrollTop = y;
  1000. document.body.scrollTop = y;
  1001. } else {
  1002. this.scrollDom.scrollTop = y;
  1003. }
  1004. }
  1005. }
  1006. /* 查找dom元素 */
  1007. MeScroll.prototype.getDomById = function (id) {
  1008. var dom;
  1009. if (id) {
  1010. if (typeof id === 'string') {
  1011. dom = document.getElementById(id); // 如果是String,则根据id查找
  1012. } else if (id.nodeType) {
  1013. dom = id; // 如果是dom对象,则直接赋值
  1014. }
  1015. }
  1016. if (!dom) console.error('the element with id as "' + id + '" can not be found: document.getElementById("' + id + '")==null');
  1017. return dom;
  1018. }
  1019. /* 删除dom元素 */
  1020. MeScroll.prototype.removeChild = function (dom) {
  1021. if (dom) {
  1022. var parent = dom.parentNode;
  1023. parent && parent.removeChild(dom);
  1024. dom = null;
  1025. }
  1026. }
  1027. /* 销毁mescroll */
  1028. MeScroll.prototype.destroy = function () {
  1029. var me = this;
  1030. // 移除下拉布局,移除事件
  1031. me.scrollDom.removeEventListener('touchstart', me.touchstartEvent); // 移动端手指事件
  1032. me.scrollDom.removeEventListener('touchmove', me.touchmoveEvent); // 移动端手指事件
  1033. me.scrollDom.removeEventListener('touchend', me.touchendEvent); // 移动端手指事件
  1034. me.scrollDom.removeEventListener('touchcancel', me.touchendEvent); // 移动端手指事件
  1035. me.scrollDom.removeEventListener('mousedown', me.touchstartEvent); // PC端鼠标事件
  1036. me.scrollDom.removeEventListener('mousemove', me.touchmoveEvent); // PC端鼠标事件
  1037. me.scrollDom.removeEventListener('mouseup', me.touchendEvent); // PC端鼠标抬起事件
  1038. me.scrollDom.removeEventListener('mouseleave', me.touchendEvent); // PC端鼠标离开事件
  1039. me.removeChild(me.downwarp); // 下拉布局
  1040. // 移除上拉布局,回到顶部按钮,移除事件
  1041. if (me.isScrollBody) {
  1042. window.removeEventListener('scroll', me.scrollEvent); // window的滚动事件
  1043. } else {
  1044. me.scrollDom.removeEventListener('scroll', me.scrollEvent); // div的滚动事件
  1045. }
  1046. me.removeChild(me.upwarp); // 上拉布局
  1047. me.removeChild(me.toTopBtn); // 回到顶部按钮
  1048. // 允许回弹,解除禁止webview的touchmove事件
  1049. me.setBounce(true);
  1050. }
  1051. return MeScroll;
  1052. });