iscroll简单使用说明

iScroll是一个高性能,资源占用少,无依赖,跨平台的javascript上拉加载,下拉刷新的滚动插件,目前版本v5.2.0。

GitHub下载地址:https://github.com/cubiq/iscroll

iScroll进行了不同的优化,为了达到更高的性能,iScroll分为了多个版本,你可以根据项目选择最适合的版本。

目前有以下版本:

  • iscroll.js,这个版本是常规应用的脚本。它包含大多数常用的功能,有很高的性能和很小的体积。
  • iscroll-lite.js,精简版本。它不支持快速跳跃,滚动条,鼠标滚轮,快捷键绑定。但如果你所需要的是滚动(特别是在移动平台) iScroll 精简版 是又小又快的解决方案(这个能应付大多数场景)。
  • iscroll-probe.js,探查当前滚动位置是一个要求很高的任务,这就是为什么我决定建立一个专门的版本。如果你需要知道滚动位置在任何给定的时间,这是iScroll给你的。(我正在做更多的测试,这可能最终在常规iscroll.js脚本,请留意)。
  • iscroll-zoom.js,在标准滚动功能上增加缩放功能。
  • iscroll-infinite.js,可以做无限缓存的滚动。处理很长的列表的元素为移动设备并非易事。 iScroll infinite版本使用缓存机制,允许你滚动一个潜在的无限数量的元素。

使用方法:

页面引用:

<script type="text/javascript" src="iscroll.js"></script>

HTML结构如下:

<div id="wrapper">
     <ul>
         <li>...</li>
         <li>...</li>
         ...
     </ul>
 </div>

JS初始化:

<script type="text/javascript">
 var myScroll = new IScroll('#wrapper');
 </script>

 iScroll配置参数说明:

var myScroll = new IScroll('#wrapper', {
     mouseWheel: true, //是否监听鼠标滚轮事件
     scrollbars: true,      //是否显示默认滚动条
     preventDefault: true,//是否屏蔽默认事件
     preventDefaultException:{tagName:/^(INPUT|TEXTAREA|BUTTON|SELECT)$/ }, //列出哪些元素不屏蔽默认事件
     probeType: 3,//需要使用 iscroll-probe.js 才能生效 probeType : 1   滚动不繁忙的时候触发;probeType : 2   滚动时每隔一定时间触;probeType : 3   每滚动一像素触发一次
     
 });

API:

所属方法名说明
滚动scrollTo(x, y, time, easing)滚动到: x , y ,事件, easing 方式 x:int y:int time:int Easing: quadratic | circular | back | bounce | elastic 见 IScroll.utils.ease  对象 例: myScroll.scrollTo(0, -100, 1000, IScroll.utils.ease.elastic);scrollBy(x, y, time, easing)滚动到相对于当前位置的某处其余同上 scrollToElement(el, time, offsetX, offsetY, easing)滚动到某个元素。 el 为必须的参数offsetX/offsetY :相对于 el 元素的位移。设为 true 即为屏幕中心 分割页面 snapgoToPage(x, y, time, easing)根据 options.snap 分割页面,跳转到横向、纵向某页。 XY 可以同时生效。 next() prev()上一页,下一页结合 options.snap使用缩放zoom(scale, x, y, time)缩放容器Scale: 缩放因子刷新refresh()刷新 IScroll销毁destroy()销毁 IScroll ,节省资源
&nbsp;

事件使用:

beforeScrollStart用户点击屏幕,但是还未初始化滚动前
scrollCancel初始化滚动后又取消scrollStart开始滚动scroll滚动中scrollEnd滚动结束flick轻击屏幕左、右zoomStart开始缩放zoomEnd缩放结束
这个在微信中使用还是存在一些小问题,欢迎大家拍砖,共同交流探讨。喜欢H5,web开发的朋友可以加群:374166122

请使用手机"扫一扫"x

相关推荐