Skip to content

posabsolute/jquery-scrollbar-slider

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jQuery Scrollbar Slider

HTML anchor links can be a useful tool to link to a location in a very long page. However, the default implementation of HTML anchor links are not intuitive. When a user clicks on a link, they expect to go to another page. Instead, an clicking on an HTML anchor link makes a jarring jump down the page.

This jQuery plugin eases the pain of that interaction by smoothly scrolling down the page to reach the anchor destination.

Installation via Bower

bower install --save jquery-scrollbar-slider

Options

Name Type Default Description
speed int 1100 How fast in milliseconds to scroll down to the anchor
offset int 0 Setting this to a non-zero value will adjust where the scrolling will stop relative to the actual anchor position. It has the side effect of not placing the #id into the URL due to standard browser behavior forcing the page to always be at the anchor location defined by the hash in the URL.

Sample Use

You can see full HTML examples in action in the examples folder of this project. The basic approach is to

Basic

<html>
  <head>
    <script src="https://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script>
    <script src="jquery.anchor.js" type="text/javascript"></script>
  </head>
  
  <body>

    <div><a href="#anchorTarget" class="anchorLink">Click Me!</a>
    <div>Much content might be between me and the anchor...</div>
    <div><a id="anchorTarget"></a></div>

    <script type="text/javascript">
      $(document).ready(function() {
        $("a.anchorLink").anchorAnimate();
      });
    </script>

  </body>
</html>

Overriding the Defaults

<html>
  <head>
    <script src="https://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script>
    <script src="jquery.anchor.js" type="text/javascript"></script>
  </head>
  
  <body>

    <div><a href="#anchorTarget" class="anchorLink">Click Me!</a>
    <div>Much content might be between me and the anchor...</div>
    <div><a id="anchorTarget"></a></div>

    <script type="text/javascript">
      /** Do not have to wrap these in document.ready() */
      $.fn.anchorAnimate.defaults.speed = 50;
      $.fn.anchorAnimate.defaults.offset = 50;

      $(document).ready(function() {
        $("a.anchorLink").anchorAnimate();
      });
    </script>

  </body>
</html>

Licence

The plugin is licensed under the MIT license:

Copyright (c) 2012 Cedric Dugas, http://www.position-absolute.com/

About

Better html anchor, a jquery script to slide the scrollbar

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published