首頁 >web前端 >js教程 >jQuery的捲軸插件Nicescroll是如何使用的?

jQuery的捲軸插件Nicescroll是如何使用的?

伊谢尔伦
伊谢尔伦原創
2017-07-19 16:11:131800瀏覽

Nicescroll滾動條插件是一個非常強大的基於jQuery的滾動條插件,不需要增加額外的css,幾乎全瀏覽器相容。 ie6+,實作只需要一段程式碼,侵入性非常小,樣式可完全自訂,支援觸控事件,可在觸控螢幕上使用。

引入核心文件,外掛程式需要引入1.5.X以上版本的jquery庫

最簡單的用法如下:


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

注意:一定要放在$(document).ready 中進行初始化!

隱藏捲軸


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

偵測捲軸是否重置大小(當視窗改變大小時)


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

捲動到某個位置


$("#myp").getNiceScroll(0).doScrollLeft(x, duration); // Scroll X Axis
$("#myp").getNiceScroll(0).doScrollTop(y, duration); // Scroll Y Axis

可增加各種參數


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

配置參數表


$("#thisp").niceScroll({
    cursorcolor: "#424242", // 改变滚动条颜色,使用16进制颜色值
    cursoropacitymin: 0, // 当滚动条是隐藏状态时改变透明度, 值范围 1 到 0
    cursoropacitymax: 1, // 当滚动条是显示状态时改变透明度, 值范围 1 到 0
    cursorwidth: "5px", // 滚动条的宽度,单位:便素
    cursorborder: "1px solid #fff", // CSS方式定义滚动条边框
    cursorborderradius: "5px", // 滚动条圆角(像素)
    zindex: "auto" | <number>, // 改变滚动条的p的z-index值
    scrollspeed: 60, // 滚动速度
    mousescrollstep: 40, // 鼠标滚轮的滚动速度 (像素)
    touchbehavior: false, // 激活拖拽滚动
    hwacceleration: true, // 激活硬件加速
    boxzoom: false, // 激活放大box的内容
    dblclickzoom: true, // (仅当 boxzoom=true时有效)双击box时放大
    gesturezoom: true, // (仅 boxzoom=true 和触屏设备时有效) 激活变焦当out/in(两个手指外张或收缩)
    grabcursorenabled: true // (仅当 touchbehavior=true) 显示“抓住”图标display "grab" icon
    autohidemode: true, // 隐藏滚动条的方式, 可用的值: 
     true | // 无滚动时隐藏
     "cursor" | // 隐藏
     false | // 不隐藏,
     "leave" | // 仅在指针离开内容时隐藏
     "hidden" | // 一直隐藏
     "scroll", // 仅在滚动时显示    
    background: "", // 轨道的背景颜色
    iframeautoresize: true, // 在加载事件时自动重置iframe大小
    cursorminheight: 32, // 设置滚动条的最小高度 (像素)
    preservenativescrolling: true, // 你可以用鼠标滚动可滚动区域的滚动条和增加鼠标滚轮事件
    railoffset: false, // 可以使用top/left来修正位置
    bouncescroll: false, // (only hw accell) 启用滚动跳跃的内容移动
    spacebarenabled: true, // 当按下空格时使页面向下滚动
    railpadding: { top: 0, right: 0, left: 0, bottom: 0 }, // 设置轨道的内间距
    disableoutline: true, // 当选中一个使用nicescroll的p时,chrome浏览器中禁用outline
    horizrailenabled: true, // nicescroll可以管理水平滚动
    railalign: right, // 对齐垂直轨道
    railvalign: bottom, // 对齐水平轨道
    enabletranslate3d: true, // nicescroll 可以使用CSS变型来滚动内容
    enablemousewheel: true, // nicescroll可以管理鼠标滚轮事件
    enablekeyboard: true, // nicescroll可以管理键盘事件
    smoothscroll: true, // ease动画滚动
    sensitiverail: true, // 单击轨道产生滚动
    enablemouselockapi: true, // 可以用鼠标锁定API标题 (类似对象拖动)
    cursorfixedheight: false, // 修正光标的高度(像素)
    hidecursordelay: 400, // 设置滚动条淡出的延迟时间(毫秒)
    directionlockdeadzone: 6, // 设定死区,为激活方向锁定(像素)
    nativeparentscrolling: true, // 检测内容底部便于让父级滚动
    enablescrollonselection: true, // 当选择文本时激活内容自动滚动
    cursordragspeed: 0.3, // 设置拖拽的速度
    rtlmode: "auto", // p的水平滚动从左边开始
    cursordragontouch: false, // 使用触屏模式来实现拖拽
    oneaxismousemode: "auto", // 当只有水平滚动时可以用鼠标滚轮来滚动,如果设为false则不支持水平滚动,如果设为auto支持双轴滚动
    scriptpath: "" // 为boxmode图片自定义路径 ("" => same script path)
    preventmultitouchscrolling: true // 防止多触点事件引发滚动
  });

#另外注意:當在同一頁中使用多個nicescroll外掛程式時,要及時隱藏用完的nicescroll對象,載入時,需要先show,再resize。

當外掛程式放在具有absolute浮動的容器中,並設定了top值時,外掛程式的top會出現問題,解決方法使用外掛程式的railoffset屬性:


railoffset, you can add offset top/left for rail position (default:false)

以上是jQuery的捲軸插件Nicescroll是如何使用的?的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn