Added top/bottom notification events

Added events to notify when scrollbar reached top or bottom of the
parent container. $(container).bind('slimscroll') can be used to
subscribe to events.

Author: rochal

index.htm

@@ -44,7 +44,7 @@ <h2>Facebook-like jQuery Scrollbar</h1>
 <hr />
 	  <table>
 		  <tr><td valign="top">
-	<h2>start at the element offsetTop test</h2>
+	<h2>start at the element offsetTop test & top/bottom events</h2>
 	  <div id="test1a">
 		<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam rhoncus, felis interdum condimentum consectetur, nisl libero elementum eros, vehicula congue lacus eros non diam. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Vivamus mauris lorem, lacinia id tempus non, imperdiet et leo. Cras sit amet erat sit amet lacus egestas placerat. Aenean ultricies ultrices mauris ac congue. In vel tortor vel velit tristique tempus ac id nisi. Proin quis lorem velit. Nunc dui dui, blandit a ullamcorper vitae, congue fringilla lectus. Aliquam ultricies malesuada feugiat. Vestibulum placerat turpis et eros lobortis vel semper sapien pulvinar.</p>
 		<p>Pellentesque rhoncus aliquet porta. Sed vel magna eu turpis pharetra consequat ut vitae lectus. In molestie sollicitudin mi sit amet convallis. Aliquam erat volutpat. Nullam feugiat placerat ipsum eget malesuada. Nulla facilisis nunc non dolor vehicula pretium. Sed dui magna, sodales id pharetra non, ullamcorper eu sapien. Mauris ac consectetur leo. Mauris consequat, lectus ut bibendum pulvinar, leo magna feugiat enim, eu commodo lacus sem vel ante. Sed tempus metus eget leo mollis vulputate. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.</p>
@@ -54,8 +54,9 @@ <h2>start at the element offsetTop test</h2>
 		<p>Nulla rhoncus elementum convallis. Mauris condimentum aliquet egestas. Ut iaculis nisi eget tellus accumsan venenatis. Maecenas imperdiet aliquam porta. Aenean ultrices dolor sed quam laoreet varius. Curabitur condimentum blandit erat, quis accumsan eros interdum vitae. Curabitur ligula arcu, sollicitudin vitae iaculis sed, blandit sit amet enim. Morbi ullamcorper, metus vel mollis tristique, arcu turpis malesuada nisi, at dignissim lorem odio a orci. Proin ultrices, ipsum ut vestibulum interdum, libero felis auctor mi, vitae convallis nisl justo ac tellus. Integer nec lacinia turpis. Etiam massa nisl, rhoncus quis rutrum in, pretium eu leo. Proin a velit ut nulla laoreet vestibulum. Curabitur eu elit vitae felis auctor tincidunt. Curabitur tincidunt, metus sed sollicitudin cursus, quam elit commodo erat, ut tempor erat sapien vitae velit. Morbi nec viverra erat.</p>
 		<p>Nullam scelerisque facilisis pretium. Vivamus lectus leo, commodo ac sagittis ac, dictum a mi. Donec quis massa ut libero malesuada commodo in et risus. Fusce nunc dolor, aliquet vel rutrum in, molestie sit amet massa. Aliquam suscipit, justo a commodo condimentum, enim sapien fringilla ante, sed lobortis orci lectus in ante. Donec vel interdum est. Donec placerat cursus lacus, eu ultricies nisl tincidunt a. Fusce libero risus, sagittis eleifend iaculis aliquet, condimentum vitae diam. Suspendisse potenti. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Proin leo purus, sodales a venenatis luctus, faucibus ac enim. Sed id metus ac sem lobortis pretium. Mauris faucibus tempor scelerisque. Nunc vulputate interdum tortor, non tincidunt dui condimentum eget. Aenean in porttitor velit. Nam accumsan rhoncus risus id consectetur.</p>
 	  </div>
+	  <div id="test1aout"></div>
 	</td><td>
-	<h2>start at the element offsetTop test (multiple elements)</h2>
+	<h2>start at the element offsetTop test (multiple elements) & disable fadeOut</h2>
 	  <div id="test1b">
 		<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam rhoncus, felis interdum condimentum consectetur, nisl libero elementum eros, vehicula congue lacus eros non diam. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Vivamus mauris lorem, lacinia id tempus non, imperdiet et leo. Cras sit amet erat sit amet lacus egestas placerat. Aenean ultricies ultrices mauris ac congue. In vel tortor vel velit tristique tempus ac id nisi. Proin quis lorem velit. Nunc dui dui, blandit a ullamcorper vitae, congue fringilla lectus. Aliquam ultricies malesuada feugiat. Vestibulum placerat turpis et eros lobortis vel semper sapien pulvinar.</p>
 		<p>Pellentesque rhoncus aliquet porta. Sed vel magna eu turpis pharetra consequat ut vitae lectus. In molestie sollicitudin mi sit amet convallis. Aliquam erat volutpat. Nullam feugiat placerat ipsum eget malesuada. Nulla facilisis nunc non dolor vehicula pretium. Sed dui magna, sodales id pharetra non, ullamcorper eu sapien. Mauris ac consectetur leo. Mauris consequat, lectus ut bibendum pulvinar, leo magna feugiat enim, eu commodo lacus sem vel ante. Sed tempus metus eget leo mollis vulputate. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.</p>
