jQuery製作仿Mac Lion OS捲軸效果_jquery

nanoScrollerJS是一款使用簡單方式實作 Mac OS X Lion 系統捲軸效果的jQuery外掛程式。此捲軸插件使用最小的HTML結構 .nano > .nano-content 。其它的滾動條元素 .pane > .nano-slider 是在插件運行時動態載入的。這個滾動條插件利用原生的滾動條可以工作在 iPad、iPhone 和一些 Android Tablets上。

使用方法

HTML結構

以下是這個捲軸外掛程式工作所必須的HTML結構：

複製程式碼 程式碼如下:

   

... content here ... 

nano 和 nano-content 的class名稱可以透過插件參數來改變（改變後插件的CSS檔案也要對應的改變）。

CSS樣式

在HTML

中引入 nanoscroller.css 檔案。

複製程式碼 程式碼如下:

你必須為容器指定一個寬度和高度，並為你的捲軸定制一些基本樣式，例如：

複製程式碼 程式碼如下:

.nano { background: #bba; width: 500px; height: 500px; }
.nano > .nano-content { padding: 10px; }
.nano > .nano-pane   { background: #888; }
.nano > .nano-pane > .nano-slider { background: #111; }

JAVASCRIPT

在頁面中引入 jquery.nanoscroller.js 檔案。

複製程式碼 程式碼如下:

然後使用下面的方法呼叫該捲軸插件，HTML中所有帶有 .nano 的DOM元素都會被應用上該方法：

複製程式碼 程式碼如下:

$(".nano").nanoScroller();

高級方法

捲到頂部：

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ scroll: 'top' });

捲動到底部：

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ scroll: 'bottom' });

捲動到頂部並帶個偏移值：

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ scrollTop: value });

捲動到底部並帶個偏移值：

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ scrollBottom: value });

捲動一個元素：

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ scrollTo: $('#a_node') });

停止滾動操作。這個選項將會使捲軸外掛程式的所有綁定事件無效，並在UI上隱藏捲軸。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ stop: true });

destroy

銷毀nanoScroller捲軸並將捲軸重設為瀏覽器原生捲軸：

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ destroy: true });

設定滾動條閃動，閃動時間由參數來設定（預設1.5秒）。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ flash: true });

nanoScroller();

刷新捲軸。此操作會簡單的重新計算滾動條的位置和高度：

複製程式碼 程式碼如下:

$(".nano").nanoScroller();

自訂事件

scrollend

一個自訂的 scrollend 事件會在每次捲軸滾動到容器底部時觸發。 （當滾動條已經到達容器底部，用戶再次滾動時不會觸發該事件）

複製程式碼 程式碼如下:

$(".nano").bind("scrollend", function(e){
    console.log("current HTMLDivElement", e.currentTarget);
});

有些瀏覽器會在同一時間多次觸發該事件，所以應該使用jQuery .bind 或 .on 來綁定該事件。你可以使用 jquery-debounce 外掛程式來讓瀏覽器每隔100毫秒才觸發一次該事件：

複製程式碼 程式碼如下:

$(".nano").debounce("scrollend", function() {
    alert("The end");
}, 100);

scrolltop

和 scrollend 事件相同，它是每次使用者滾動到容器的頂部時觸發。

和 scrollend 事件和 scrolltop 事件相同，它在使用者每次捲動時觸發。此事件附帶滾動條當前位置、最大高度和方向（ up 或 down ）的js物件參數:

複製程式碼 程式碼如下:

$(".nano").on("update", function(event, values){
    console.debug( values );
});

設定參數

這個捲軸插件中有一組參數可以使用：

iOSNativeScrolling

如果你希望在 iOS 5 中使用原生的捲軸，可以設定為 true 。在 iOS 5 中原生的捲軸會運作的更好。

注意當 iOSNativeScrolling 設定為 true 時， .pane 和 .slider 不會被裝置產生/新增來支援原生的捲軸。

預設值 ：false。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ iOSNativeScrolling: true });

sliderMinHeight

設定滾動元素的最小高度：

預設值 ：20。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ sliderMinHeight: 40 })

sliderMaxHeight

設定滾動元素的最大高度：

預設值 ：null。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ sliderMaxHeight: 200 });

preventPageScrolling

設定為 true 時可以在容器內容捲動到頂部或底部時阻止頁面捲動：

預設值 ：false。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ preventPageScrolling: true });

disableResize

設定為 true 阻止nanoscroller改變大小。如果你設定該選項為 true ，記得要呼叫reset方法，否則會產生奇怪的問題：

預設值 ：false。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ disableResize: true });

alwaysVisible

設定為 true 關閉捲軸停止時自動隱藏功能：

預設值 ：false。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ alwaysVisible: true });

flashDelay

當你開啟 flash 選項時，這個選項用來指定閃爍的延遲：

預設值 ：1500。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ flashDelay: 1000 });

paneClass

捲動條track元素的class名稱。如果你修改了它，需要在CSS檔案中做相應的修改：

預設值 ： 'nano-pane'。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ sliderClass: 'scrollSlider' });

contentClass

捲軸容器div的class名稱。如果你修改了它，需要在CSS檔案中做相應的修改：

預設值 ： 'nano-content'。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ contentClass: 'sliderContent' });

tabIndex

設定可捲動內容的順序，設定為-1時使用tab鍵會跳過該內容：

預設值 ：0。

複製程式碼 程式碼如下:

$(".nano").nanoScroller({ tabIndex: 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：

複製程式碼 程式碼如下:

   

... content here ... 

以上就是關於nanoscroller外掛的使用方法，希望大家能夠喜歡。