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 依然是個不錯的選擇。