iScroll学习笔记

都说iScroll是移动端开发必学的库之一，先来看看为啥要用iScroll。网上找了找资料，总结下缘由以下：

一、position：fixed 在移动端浏览器上的兼容性很差

简单列举以下：

IOS的Safari ：

• IOS5及之后的版本支持该属性，
• IOS4及如下会把它当成默认的 position: static， 跟着页面一块儿滚动

Android ：

• Android 2.1及如下不支持
• Android 2.2会在滚动完成以后把定位的元素拉回到原来的位置
• Android 2.3 只有在禁止页面缩放的状况下才支持固定定位
• Android 3 和 4 支持

更多的机型和浏览器版本请戳这里

二、原生的滚动在手机浏览器上不太流畅，体验很差

三、暂时没有了，之后有了再补充

入门

基本的DOM结构以下：

<header>IScoll</header>
<div id="wrapper">
    <ul>
        <li></li>
        ...
    </ul>
</div>
<footer>Footer</footer>

外部容器的 id 必须为 wrapper 这是源码里写死的，只有容器的第一个子元素才能滚动，上面的代码中，滚动的是ul。

给wrapper添加一个 position: relative 或者 absolute 能够解决不少因错误计算容器尺寸形成的问题。

每一个须要滚动的区域都须要进行初始化，初始化代码以下

document.addEventListener('DOMContentLoaded', loadHandler, false);

function loadHandler(){
    var myScroll = new IScroll('#wrapper');
}

而后就能够滚动了，超级简单有木有！！

初始化代码最好放在 window onload 事件处理函数中，或者 DOMContentLoaded 事件处理函数中，脚本须要知道滚动区域的宽/高，若是有一些图片没有指定宽高，IScroll可能会错误地计算滚动尺寸。

若是DOM结构比较复杂，onload以后留出100到200毫秒的时间给iScroll初始化是比较明智的，

另外，文档里还有这样一段话：

box-shadow, opacity, text-shadow 和 alpha 通道这些属性不能和硬件加速很好的结合。当只有少许元素时，滚动效果会很流畅，可是一旦你的DOM结构变的很复杂，就会体验很渣.

配置参数说明

hScroll: true, //是否水平滚动
vScroll: true, //是否垂直滚动
x: 0, //滚动水平初始位置
y: 0, //滚动垂直初始位置
snap: true, //值能够为true或是DOM元素的tagname，当为true时，对齐的坐标会根据可滚动的位置和滚动区域计算获得可滑动几页，若是为tagname,则滑动会对齐到元素上
bounce: true, //是否超过实际位置反弹
bounceLock: false, //当内容少于滚动是否能够反弹，这个实际用处不大
momentum: true, //动量效果，拖动惯性
lockDirection: true, //当水平滚动和垂直滚动同时生效时，当拖动开始是否锁定另外一边的拖动
useTransform: true, //是否使用CSS形变
useTransition: false, //是否使用CSS变换
topOffset: 0, //已经滚动的基准值(通常状况用不到)
checkDOMChanges: false, //是否自动检测内容变化(这个检测不是很准)

//Scrollbar相关参数，经过scrollbar这些参数能够配置iscroll的滚动条，经过scrollbarClass能够本身定义一套滚动条的样式。
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 //放大完成后的回调

方法

destroy 
顾名思义，是用来销毁你实例化的iScroll 实例，包括以前绑定的全部iscroll 事件。 

refresh 
这个方法很是有用，当你的滚动区域的内容发生改变 或是 滚动区域不正确，都用经过调用refresh 来使得iscroll 从新计算滚动的区域，包括滚动条，来使得iscroll 适合当前的dom。 

scrollTo 
这个方法接受4个参数 x, y, time, relative x 为移动的x轴坐标，y为移动的y轴坐标, time为移动时间，relative表示是否相对当前位置。 

scrollToElement 
这个方法其实是对scrollTo的进一步封装，接受两个参数(el,time)，el为须要滚动到的元素引用，time为滚动时间。 

scrollToPage 
此方法接受三个参数(pageX,pageY,time) 当滚动内容的高宽大于滚动范围时，iscroll 会自动分页，而后就能使用scrollToPage方法滚动到页面。固然，当hscroll 为false 的时候，不能左右滚动。pageX这个参数就失去效果 

disable 
调用这个方法会当即中止动画滚动，而且把滚动位置还原成0，取消绑定touchmove, touchend、touchcancel事件。 

enable 
调用这个方法，使得iscroll恢复默认正常状态 

stop 
当即中止动画 

zoom 
改变内容的大小倍数,此方法接受4个参数，x,y,scale,time 分别表示的意思为，放大的基准坐标，以及放大倍数，动画时间 

isReady 
当iscroll 没有处于正在滚动，没有移动过，没有改变大小时，此值为true