jquery.slimscroll.js 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470
  1. /*! Copyright (c) 2011 Piotr Rochala (http://rocha.la)
  2. * Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php)
  3. * and GPL (http://www.opensource.org/licenses/gpl-license.php) licenses.
  4. *
  5. * Version: 1.3.6
  6. *
  7. */
  8. (function($) {
  9. $.fn.extend({
  10. slimScroll: function(options) {
  11. var defaults = {
  12. // width in pixels of the visible scroll area
  13. width : 'auto',
  14. // height in pixels of the visible scroll area
  15. height : '250px',
  16. // width in pixels of the scrollbar and rail
  17. size : '7px',
  18. // scrollbar color, accepts any hex/color value
  19. color: '#000',
  20. // scrollbar position - left/right
  21. position : 'right',
  22. // distance in pixels between the side edge and the scrollbar
  23. distance : '1px',
  24. // default scroll position on load - top / bottom / $('selector')
  25. start : 'top',
  26. // sets scrollbar opacity
  27. opacity : .4,
  28. // enables always-on mode for the scrollbar
  29. alwaysVisible : false,
  30. // check if we should hide the scrollbar when user is hovering over
  31. disableFadeOut : false,
  32. // sets visibility of the rail
  33. railVisible : false,
  34. // sets rail color
  35. railColor : '#333',
  36. // sets rail opacity
  37. railOpacity : .2,
  38. // whether we should use jQuery UI Draggable to enable bar dragging
  39. railDraggable : true,
  40. // defautlt CSS class of the slimscroll rail
  41. railClass : 'slimScrollRail',
  42. // defautlt CSS class of the slimscroll bar
  43. barClass : 'slimScrollBar',
  44. // defautlt CSS class of the slimscroll wrapper
  45. wrapperClass : 'slimScrollDiv',
  46. // check if mousewheel should scroll the window if we reach top/bottom
  47. allowPageScroll : false,
  48. // scroll amount applied to each mouse wheel step
  49. wheelStep : 20,
  50. // scroll amount applied when user is using gestures
  51. touchScrollStep : 200,
  52. // sets border radius
  53. borderRadius: '7px',
  54. // sets border radius of the rail
  55. railBorderRadius : '7px'
  56. };
  57. var o = $.extend(defaults, options);
  58. // do it for every element that matches selector
  59. this.each(function(){
  60. var isOverPanel, isOverBar, isDragg, queueHide, touchDif,
  61. barHeight, percentScroll, lastScroll,
  62. divS = '<div></div>',
  63. minBarHeight = 30,
  64. releaseScroll = false;
  65. // used in event handlers and for better minification
  66. var me = $(this);
  67. // ensure we are not binding it again
  68. if (me.parent().hasClass(o.wrapperClass))
  69. {
  70. // start from last bar position
  71. var offset = me.scrollTop();
  72. // find bar and rail
  73. bar = me.closest('.' + o.barClass);
  74. rail = me.closest('.' + o.railClass);
  75. getBarHeight();
  76. // check if we should scroll existing instance
  77. if ($.isPlainObject(options))
  78. {
  79. // Pass height: auto to an existing slimscroll object to force a resize after contents have changed
  80. if ( 'height' in options && options.height == 'auto' ) {
  81. me.parent().css('height', 'auto');
  82. me.css('height', 'auto');
  83. var height = me.parent().parent().height();
  84. me.parent().css('height', height);
  85. me.css('height', height);
  86. }
  87. if ('scrollTo' in options)
  88. {
  89. // jump to a static point
  90. offset = parseInt(o.scrollTo);
  91. }
  92. else if ('scrollBy' in options)
  93. {
  94. // jump by value pixels
  95. offset += parseInt(o.scrollBy);
  96. }
  97. else if ('destroy' in options)
  98. {
  99. // remove slimscroll elements
  100. bar.remove();
  101. rail.remove();
  102. me.unwrap();
  103. return;
  104. }
  105. // scroll content by the given offset
  106. scrollContent(offset, false, true);
  107. }
  108. return;
  109. }
  110. else if ($.isPlainObject(options))
  111. {
  112. if ('destroy' in options)
  113. {
  114. return;
  115. }
  116. }
  117. // optionally set height to the parent's height
  118. o.height = (o.height == 'auto') ? me.parent().height() : o.height;
  119. // wrap content
  120. var wrapper = $(divS)
  121. .addClass(o.wrapperClass)
  122. .css({
  123. position: 'relative',
  124. overflow: 'hidden',
  125. width: o.width,
  126. height: o.height
  127. });
  128. // update style for the div
  129. me.css({
  130. overflow: 'hidden',
  131. width: o.width,
  132. height: o.height
  133. });
  134. // create scrollbar rail
  135. var rail = $(divS)
  136. .addClass(o.railClass)
  137. .css({
  138. width: o.size,
  139. height: '100%',
  140. position: 'absolute',
  141. top: 0,
  142. display: (o.alwaysVisible && o.railVisible) ? 'block' : 'none',
  143. 'border-radius': o.railBorderRadius,
  144. background: o.railColor,
  145. opacity: o.railOpacity,
  146. zIndex: 90
  147. });
  148. // create scrollbar
  149. var bar = $(divS)
  150. .addClass(o.barClass)
  151. .css({
  152. background: o.color,
  153. width: o.size,
  154. position: 'absolute',
  155. top: 0,
  156. opacity: o.opacity,
  157. display: o.alwaysVisible ? 'block' : 'none',
  158. 'border-radius' : o.borderRadius,
  159. BorderRadius: o.borderRadius,
  160. MozBorderRadius: o.borderRadius,
  161. WebkitBorderRadius: o.borderRadius,
  162. zIndex: 99
  163. });
  164. // set position
  165. var posCss = (o.position == 'right') ? { right: o.distance } : { left: o.distance };
  166. rail.css(posCss);
  167. bar.css(posCss);
  168. // wrap it
  169. me.wrap(wrapper);
  170. // append to parent div
  171. me.parent().append(bar);
  172. me.parent().append(rail);
  173. // make it draggable and no longer dependent on the jqueryUI
  174. if (o.railDraggable){
  175. bar.bind("mousedown", function(e) {
  176. var $doc = $(document);
  177. isDragg = true;
  178. t = parseFloat(bar.css('top'));
  179. pageY = e.pageY;
  180. $doc.bind("mousemove.slimscroll", function(e){
  181. currTop = t + e.pageY - pageY;
  182. bar.css('top', currTop);
  183. scrollContent(0, bar.position().top, false);// scroll content
  184. });
  185. $doc.bind("mouseup.slimscroll", function(e) {
  186. isDragg = false;hideBar();
  187. $doc.unbind('.slimscroll');
  188. });
  189. return false;
  190. }).bind("selectstart.slimscroll", function(e){
  191. e.stopPropagation();
  192. e.preventDefault();
  193. return false;
  194. });
  195. }
  196. // on rail over
  197. rail.hover(function(){
  198. showBar();
  199. }, function(){
  200. hideBar();
  201. });
  202. // on bar over
  203. bar.hover(function(){
  204. isOverBar = true;
  205. }, function(){
  206. isOverBar = false;
  207. });
  208. // show on parent mouseover
  209. me.hover(function(){
  210. isOverPanel = true;
  211. showBar();
  212. hideBar();
  213. }, function(){
  214. isOverPanel = false;
  215. hideBar();
  216. });
  217. // support for mobile
  218. me.bind('touchstart', function(e,b){
  219. if (e.originalEvent.touches.length)
  220. {
  221. // record where touch started
  222. touchDif = e.originalEvent.touches[0].pageY;
  223. }
  224. });
  225. me.bind('touchmove', function(e){
  226. // prevent scrolling the page if necessary
  227. if(!releaseScroll)
  228. {
  229. e.originalEvent.preventDefault();
  230. }
  231. if (e.originalEvent.touches.length)
  232. {
  233. // see how far user swiped
  234. var diff = (touchDif - e.originalEvent.touches[0].pageY) / o.touchScrollStep;
  235. // scroll content
  236. scrollContent(diff, true);
  237. touchDif = e.originalEvent.touches[0].pageY;
  238. }
  239. });
  240. // set up initial height
  241. getBarHeight();
  242. // check start position
  243. if (o.start === 'bottom')
  244. {
  245. // scroll content to bottom
  246. bar.css({ top: me.outerHeight() - bar.outerHeight() });
  247. scrollContent(0, true);
  248. }
  249. else if (o.start !== 'top')
  250. {
  251. // assume jQuery selector
  252. scrollContent($(o.start).position().top, null, true);
  253. // make sure bar stays hidden
  254. if (!o.alwaysVisible) { bar.hide(); }
  255. }
  256. // attach scroll events
  257. attachWheel(this);
  258. function _onWheel(e)
  259. {
  260. // use mouse wheel only when mouse is over
  261. if (!isOverPanel) { return; }
  262. var e = e || window.event;
  263. var delta = 0;
  264. if (e.wheelDelta) { delta = -e.wheelDelta/120; }
  265. if (e.detail) { delta = e.detail / 3; }
  266. var target = e.target || e.srcTarget || e.srcElement;
  267. if ($(target).closest('.' + o.wrapperClass).is(me.parent())) {
  268. // scroll content
  269. scrollContent(delta, true);
  270. }
  271. // stop window scroll
  272. if (e.preventDefault && !releaseScroll) { e.preventDefault(); }
  273. if (!releaseScroll) { e.returnValue = false; }
  274. }
  275. function scrollContent(y, isWheel, isJump)
  276. {
  277. releaseScroll = false;
  278. var delta = y;
  279. var maxTop = me.outerHeight() - bar.outerHeight();
  280. if (isWheel)
  281. {
  282. // move bar with mouse wheel
  283. delta = parseInt(bar.css('top')) + y * parseInt(o.wheelStep) / 100 * bar.outerHeight();
  284. // move bar, make sure it doesn't go out
  285. delta = Math.min(Math.max(delta, 0), maxTop);
  286. // if scrolling down, make sure a fractional change to the
  287. // scroll position isn't rounded away when the scrollbar's CSS is set
  288. // this flooring of delta would happened automatically when
  289. // bar.css is set below, but we floor here for clarity
  290. delta = (y > 0) ? Math.ceil(delta) : Math.floor(delta);
  291. // scroll the scrollbar
  292. bar.css({ top: delta + 'px' });
  293. }
  294. // calculate actual scroll amount
  295. percentScroll = parseInt(bar.css('top')) / (me.outerHeight() - bar.outerHeight());
  296. delta = percentScroll * (me[0].scrollHeight - me.outerHeight());
  297. if (isJump)
  298. {
  299. delta = y;
  300. var offsetTop = delta / me[0].scrollHeight * me.outerHeight();
  301. offsetTop = Math.min(Math.max(offsetTop, 0), maxTop);
  302. bar.css({ top: offsetTop + 'px' });
  303. }
  304. // scroll content
  305. me.scrollTop(delta);
  306. // fire scrolling event
  307. me.trigger('slimscrolling', ~~delta);
  308. // ensure bar is visible
  309. showBar();
  310. // trigger hide when scroll is stopped
  311. hideBar();
  312. }
  313. function attachWheel(target)
  314. {
  315. if (window.addEventListener)
  316. {
  317. target.addEventListener('DOMMouseScroll', _onWheel, false );
  318. target.addEventListener('mousewheel', _onWheel, false );
  319. }
  320. else
  321. {
  322. document.attachEvent("onmousewheel", _onWheel)
  323. }
  324. }
  325. function getBarHeight()
  326. {
  327. // calculate scrollbar height and make sure it is not too small
  328. barHeight = Math.max((me.outerHeight() / me[0].scrollHeight) * me.outerHeight(), minBarHeight);
  329. bar.css({ height: barHeight + 'px' });
  330. // hide scrollbar if content is not long enough
  331. var display = barHeight == me.outerHeight() ? 'none' : 'block';
  332. bar.css({ display: display });
  333. }
  334. function showBar()
  335. {
  336. // recalculate bar height
  337. getBarHeight();
  338. clearTimeout(queueHide);
  339. // when bar reached top or bottom
  340. if (percentScroll == ~~percentScroll)
  341. {
  342. //release wheel
  343. releaseScroll = o.allowPageScroll;
  344. // publish approporiate event
  345. if (lastScroll != percentScroll)
  346. {
  347. var msg = (~~percentScroll == 0) ? 'top' : 'bottom';
  348. me.trigger('slimscroll', msg);
  349. }
  350. }
  351. else
  352. {
  353. releaseScroll = false;
  354. }
  355. lastScroll = percentScroll;
  356. // show only when required
  357. if(barHeight >= me.outerHeight()) {
  358. //allow window scroll
  359. releaseScroll = true;
  360. return;
  361. }
  362. bar.stop(true,true).fadeIn('fast');
  363. if (o.railVisible) { rail.stop(true,true).fadeIn('fast'); }
  364. }
  365. function hideBar()
  366. {
  367. // only hide when options allow it
  368. if (!o.alwaysVisible)
  369. {
  370. queueHide = setTimeout(function(){
  371. if (!(o.disableFadeOut && isOverPanel) && !isOverBar && !isDragg)
  372. {
  373. bar.fadeOut('slow');
  374. rail.fadeOut('slow');
  375. }
  376. }, 1000);
  377. }
  378. }
  379. });
  380. // maintain chainability
  381. return this;
  382. }
  383. });
  384. $.fn.extend({
  385. slimscroll: $.fn.slimScroll
  386. });
  387. })(jQuery);