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