@@ -152,11 +153,15 @@ <h2>rail visible test, allowPageScroll true</h2>
 				  height: '200px',
 				  start: $('#testElement'),
 				  alwaysVisible: true
+			  }).bind('slimscroll', function(e, pos){
+				$('#test1aout').html($('#test1aout').html() + "Reached " + pos + "<br />");
 			  });
+
 			  $('#test1b').slimScroll({
 				  height: '200px',
 				  width: '400px',
-				  start: $('.blah:eq(1)')
+				  start: $('.blah:eq(1)'),
+				  disableFadeOut: true
 			  });
 			  $('#test2').slimScroll({
 				  position: 'left',

index.min.htm

@@ -44,7 +44,7 @@ <h2>Facebook-like jQuery Scrollbar</h1>
 <hr />
 	  <table>
 		  <tr><td valign="top">
-	<h2>start at the element offsetTop test</h2>
+	<h2>start at the element offsetTop test & top/bottom events</h2>
 	  <div id="test1a">
 		<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam rhoncus, felis interdum condimentum consectetur, nisl libero elementum eros, vehicula congue lacus eros non diam. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Vivamus mauris lorem, lacinia id tempus non, imperdiet et leo. Cras sit amet erat sit amet lacus egestas placerat. Aenean ultricies ultrices mauris ac congue. In vel tortor vel velit tristique tempus ac id nisi. Proin quis lorem velit. Nunc dui dui, blandit a ullamcorper vitae, congue fringilla lectus. Aliquam ultricies malesuada feugiat. Vestibulum placerat turpis et eros lobortis vel semper sapien pulvinar.</p>
 		<p>Pellentesque rhoncus aliquet porta. Sed vel magna eu turpis pharetra consequat ut vitae lectus. In molestie sollicitudin mi sit amet convallis. Aliquam erat volutpat. Nullam feugiat placerat ipsum eget malesuada. Nulla facilisis nunc non dolor vehicula pretium. Sed dui magna, sodales id pharetra non, ullamcorper eu sapien. Mauris ac consectetur leo. Mauris consequat, lectus ut bibendum pulvinar, leo magna feugiat enim, eu commodo lacus sem vel ante. Sed tempus metus eget leo mollis vulputate. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.</p>
@@ -54,8 +54,9 @@ <h2>start at the element offsetTop test</h2>
 		<p>Nulla rhoncus elementum convallis. Mauris condimentum aliquet egestas. Ut iaculis nisi eget tellus accumsan venenatis. Maecenas imperdiet aliquam porta. Aenean ultrices dolor sed quam laoreet varius. Curabitur condimentum blandit erat, quis accumsan eros interdum vitae. Curabitur ligula arcu, sollicitudin vitae iaculis sed, blandit sit amet enim. Morbi ullamcorper, metus vel mollis tristique, arcu turpis malesuada nisi, at dignissim lorem odio a orci. Proin ultrices, ipsum ut vestibulum interdum, libero felis auctor mi, vitae convallis nisl justo ac tellus. Integer nec lacinia turpis. Etiam massa nisl, rhoncus quis rutrum in, pretium eu leo. Proin a velit ut nulla laoreet vestibulum. Curabitur eu elit vitae felis auctor tincidunt. Curabitur tincidunt, metus sed sollicitudin cursus, quam elit commodo erat, ut tempor erat sapien vitae velit. Morbi nec viverra erat.</p>
 		<p>Nullam scelerisque facilisis pretium. Vivamus lectus leo, commodo ac sagittis ac, dictum a mi. Donec quis massa ut libero malesuada commodo in et risus. Fusce nunc dolor, aliquet vel rutrum in, molestie sit amet massa. Aliquam suscipit, justo a commodo condimentum, enim sapien fringilla ante, sed lobortis orci lectus in ante. Donec vel interdum est. Donec placerat cursus lacus, eu ultricies nisl tincidunt a. Fusce libero risus, sagittis eleifend iaculis aliquet, condimentum vitae diam. Suspendisse potenti. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Proin leo purus, sodales a venenatis luctus, faucibus ac enim. Sed id metus ac sem lobortis pretium. Mauris faucibus tempor scelerisque. Nunc vulputate interdum tortor, non tincidunt dui condimentum eget. Aenean in porttitor velit. Nam accumsan rhoncus risus id consectetur.</p>
 	  </div>
+	  <div id="test1aout"></div>
 	</td><td>
-	<h2>start at the element offsetTop test (multiple elements)</h2>
+	<h2>start at the element offsetTop test (multiple elements) & disable fadeOut</h2>
 	  <div id="test1b">
 		<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam rhoncus, felis interdum condimentum consectetur, nisl libero elementum eros, vehicula congue lacus eros non diam. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Vivamus mauris lorem, lacinia id tempus non, imperdiet et leo. Cras sit amet erat sit amet lacus egestas placerat. Aenean ultricies ultrices mauris ac congue. In vel tortor vel velit tristique tempus ac id nisi. Proin quis lorem velit. Nunc dui dui, blandit a ullamcorper vitae, congue fringilla lectus. Aliquam ultricies malesuada feugiat. Vestibulum placerat turpis et eros lobortis vel semper sapien pulvinar.</p>
 		<p>Pellentesque rhoncus aliquet porta. Sed vel magna eu turpis pharetra consequat ut vitae lectus. In molestie sollicitudin mi sit amet convallis. Aliquam erat volutpat. Nullam feugiat placerat ipsum eget malesuada. Nulla facilisis nunc non dolor vehicula pretium. Sed dui magna, sodales id pharetra non, ullamcorper eu sapien. Mauris ac consectetur leo. Mauris consequat, lectus ut bibendum pulvinar, leo magna feugiat enim, eu commodo lacus sem vel ante. Sed tempus metus eget leo mollis vulputate. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.</p>
@@ -152,11 +153,15 @@ <h2>rail visible test, allowPageScroll true</h2>
 				  height: '200px',
 				  start: $('#testElement'),
 				  alwaysVisible: true
+			  }).bind('slimscroll', function(e, pos){
+				$('#test1aout').html($('#test1aout').html() + "Reached " + pos + "<br />");
 			  });
