jQuery Scroll Follow

Overview

Scroll Follow is a simple jQuery plugin that enables a DOM object to follow the page as the user scrolls. Scroll Follow has been successfully tested on IE6, IE7, FF2, FF3, Safari 3, and Opera 9 on Windows. It has been successfully tested on FF3 and Safari 3 on MacOSX.

Requirements

• jQuery (tested with 1.2.6)
• jQuery UI Core (tested with 1.5.2)

Optional

• jQuery Easing Plugin
• jQuery Cookie Plugin

Installation

1. Include jQuery:
   1. <script type="text/javascript" src="jquery.js"></script>

   <!-- end .code-->

2. Include required plugins, including Scroll Follow:
   1. <script type="text/javascript" src="ui.core.js"></script>
   2. <script type="text/javascript" src="jquery.scrollFollow.js"></script>

   <!-- end .code-->

3. Call Scroll Follow on the desired DOM object: 
   View Example
   1. <script type="text/javascript">
   2. $( '#example' ).scrollFollow();
   3. </script>

   <!-- end .code-->

4. Or call Scroll Follow on the desired DOM object and give it some parameters: 
   View Example
   1. <script type="text/javascript">
   2. $( document ).ready( function () {
   3. $( '#example' ).scrollFollow( {
   4. speed: 1000,
   5. offset: 60,
   6. killSwitch: 'exampleLink',
   7. onText: 'Disable Follow',
   8. offText: 'Enable Follow'
   9. } );
   10. } );
   11. </script>

   <!-- end .code-->

5. The Scroll Follow object will remain inside its immediate container. 
   View Example
6. Or you can specify a parent (by ID) for the Scroll Follow object to consider its container: 
   View Example
   1. <script type="text/javascript">
   2. $( document ).ready( function () {
   3. $( '#example' ).scrollFollow( {
   4. container: 'outer'
   5. } );
   6. } );
   7. </script>

   <!-- end .code-->

7. Scroll Follow uses the "top" property of an object to slide it. Therefore, the "position" of the object must be set to either "relative" or "absolute." Other than that limitation, the Scroll Follow object should be completely configured through CSS.

Parameters

• speedint - default: 500 
The duration of the sliding animation (in milliseconds). The smaller the value, the faster the animation.• easingstring - default: 'linear' 
If included, use any one of the easing options from the easing plugin . Uses 'linear' by default which provides no easing.• offsetint - default: 0 
Number of pixels the Scroll Follow object should remain from top of viewport.• containerstring - default: object's immediate parent 
ID of the containing div.• killSwitchstring - default: 'killSwitch' 
ID of the On/Off toggle element. Requires the jQuery Cookie plugin .• onTextstring - default: 'Turn Slide Off' 
killSwitch text to be displayed if sliding is enabled.• offTextstring - default: 'Turn Slide On' 
killSwitch text to be displayed if sliding is disabled.• relativeTostring - default: 'top' 
Scroll animation can be relative to either the 'top' or 'bottom' of the viewport.• delayint - default: 0 
Time between the end of the scroll and the beginning of the animation in milliseconds.