jarc100 / jquery.arbitrary-anchor.js

Arbitrary anchors for any element on your page using a little jQuery magic.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

jquery.arbitrary-anchor.js

This plugin allows the page to scroll to any arbitrary object on the page based on jQuery/CSS selector.

Visit us on the web or follow me on Twitter for updates: @brianmgonzalez.

Usage

Usage is simple. Just drop it into your page's head after jQuery. Then it just works.

Add to your page:

<script type="text/javascript" src="jquery.arbitrary-anchor.js"></script>

Then you can add any valid jQuery/CSS selector after the hash (#) in your page's URL, and it will automatically be scrolled to. If the selector returns more than 1 element, the first element found will be scrolled to. You can also place a pipe (|) with a value in milliseconds after the selector to change the time it takes to scroll to the given element, e.g. #.mydiv|200 would scroll to the first element with a class of mydiv and it would scroll to it in 200ms.

Example URLs

URL Scrolls To
http://example.com#raptor element with ID of or anchor with name of raptor
http://example.com#p element with ID of or anchor with name of raptor, if none, scroll to first <p>
http://example.com##yo-man first element with ID of yo-man
http://example.com#.brah first element with class of brah
http://example.com#.sup.brah first element with class of sup and brah
http://example.com#.sup.brah|100 first element with class of sup and brah, scrolled to in 100ms (default is 750ms)
http://example.com#footer element with ID of or anchor with name of footer, or first footer
http://example.com#footer|200 same as above, scrolled to in 200ms

On the web

Visit us at http://briangonzalez.org/arbitrary-anchor

About

Arbitrary anchors for any element on your page using a little jQuery magic.