网站推广.NET

网站推广.NET

iScroll是什么?iScroll用法实例详解

来源:互联网

iscroll的产生:

iScroll的产生完全是因为移动版webkit浏览器,例如在iPhone,Android 的移动设备上。
iScroll的使用方法:

iScroll的原理是外层有一个溢出隐藏(overflow:hidden;)的DOM,然后这个区域内的第一个DOM结构会被实例化,其包裹的内容可以纵向或者横向的滚动,所以在使用iScroll的时候,滚动元素要尽量的简单,减少DOM个数,减少嵌套,因为DOM结构越是复杂iScroll运行起来就越是吃力,有可能会造成某些节点显示不正常的情况。 所以,推荐使用的DOM结构如下:


<p id="wrapper">//overflow:hidden; <ul> //只有第一个DOM结构(ul)被实例化,这个DOM可以纵向或者横向的滚动, //多出的内容会被wrapper的样式hidden。  <li>1</li>  <li>2</li>  <li>3</li> </ul></p>

注意:再次重申,只有wrapper里的第一个子元素(ul)才可以被实例化滚动,并且要结合外层的DOM(wrapper)才能实现滚动。
如果 wrapper中有多个ul怎么办?很简单,记住那句话,只有wrapper里的第一个子元素(ul)才可以被实例化滚动:


<p id="wrapper">//overflow:hidden; <p 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> </p></p>

看到了吧,只有first会被实例化。 注意:这里第一个DOM结构的ID(first)可以不写,我只是为了方便大家识别才写了个ID,但是最外层的ID(wrapper)一定要写,因为在JS实例化的时候需要填写这个ID:


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已经实例化了。

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("<p>pagedata</p>");

iScroll中的参数:

在实例化iScroll的时候,可以传入两个参数,第一个参数是实例化的外层的DOM的ID,第二个参数是iScroll执行方法的对象:


var myscroll=new iScroll("wrapper",{hScrollbar:false});或者var opts = {    vScroll:false,//禁止垂直滚动    snap:true,//执行传送带效果    hScrollbar:false//隐藏水平方向上的滚动条   };var myscroll = new iScroll("wrapper",opts);

第二个参数内容如下,这个参数会控制iScroll的效果:


hScroll  false 禁止横向滚动 true横向滚动 默认为truevScroll  false 禁止垂直滚动 true垂直滚动 默认为truehScrollbar  false隐藏水平方向上的滚动条vScrollbar  false 隐藏垂直方向上的滚动条fadeScrollbar false 指定在无渐隐效果时隐藏滚动条hideScrollbar 在没有用户交互时隐藏滚动条 默认为truebounce   启用或禁用边界的反弹,默认为truemomentum  启用或禁用惯性,默认为true,此参数在你想要保存资源的时候非常有用lockDirection false取消拖动方向的锁定,true拖动只能在一个方向上(up/down 或者left/right)

iScroll中的方法:

当然在第二个参数中,也有一些方法可以执行:
(1)scrollTo(x, y, time, relative)方法:传入4个参数:X轴滚动距离,Y轴滚动距离,效果时间,是否相对当前位置。所以例如:


//在200毫秒的时间内,Y轴向上滚动100像素;uw3c.scrollTo(0, -100, 200)//在200毫秒的时间内,相对于当前位置,X轴向左滚动100像素;uw3c.scrollTo(-100, 0, 200, true)

(2)refresh()方法:在DOM结构发生改变之后,需要刷新iScroll,否则滚动插件会实例化的不准确:


uw3c.refresh();//刷新iScroll

(3)onPosChange,有没有一个方法能返回位置的变化?你可以查询一下自己所用的iScroll中有没有onPosChange方法:


onPosChange:function(x,y){ if(y < -200){  //如果Y周向上滚动200像素,$("#uw3c")就显示,否则就隐藏。  $("#uw3c").show(); }else{  $("#uw3c").hide(); }}

(4)onScrollend:滚动结束时执行的事件,如果想在滚动结束时出发摸个事件,这个方法就拍上用处了:


//滚动结束后,执行的方法,滚动后会出现提示框alert("phpcn")onScrollEnd:function(){ alert("phpcn");}

(5)onRefresh:在DOM结构发生改变之后,需要刷新iScroll,否则滚动插件会实例化的不准确,onRefresh是刷新完iScroll会执行的方法。
(6)onBeforeScrollStart:开始滚动前的时间回调,默认是阻止浏览器默认行为 。
(7)onScrollStart:开始滚动的回调。
(8)onBeforeScrollmove:在内容移动前的回调。
(9)onScrollMove:内容移动的回调。
(10)onBeforeScrollEnd:在滚动结束前的回调。
(11)onTouchEnd:手离开屏幕后的回调。
(12)onDestroy:销毁实例的回调。

iscroll