angular nicescroll的使用方式及详细配置参数

这个插件是使jquery-nicescroll在angularjs中不用写一行代码就能使用。

This directive is for jquery-nicescroll in angular js whithout writing single line of javascript code。

本文翻译自https://github.com/tushariscoolster/angular-nicescroll

使用：

1.现在你的模块中添加依赖

var app=angular.module("you app name",['angular-nicescroll'])

2.使用angular指令

<div class="my-scroll-area" ng-nicescroll nice-option="{cursorcolor: '#e2edff'}" nice-scroll-top-end="topEndComplete()" nice-scroll-end="endScroll()">

说明：

选项options:

{
    cursorcolor: "#424242", // 滚动条光标的颜色 change cursor color in hex
    cursoropacitymin: 0, // 滚动条在不激活状态下的透明度，默认是0 change opacity when cursor is inactive (scrollabar "hidden" state), range from 1 to 0
    cursoropacitymax: 1, //滚动条在激活状态下的透明度，默认是1 change opacity when cursor is active (scrollabar "visible" state), range from 1 to 0
    cursorwidth: "5px", // 滚动条宽度 cursor width in pixel (you can also write "5px")
    cursorborder: "1px solid #fff", //用css定义滚动条的边框 css definition for cursor border
    cursorborderradius: "5px", //滚动条的圆角半径 border radius in pixel for cursor
    zindex: "auto" | <number>, //改变滚动条div的z-index的值 change z-index for scrollbar div
    scrollspeed: 60, // 滚动速度
    mousescrollstep: 40, //使用鼠标轮滚的时候的滚动速度 scrolling speed with mouse wheel (pixel)
    touchbehavior: false, //在桌面电脑上启用光标拖动，就像触摸设备那样 enable cursor-drag scrolling like touch devices in desktop computer
    hwacceleration: true, //如果设备支持，则启用硬件加速 use hardware accelerated scroll when supported
    boxzoom: false, //给盒子的内容启用放大缩小功能 enable zoom for box content
    dblclickzoom: true, //双击放大，在boxzoom=true的情况下 (only when boxzoom=true) zoom activated when double click on box
    gesturezoom: true, //手势放大缩小，在boxzoom=true的情况下 (only when boxzoom=true and with touch devices) zoom activated when pinch out/in on box
    grabcursorenabled: true //这个可以禁用"grab"鼠标光标 (only when touchbehavior=true) display "grab" icon
    autohidemode: true, //设置在什么情况下隐藏scrollbar。 how hide the scrollbar works, possible values: 
      true | // 在不滚动情况下隐藏。 hide when no scrolling
      "cursor" | //只隐藏光标 only cursor hidden
      false | //始终不隐藏 do not hide,
      "leave" | //只在鼠标离开内容区是隐藏 hide only if pointer leaves content
      "hidden" | //使用隐藏 hide always
      "scroll", //只在滚动的情况下显示，在不滚动的时候隐藏 show only on scroll          
    background: "", //设置背景颜色 change css for rail background
    iframeautoresize: true, //在iframe的load事件中自动设置大小 autoresize iframe on load event
    cursorminheight: 32, //设置最小的光标高度 set the minimum cursor height (pixel)
    preservenativescrolling: true, //这个设置通过事件冒泡的方式使你能够滚动原生的滚动条。 you can scroll native scrollable areas with mouse, bubbling mouse wheel event
    railoffset: false, //设置轨道的上或者左的偏移 you can add offset top/left for rail position
    bouncescroll: false, //启用向手机上面的那种滚动回弹 (only hw accell) enable scroll bouncing at the end of content as mobile-like 
    spacebarenabled: true, // enable page down scrolling when space bar has pressed
    railpadding: { top: 0, right: 0, left: 0, bottom: 0 }, //设置轨道的内间距 set padding for rail bar
    disableoutline: true, //在chrome浏览器上选择一个div使用nicescroll时禁用outline， for chrome browser, disable outline (orange highlight) when selecting a div with nicescroll
    horizrailenabled: true, //设置是否处理水平滚动 nicescroll can manage horizontal scroll
    railalign: right, //垂直对齐方式 alignment of vertical rail
    railvalign: bottom, //水平对齐方式 alignment of horizontal rail
    enabletranslate3d: true, //设置nicescroll是否使用css translate去滚动内容 nicescroll can use css translate to scroll content
    enablemousewheel: true, //设置是否响应鼠标滚动事件 nicescroll can manage mouse wheel events
    enablekeyboard: true, //设置是否响应键盘事件 nicescroll can manage keyboard events
    smoothscroll: true, //使用平滑滚动 scroll with ease movement
    sensitiverail: true, //在轨道上点击时是否滚动 click on rail make a scroll
    enablemouselockapi: true, // can use mouse caption lock API (same issue on object dragging)
    cursorfixedheight: false, //给光标设置固定的高度 set fixed height for cursor in pixel
    hidecursordelay: 400, //设置隐藏光标的延迟时间，单位是毫秒 set the delay in microseconds to fading out scrollbars
    directionlockdeadzone: 6, // dead zone in pixels for direction lock activation
    nativeparentscrolling: true, //检测内容的底部和父节点是否允许滚动，像原生滚动条的实现方式 detect bottom of content and let parent to scroll, as native scroll does
    enablescrollonselection: true, //在选择文字的时候自动滚动内容 enable auto-scrolling of content when selection text
    cursordragspeed: 0.3, //当拖动光标时候的速度 speed of selection when dragged with cursor
    rtlmode: "auto", //设置水平滚动div的起始边是左还是右 horizontal div scrolling starts at left side
    cursordragontouch: false, //设置在触摸模式下，是否可以拖动光标就可以滚动 drag cursor in touch / touchbehavior mode also
    oneaxismousemode: "auto", //设置鼠标滚轮在只有水平模式的情况下是否可用 it permits horizontal scrolling with mousewheel on horizontal only content, if false (vertical-only) mousewheel don't scroll horizontally, if value is auto detects two-axis mouse
    scriptpath: "" //设置box模式下图标的路径，设成""表示和script是同一个路径 define custom path for boxmode icons ("" => same script path)
    preventmultitouchscrolling: true //防止在多点触摸情况下滚动 prevent scrolling on multitouch events
}