nanoScrollerJS是一款使用簡單方式實作 Mac OS X Lion 系統捲軸效果的jQuery外掛程式。此捲軸插件使用最小的HTML結構 .nano > .nano-content 。其它的滾動條元素 .pane > .nano-slider 是在插件運行時動態載入的。這個滾動條插件利用原生的滾動條可以工作在 iPad、iPhone 和一些 Android Tablets上。
使用方法
HTML結構
以下是這個捲軸外掛程式工作所必須的HTML結構:
nano 和 nano-content 的class名稱可以透過插件參數來改變(改變後插件的CSS檔案也要對應的改變)。
CSS樣式
在HTML
你必須為容器指定一個寬度和高度,並為你的捲軸定制一些基本樣式,例如:
JAVASCRIPT
在頁面中引入 jquery.nanoscroller.js 檔案。
然後使用下面的方法呼叫該捲軸插件,HTML中所有帶有 .nano 的DOM元素都會被應用上該方法:
高級方法
捲到頂部:
捲動到底部:
捲動到頂部並帶個偏移值:
捲動到底部並帶個偏移值:
捲動一個元素:
停止滾動操作。這個選項將會使捲軸外掛程式的所有綁定事件無效,並在UI上隱藏捲軸。
destroy
銷毀nanoScroller捲軸並將捲軸重設為瀏覽器原生捲軸:
設定滾動條閃動,閃動時間由參數來設定(預設1.5秒)。
nanoScroller();
刷新捲軸。此操作會簡單的重新計算滾動條的位置和高度:
自訂事件
scrollend
一個自訂的 scrollend 事件會在每次捲軸滾動到容器底部時觸發。 (當滾動條已經到達容器底部,用戶再次滾動時不會觸發該事件)
有些瀏覽器會在同一時間多次觸發該事件,所以應該使用jQuery .bind 或 .on 來綁定該事件。你可以使用 jquery-debounce 外掛程式來讓瀏覽器每隔100毫秒才觸發一次該事件:
scrolltop
和 scrollend 事件相同,它是每次使用者滾動到容器的頂部時觸發。
和 scrollend 事件和 scrolltop 事件相同,它在使用者每次捲動時觸發。此事件附帶滾動條當前位置、最大高度和方向( up 或 down )的js物件參數:
設定參數
這個捲軸插件中有一組參數可以使用:
iOSNativeScrolling
如果你希望在 iOS 5 中使用原生的捲軸,可以設定為 true 。在 iOS 5 中原生的捲軸會運作的更好。
注意當 iOSNativeScrolling 設定為 true 時, .pane 和 .slider 不會被裝置產生/新增來支援原生的捲軸。
預設值 :false。
sliderMinHeight
設定滾動元素的最小高度:
預設值 :20。
sliderMaxHeight
設定滾動元素的最大高度:
預設值 :null。
preventPageScrolling
設定為 true 時可以在容器內容捲動到頂部或底部時阻止頁面捲動:
預設值 :false。
disableResize
設定為 true 阻止nanoscroller改變大小。如果你設定該選項為 true ,記得要呼叫reset方法,否則會產生奇怪的問題:
預設值 :false。
alwaysVisible
設定為 true 關閉捲軸停止時自動隱藏功能:
預設值 :false。
flashDelay
當你開啟 flash 選項時,這個選項用來指定閃爍的延遲:
預設值 :1500。
paneClass
捲動條track元素的class名稱。如果你修改了它,需要在CSS檔案中做相應的修改:
預設值 : 'nano-pane'。
contentClass
捲軸容器div的class名稱。如果你修改了它,需要在CSS檔案中做相應的修改:
預設值 : 'nano-content'。
tabIndex
設定可捲動內容的順序,設定為-1時使用tab鍵會跳過該內容:
預設值 :0。
瀏覽器相容
桌上型設備
IE7
Firefox 3
Chrome
Safari 4
Opera 11.60
行動裝置
iOS 5 (iPhone, iPad 與 iPod Touch)
iOS 4 (附一個插件)
Android Firefox
Android 2.2/2.3 native browser (附一個外掛程式)
Android Opera 11.6 (附一個外掛程式)
透過插件在行動裝置瀏覽器更好的運行nanoScroller
你可以透過 overthrow.js 來讓nanoScroller 在行動瀏覽器上更好的工作。它會在行動裝置上模擬CSS的overflow( overflow: auto;/overflow: scroll; )。
要使用overthrow,在頁面中引入overthrow.js:
然後在你的捲軸內容 div 中加入 overthrow class:
以上就是關於nanoscroller外掛的使用方法,希望大家能夠喜歡。