+
 			  $('#test1b').slimScroll({
 				  height: '200px',
 				  width: '400px',
-				  start: $('.blah:eq(1)')
+				  start: $('.blah:eq(1)'),
+				  disableFadeOut: true
 			  });
 			  $('#test2').slimScroll({
 				  position: 'left',

slimScroll.js

@@ -2,7 +2,7 @@
  * Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php)
  * and GPL (http://www.opensource.org/licenses/gpl-license.php) licenses.
  *
- * Version: 0.5.0
+ * Version: 0.6.0
  * 
  */
 (function($) {
@@ -32,12 +32,13 @@
         scroll: 0
       };
 
-      var o = ops = $.extend( defaults , options );
+      var o = ops = $.extend(defaults, options);
 
       // do it for every element that matches selector
       this.each(function(){
 
-      var isOverPanel, isOverBar, isDragg, queueHide, barHeight, percentScroll,
+      var isOverPanel, isOverBar, isDragg, queueHide, 
+        barHeight, percentScroll, lastScroll,
         divS = '<div></div>',
         minBarHeight = 30,
         releaseScroll = false,
@@ -80,7 +81,7 @@
 
         // wrap content
         var wrapper = $(divS)
-          .addClass( o.wrapperClass )
+          .addClass(o.wrapperClass)
           .css({
             position: 'relative',
             overflow: 'hidden',
@@ -97,7 +98,7 @@
 
         // create scrollbar rail
         var rail  = $(divS)
-          .addClass( o.railClass )
+          .addClass(o.railClass)
           .css({
             width: size,
             height: '100%',
@@ -112,7 +113,7 @@
 
         // create scrollbar
         var bar = $(divS)
-          .addClass( o.barClass )
+          .addClass(o.barClass)
           .css({
             background: color,
             width: size,
@@ -265,8 +266,20 @@
           getBarHeight();
           clearTimeout(queueHide);
 
-          // release wheel when bar reached top or bottom
-          releaseScroll = allowPageScroll && percentScroll == ~~ percentScroll;
+          // when bar reached top or bottom
+          if (percentScroll == ~~ percentScroll)
+          {
+            //release wheel 
+            releaseScroll = allowPageScroll;
+            
+            // publish approporiate event
+            if (lastScroll != percentScroll)
+            {
+                var msg = (~~percentScroll == 0) ? 'top' : 'bottom'; 
+                me.trigger('slimscroll', msg);
+            }
+          }
+          lastScroll = percentScroll;
 
           // show only when required
           if(barHeight >= me.outerHeight()) {