概述:
大家在日常工作中最常用的插件是什么,jQurey?Lazyload?但是这些都是在PC端,但是在移动端最常用的插件莫过于iScroll了,iScroll到底是什么东西,应该怎么用?iScroll是个很强大的插件,我也只是略懂皮毛,这里我们简单的介绍一下。
iScroll的产生:
iScroll的产生完全是因为移动版webkit浏览器,例如在iPhone,Android 的移动设备上。
iScroll的使用方法:
iScroll的原理是外层有一个溢出隐藏(overflow:hidden;)的DOM,然后这个区域内的第一个DOM结构会被实例化,其包裹的内容可以纵向或者横向的滚动,所以在使用iScroll的时候,滚动元素要尽量的简单,减少DOM个数,减少嵌套,因为DOM结构越是复杂iScroll运行起来就越是吃力,有可能会造成某些节点显示不正常的情况。 所以,推荐使用的DOM结构如下:
1 2 3 4 5 6 7 8 9 | <div id= "wrapper" > //overflow:hidden; <ul> //只有第一个DOM结构(ul)被实例化,这个DOM可以纵向或者横向的滚动, //多出的内容会被wrapper的样式hidden。 <li>1</li> <li>2</li> <li>3</li> </ul> </div> |
注意:再次重申,只有wrapper里的第一个子元素(ul)才可以被实例化滚动,并且要结合外层的DOM(wrapper)才能实现滚动。
如果 wrapper中有多个ul怎么办?很简单,记住那句话,只有wrapper里的第一个子元素(ul)才可以被实例化滚动:
看到了吧,只有first会被实例化。 注意:这里第一个DOM结构的ID(first)可以不写,我只是为了方便大家识别才写了个ID,但是最外层的ID(wrapper)一定要写,因为在JS实例化的时候需要填写这个ID:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | <div id= "wrapper" > //overflow:hidden; <div id= "first" > //只有第一个DOM结构(ul)被实例化,这个DOM可以纵向或者横向的滚动, //多出的内容会被wrapper的样式hidden <ul> <li>1</li> <li>2</li> <li>3</li> </ul> <ul> <li>4</li> <li>5</li> <li>6</li> </ul> </div> </div> |
1 | var myScroll = new iScroll( "wrapper" ); |
iScroll应该如何实例化:
既然说道了实例化,我们应该在什么时候实例化?据说实例化的方法有很多,但是我没用过,我只说一种: (1)在HTML(uw3c.html)页面底部(body之后html之前)加载iscroll.js与当前页面的uw3c.js,这样能确保HTML的DOM结构能加载出来。 (2)在JS插入页面DOM结构和数据之前实例化iScroll,也就是在JS的最开始实例化,因为之后可能会使用JS来插入DOM或者数据,这样以来能确保在插入数据之前iScroll已经实例化了。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | HTML: //HTML结构 <html > <body> ...code... </body> //插入iscroll.js文件 <script type= "text/javascript" src= "js/iscroll.js" > </script > //插入本页面JS文件 <script type= "text/javascript" src= "js/uw3c.js" > </script > </html> JS: //JS文件内容 var myscroll; function iscroll(data){ //实例化iScroll myscroll= new iScroll( "wrapper" ); pageData(data); } function pageData(obj){ $( "body" ).html(obj); myscroll.refresh(); //当DOM结构发生变化的时候,需要刷新iScroll } iscroll( "<div>pagedata</div>" ); |
iScroll中的参数:
在实例化iScroll的时候,可以传入两个参数,第一个参数是实例化的外层的DOM的ID,第二个参数是iScroll执行方法的对象:
或者
1 | var myscroll= new iScroll( "wrapper" ,{hScrollbar: false }); |
1 2 3 4 5 6 | var opts = { vScroll: false , //禁止垂直滚动 snap: true , //执行传送带效果 hScrollbar: false //隐藏水平方向上的滚动条 }; var myscroll = new iScroll( "wrapper" ,opts); |
第二个参数内容如下,这个参数会控制iScroll的效果:
1 2 3 4 5 6 7 8 9 10 11 | hScroll false 禁止横向滚动 true 横向滚动 默认为 true vScroll false 禁止垂直滚动 true 垂直滚动 默认为 true hScrollbar false 隐藏水平方向上的滚动条 vScrollbar false 隐藏垂直方向上的滚动条 fadeScrollbar false 指定在无渐隐效果时隐藏滚动条 hideScrollbar 在没有用户交互时隐藏滚动条 默认为 true bounce 启用或禁用边界的反弹,默认为 true momentum 启用或禁用惯性,默认为 true , 此参数在你想要保存资源的时候非常有用 lockDirection false 取消拖动方向的锁定, true 拖动只能在一个方向上(up/down 或者left/right) |
iScroll中的方法:
当然在第二个参数中,也有一些方法可以执行:
(1) scrollTo(x, y, time, relative)方法:传入4个参数:X轴滚动距离,Y轴滚动距离,效果时间,是否相对当前位置。所以例如:
1 2 3 4 | //在200毫秒的时间内,Y轴向上滚动100像素; uw3c.scrollTo(0, -100, 200) //在200毫秒的时间内,相对于当前位置,X轴向左滚动100像素; uw3c.scrollTo(-100, 0, 200, true ) |
(2) refresh()方法:在DOM结构发生改变之后,需要刷新iScroll,否则滚动插件会实例化的不准确:
1 | uw3c.refresh(); //刷新iScroll |
(3) onPosChange,有没有一个方法能返回位置的变化?你可以查询一下自己所用的iScroll中有没有onPosChange方法:
1 2 3 4 5 6 7 8 | onPosChange: function (x,y){ if (y < -200){ //如果Y周向上滚动200像素,$("#uw3c")就显示,否则就隐藏。 $( "#uw3c" ).show(); } else { $( "#uw3c" ).hide(); } } |
(4) onScrollEnd:滚动结束时执行的事件,如果想在滚动结束时出发摸个事件,这个方法就拍上用处了:
1 2 3 4 | //滚动结束后,执行的方法,滚动后会出现提示框alert("uw3c.com") onScrollEnd: function (){ alert( "uw3c.com" ); } |
(5) onRefresh:在DOM结构发生改变之后,需要刷新iScroll,否则滚动插件会实例化的不准确,onRefresh是刷新完iScroll会执行的方法。
(6) onBeforeScrollStart:开始滚动前的时间回调,默认是阻止浏览器默认行为 。
(7) onScrollStart:开始滚动的回调。
(8) onBeforeScrollMove:在内容移动前的回调。
(9) onScrollMove:内容移动的回调。
(10) onBeforeScrollEnd:在滚动结束前的回调。
(11) onTouchEnd:手离开屏幕后的回调。
(12) onDestroy:销毁实例的回调。
截至到笔者发布这篇文章时,通过样式:
- overflow:scroll;
- -webkit-overflow-scrolling:touch;
- <div id="wrapper">
- <ul id="scroll">
- <li></li>
- ...
- ...
- </ul>
- </div>
- #wrapper {
- position:relative;
- z-index:1;
- width:/* your desired width, auto and 100% are fine */;
- height:/* element height */;
- overflow:/* hidden|auto|scroll */;
- }
- 基础
- 滚动条
- 放大缩小
- 事件回调
以下由笔者整理的iScroll参数以及其代表的意思:
- hScroll: true, //是否水平滚动
- vScroll: true, //是否垂直滚动
- x: 0, //滚动水平初始位置
- y: 0, //滚动垂直初始位置
- bounce: true, //是否超过实际位置反弹
- bounceLock: false, //当内容少于滚动是否可以反弹,这个实际用处不大
- momentum: true, //动量效果,拖动惯性
- lockDirection: true,
- //当水平滚动和垂直滚动同时生效时,当拖动开始是否锁定另一边的拖动
- useTransform: true, //是否使用CSS形变
- useTransition: false, //是否使用CSS变换
- topOffset: 0, //已经滚动的基准值(一般情况用不到)
- checkDOMChanges: false, //是否自动检测内容变化
- // Scrollbar 的相关参数
- hScrollbar: true, //是否显示水平滚动条
- vScrollbar: true, //同上垂直滚动条
- fixedScrollbar: isAndroid, //对andriod的fixed
- hideScrollbar: isIDevice, //是否隐藏滚动条
- fadeScrollbar: isIDevice && has3d, //滚动条是否渐隐渐显
- scrollbarClass: '', //字定义滚动条的样式名
- // Zoom 放大相关的参数
- zoom: false, //默认是否放大
- zoomMin: 1, //放大的最小倍数
- zoomMax: 4, //最大倍数
- doubleTapZoom: 2, //双触放大几倍
- wheelAction: 'scroll', //鼠标滚动行为(还可以是zoom)
- // 自定义 Events 的相关参数
- onRefresh: null, //refresh 的回调,关于自身何时调用refresh 后面会继续谈到
- onBeforeScrollStart: function (e) { e.preventDefault(); },
- //开始滚动前的时间回调,默认是阻止浏览器默认行为
- onScrollStart: null, //开始滚动的回调
- onBeforeScrollMove: null, //在内容移动前的回调
- onScrollMove: null, //内容移动的回调
- onBeforeScrollEnd: null, 在滚动结束前的回调
- onScrollEnd: null, //在滚动完成后的回调
- onTouchEnd: null, //手离开屏幕后的回调
- onDestroy: null, //销毁实例的回调
- onZoomStart: null,
- onZoom: null,
- onZoomEnd: null
- var myscroll = new iScroll('wrapper', {
- hScroll: false, //是否水平滚动
- vScroll: true, //是否垂直滚动
- y: 10, //滚动垂直初始位置
- bounce : false
- });
参考:
http://www.uw3c.com/jsviews/js02.html
http://cshbbrain.iteye.com/blog/1825976