## 基本功能
### options.bounce
當滾動器到達容器邊界時他將執行一個小反彈動畫。在老的或者性能低的設備上禁用反彈對實現平滑的滾動有幫助。
默認值:`true`
### options.click
為了重寫原生滾動條,iScroll禁止了一些默認的瀏覽器行為,比如鼠標的點擊。如果你想你的應用程序響應*click*事件,那么該設置次屬性為`true`。請注意,建議使用自定義的`tap`?事件來代替它(見下面)。
默認屬性:`false`
### options.disableMouse
options.disablePointer
options.disableTouch
默認情況下,iScroll監聽所有的指針事件,并且對這些事件中第一個被觸發的做出反應。這看上去是浪費資源,但是在大量的瀏覽器/設備上兼容,特定的事件偵測證明是無效的,所以*listen-to-all*是一個安全的做法。
如果你有一種設備偵測的內部機制,或者你知道你的腳本將在什么地方運行,你可以把你不需要的事件禁用(鼠標,指針或者觸摸事件)。
下面的例子是禁用鼠標和指針事件:
~~~
var myScroll = new IScroll('#wrapper', {
disableMouse: true,
disablePointer: true
});
~~~
默認值:`false`
### options.eventPassthrough
有些時候你想保留原生縱向的滾動條但想為橫向滾動條增加iScroll功能(比如走馬燈)。設置這個屬性為`true`并且iScroll區域只將影響橫向滾動,縱向滾動將滾動整個頁面。
在移動設備上訪問[event passthrough demo](http://lab.cubiq.org/iscroll5/demos/event-passthrough/)。注意,這個值也可以設置為`'horizontal'`,其作用和上面介紹的相反(橫向滾動條保持原生,縱向滾動條使用iScroll)。
### options.freeScroll
此屬性針對于兩個兩個緯度的滾動條(當你需要橫向和縱向滾動條)。通常情況下你開始滾動一個方向上的滾動條,另外一個方向上會被鎖定不動。有些時候,你需要無約束的移動(橫向和縱向可以同時響應),在這樣的情況下此屬性需要設置為`true`。請參考?[2D scroll demo](http://lab.cubiq.org/iscroll5/demos/2d-scroll/)。
默認值:`false`
### options.keyBindings
此屬性為`true`時激活鍵盤(和遠程控制)綁定。請參考下面的[Key bindings](https://iiunknown.gitbooks.io/iscroll-5-api-cn/content/basicfeatures.html#key-bindings)內容。
默認值:`false`
### options.invertWheelDirection
當鼠標滾輪支持激活后,在有些情況下需要反轉滾動的方向。(比如,鼠標滾輪向下滾動條向上,反之亦然)。
默認值:`false`
### options.momentum
在用戶快速觸摸屏幕時,你可以開/關勢能動畫。關閉此功能將大幅度提升性能。
默認值:`true`
### options.mouseWheel
偵聽鼠標滾輪事件。
默認值:`false`
### options.preventDefault
當事件觸發時師傅執行`preventDefault()`。此屬性應該設置為`true`,除非你真的知道你需要怎么做。
請參考[Advanced features](https://iiunknown.gitbooks.io/iscroll-5-api-cn/content/basicfeatures.html#advanced-features)中的`preventDefaultException`,可以獲取更多控制preventDefault行為的信息。
Default:?`true`?默認值:`true`
### options.scrollbars
是否顯示為默認的滾動條。更多信息請查看[Scrollbar](https://iiunknown.gitbooks.io/iscroll-5-api-cn/content/basicfeatures.html#scrollbar)
默認值:`false`
### options.scrollX
options.scrollY
默認情況下只有縱向滾動條可以使用。如果你需要使用橫向滾動條,需要將`scrollX`?屬性值設置為?`true`。請參考示例[horizontal demo](http://lab.cubiq.org/iscroll5/demos/horizontal/)。
也可以參考**freeScroll**選項。
默認值:`scrollX: false`,`scrollY: true`
注意屬性?`scrollX/Y: true`?與`overflow: auto`有相同的效果。設置一個方向上的值為?`false`?可以節省一些檢測的時間和CPU的計算周期。
### options.startX
options.startY
默認情況下iScroll從`0, 0`?(top left)位置開始,通過此屬性可以讓滾動條從不同的位置開始滾動。
默認值:`0`
### options.tap
設置此屬性為`true`,當滾動區域被點擊或者觸摸但并沒有滾動時,可以讓iScroll拋出一個自定義的`tap`事件。
這是處理與可以點擊元素之間的用戶交互的建議方式。偵聽`tap`事件和偵聽標準事件的方式一致。示例如下:
~~~
element.addEventListener('tap', doSomething, false); \\ Native
$('#element').on('tap', doSomething); \\ jQuery
~~~
你可以通過傳遞一個字符串來自定義事件名稱。比如:
~~~
tap: 'myCustomTapEvent'
~~~
在這個示例里你應該偵聽名為`myCustomTapEvent`的事件。
默認值:`false`