• 基本功能
    • options.bounce
    • options.click
    • options.disableMouse
      options.disablePointer
      options.disableTouch
    • options.eventPassthrough
    • options.freeScroll
    • options.keyBindings
    • options.invertWheelDirection
    • options.momentum
    • options.mouseWheel
    • options.preventDefault
    • options.scrollbars
    • options.scrollX
      options.scrollY
    • options.startX
      options.startY
    • options.tap

    基本功能

    options.bounce

    当滚动器到达容器边界时他将执行一个小反弹动画。在老的或者性能低的设备上禁用反弹对实现平滑的滚动有帮助。

    默认值:true

    options.click

    为了重写原生滚动条,iScroll禁止了一些默认的浏览器行为,比如鼠标的点击。如果你想你的应用程序响应click事件,那么该设置次属性为true。请注意,建议使用自定义的tap 事件来代替它(见下面)。

    默认属性:false

    options.disableMouse
    options.disablePointer
    options.disableTouch

    默认情况下,iScroll监听所有的指针事件,并且对这些事件中第一个被触发的做出反应。这看上去是浪费资源,但是在大量的浏览器/设备上兼容,特定的事件侦测证明是无效的,所以listen-to-all是一个安全的做法。

    如果你有一种设备侦测的内部机制,或者你知道你的脚本将在什么地方运行,你可以把你不需要的事件禁用(鼠标,指针或者触摸事件)。

    下面的例子是禁用鼠标和指针事件:

    1. var myScroll = new IScroll('#wrapper', {
    2. disableMouse: true,
    3. disablePointer: true
    4. });

    默认值:false

    options.eventPassthrough

    有些时候你想保留原生纵向的滚动条但想为横向滚动条增加iScroll功能(比如走马灯)。设置这个属性为true并且iScroll区域只将影响横向滚动,纵向滚动将滚动整个页面。

    在移动设备上访问event passthrough demo。注意,这个值也可以设置为'horizontal',其作用和上面介绍的相反(横向滚动条保持原生,纵向滚动条使用iScroll)。

    options.freeScroll

    此属性针对于两个两个纬度的滚动条(当你需要横向和纵向滚动条)。通常情况下你开始滚动一个方向上的滚动条,另外一个方向上会被锁定不动。有些时候,你需要无约束的移动(横向和纵向可以同时响应),在这样的情况下此属性需要设置为true。请参考 2D scroll demo。

    默认值:false

    options.keyBindings

    此属性为true时激活键盘(和远程控制)绑定。请参考下面的Key bindings内容。

    默认值:false

    options.invertWheelDirection

    当鼠标滚轮支持激活后,在有些情况下需要反转滚动的方向。(比如,鼠标滚轮向下滚动条向上,反之亦然)。

    默认值:false

    options.momentum

    在用户快速触摸屏幕时,你可以开/关势能动画。关闭此功能将大幅度提升性能。

    默认值:true

    options.mouseWheel

    侦听鼠标滚轮事件。

    默认值:false

    options.preventDefault

    当事件触发时师傅执行preventDefault()。此属性应该设置为true,除非你真的知道你需要怎么做。

    请参考Advanced features中的preventDefaultException,可以获取更多控制preventDefault行为的信息。

    Default: true
    默认值:true

    options.scrollbars

    是否显示为默认的滚动条。更多信息请查看Scrollbar

    默认值:false

    options.scrollX
    options.scrollY

    默认情况下只有纵向滚动条可以使用。如果你需要使用横向滚动条,需要将scrollX 属性值设置为 true。请参考示例horizontal demo。

    也可以参考freeScroll选项。

    默认值:scrollX: falsescrollY: true

    注意属性 scrollX/Y: trueoverflow: auto有相同的效果。设置一个方向上的值为 false 可以节省一些检测的时间和CPU的计算周期。

    options.startX
    options.startY

    默认情况下iScroll从0, 0 (top left)位置开始,通过此属性可以让滚动条从不同的位置开始滚动。

    默认值:0

    options.tap

    设置此属性为true,当滚动区域被点击或者触摸但并没有滚动时,可以让iScroll抛出一个自定义的tap事件。

    这是处理与可以点击元素之间的用户交互的建议方式。侦听tap事件和侦听标准事件的方式一致。示例如下:

    1. element.addEventListener('tap', doSomething, false); \\ Native
    2. $('#element').on('tap', doSomething); \\ jQuery

    你可以通过传递一个字符串来自定义事件名称。比如:

    1. tap: 'myCustomTapEvent'

    在这个示例里你应该侦听名为myCustomTapEvent的事件。

    默认值:false