想要讓網頁的滾動條呈現 Mac OS X Lion 那種簡約細緻的風格嗎?nanoScrollerJS 是一款能以簡單方式實現該效果的 jQuery 外掛。它利用原生滾動條,因此在 iPad、iPhone 與部分 Android 平板裝置上也能順暢運作。本文將完整介紹它的使用方式、進階方法與配置參數。
該外掛運作所需的最小 HTML 結構如下:
<div id="about" class="nano">
<div class="nano-content"> ... 內容在這裡 ... </div>
</div>
其中 .pane 與 .nano-slider 等滾動條元素會在外掛運行時動態產生。nano 與 nano-content 的 class 名稱可透過參數更改,但更改後 CSS 檔案也需相應調整。
在 HTML 的 <header> 中引入 nanoscroller.css,並為容器指定寬高與基本樣式:
<link rel="stylesheet" href="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; }
引入 jquery.nanoscroller.js 後,用下面的方法呼叫,所有帶有 .nano 的元素都會套用該效果:
<script type="text/javascript" src="js/jquery.nanoscroller.js"></script>
$(".nano").nanoScroller();
// 滾動到頂部
$(".nano").nanoScroller({ scroll: 'top' });
// 滾動到底部
$(".nano").nanoScroller({ scroll: 'bottom' });
// 滾動到頂部並帶偏移值
$(".nano").nanoScroller({ scrollTop: value });
// 滾動到指定元素
$(".nano").nanoScroller({ scrollTo: $('#a_node') });
// 停止滾動操作,隱藏滾動條
$(".nano").nanoScroller({ stop: true });
// 銷毀外掛並還原為原生滾動條
$(".nano").nanoScroller({ destroy: true });
// 閃動滾動條(閃動時間由參數設定)
$(".nano").nanoScroller({ flash: true });
// 刷新滾動條,重新計算位置與高度
$(".nano").nanoScroller();
scrollend:每次滾動到達容器底部時觸發。由於部分瀏覽器會同時觸發多次,建議搭配 jquery-debounce 外掛來節流:
$(".nano").debounce("scrollend", function() {
alert("The end");
}, 100);
scrolltop:每次滾動到容器頂部時觸發。
update:每次滾動時觸發,附帶當前位置、最大高度與方向資訊:
$(".nano").on("update", function(event, values) {
console.debug(values);
});
桌面裝置支援 IE7+、Firefox 3+、Chrome、Safari 4+ 與 Opera 11.60+;行動裝置支援 iOS 5+、Android Firefox 等。若要在行動瀏覽器上獲得更佳體驗,可以搭配 overthrow.js 來模擬 CSS 的 overflow 行為,只需引入該檔案並在內容 div 上加上 overthrow class 即可。