DIV CSS 佈局教程網

Nicescroll 滾動條插件用法整理:初始化、常用方法與參數速查
編輯:JQuery入門技巧     

Nicescroll 是一個基於 jQuery 的強力滾動條插件,最大特點是不需要額外撰寫 CSS、幾乎全瀏覽器兼容(含 IE6+)、初始化只需一行代碼、侵入性極小,樣式可完全自定義,並支持觸摸事件,能在觸屏上正常使用。

官網地址:https://www.areaaperta.com/nicescroll/

引入與最簡單用法

引入核心 JS 文件即可,插件要求 jQuery 1.5.x 以上版本。

$(document).ready(function () {
    $("html").niceScroll();
});

注意:一定要放在 $(document).ready 中初始化,否則可能取不到正確的容器尺寸。

常用方法

隱藏滾動條:

$("#mydiv").getNiceScroll().hide();

窗口尺寸變化時重置大小:

$("#mydiv").getNiceScroll().resize();

滾動到指定位置:

$("#mydiv").getNiceScroll(0).doScrollLeft(x, duration);   // 水平滾動
$("#mydiv").getNiceScroll(0).doScrollTop(y, duration);    // 垂直滾動

帶參數初始化:

$(document).ready(function () {
    $("#thisdiv").niceScroll({ cursorcolor: "#00F" });
});

參數速查

$("#thisdiv").niceScroll({
    cursorcolor: "#424242",          // 滾動條顏色,16 進制
    cursoropacitymin: 0,             // 隱藏狀態時的透明度(0-1)
    cursoropacitymax: 1,             // 顯示狀態時的透明度(0-1)
    cursorwidth: "5px",              // 滾動條寬度
    cursorborder: "1px solid #fff",  // CSS 方式定義滾動條邊框
    cursorborderradius: "5px",       // 滾動條圓角(像素)
    zindex: "auto",                  // 滾動條 div 的 z-index
    scrollspeed: 60,                 // 滾動速度
    mousescrollstep: 40,             // 滑鼠滾輪的滾動速度(像素)
    touchbehavior: false,            // 激活拖拽滾動(觸屏優化)
    hwacceleration: true,            // 激活硬件加速
    boxzoom: false,                  // 激活內容框放大
    dblclickzoom: true,              // 雙擊放大(僅 boxzoom=true 時有效)
    gesturezoom: true,               // 變焦縮放(僅 boxzoom 且觸屏設備)
    grabcursorenabled: true,         // 顯示「抓取」游標(僅 touchbehavior=true)
    autohidemode: true,              // 隱藏方式:true | "cursor" | false | "leave" | "hidden" | "scroll"
    background: "",                  // 軌道背景顏色
    iframeautoresize: true,          // 加載時自動重置 iframe 大小
    cursorminheight: 32,             // 滾動條最小高度(像素)
    preservenativescrolling: true,   // 保留原生滾動與滑鼠滾輪事件
    railoffset: false,               // 用 top/left 修正軌道位置
    bouncescroll: false,             // 啟用滾動回彈
    spacebarenabled: true,           // 按空格向下滾動
    railpadding: { top: 0, right: 0, left: 0, bottom: 0 },  // 軌道內間距
    disableoutline: true,            // 選中時禁用 Chrome 的 outline
    horizrailenabled: true,          // 允許水平滾動
    railalign: "right",              // 垂直軌道對齊方式
    railvalign: "bottom",            // 水平軌道對齊方式
    enabletranslate3d: true,         // 用 CSS 變形滾動內容
    enablemousewheel: true,          // 管理滑鼠滾輪事件
    enablekeyboard: true,            // 管理鍵盤事件
    smoothscroll: true,              // 平滑動畫滾動
    sensitiverail: true,             // 單擊軌道產生滾動
    enablemouselockapi: true,        // 啟用滑鼠鎖定 API(類似對象拖動)
    cursorfixedheight: false,        // 修正游標高度(像素)
    hidecursordelay: 400,            // 滾動條淡出延遲(毫秒)
    directionlockdeadzone: 6,        // 方向鎖定死區(像素)
    nativeparentscrolling: true,     // 檢測內容底部以便父級滾動
    enablescrollonselection: true,   // 選中文本時自動滾動
    cursordragspeed: 0.3,            // 拖拽速度
    rtlmode: "auto",                 // 水平滾動是否從左開始
    cursordragontouch: false,        // 用觸屏模式實現拖拽
    oneaxismousemode: "auto",        // 單軸滾動時的滑鼠滾輪行為
    scriptpath: "",                  // boxzoom 模式下的圖片路徑
    preventmultitouchscrolling: true // 防止多觸點事件引發滾動
});

兩個實戰中容易忽略的注意事項

第一,同頁面多用實例要及時清理。在同一頁面中使用多個 nicescroll 實例時,用完的對象要及時 hide,加載時需要先 show 再 resize,否則會出現滾動條位置錯亂或重疊。

第二,absolute 定位容器中的 top 錯位。當插件放在設定了 top 值的 absolute 容器中時,滾動條的 top 會出問題。解法是使用插件的 railoffset 參數手動修正:

// railoffset: 可為軌道位置加上 top/left 偏移(預設 false)
$("#mydiv").niceScroll({ railoffset: { top: -20, left: 0 } });

什麼時候該用它,什麼時候不該

適合用:需要美觀自定義滾動條、內部滾動區域較多(如聊天窗口、公告列表、代碼框)、需要觸屏支持的老項目。

不建議用:追求極致性能的頁面(JS 模擬滾動會犧牲一部分流暢度與原生手感)、需要與瀏覽器內置查找/自動翻滾功能良好協同的場景。現代項目中,直接用 CSS 的 ::-webkit-scrollbar 或標準的 scrollbar-width / scrollbar-color 往往就能滿足需求,且零 JS 成本。若必須跨瀏覽器統一外觀,Nicescroll 依然是個不錯的選擇。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved