/** SoftScroll. (C)Scripterlative.com
!!! READ THIS FIRST !!!
-> This code is distributed on condition that all developers using it recognise the effort that
-> went into producing it, by making a PayPal gratuity OF THEIR CHOICE to the authors within 14
-> days. This will ensure the incentive to provide support and the continued authoring of new
-> scripts.
-> If you think people should work for nothing and you cannot agree to abide promptly by this
-> condition, we recommend that you decline the script. We'll understand.
-> Gratuities cannot be accepted via any source other than PayPal.
-> Please use the [Donate] button at www.scripterlative.com, stating the URL that uses the code.
Description
~~~~~~~~~~~
Provides progressive scrolling to anchor/element positions, including those in iframes or
adjacent frames.
Provides a direct replacement for the window.scrollTo function.
Info: http://scripterlative.com?softscroll
These instructions may be removed but not the above text.
Please notify any suspected errors in this text or code, however minor.
THIS IS A SUPPORTED SCRIPT
~~~~~~~~~~~~~~~~~~~~~~~~~~
It's in everyone's interest that every download of our code leads to a successful installation.
To this end we undertake to provide a reasonable level of email-based support, to anyone
experiencing difficulties directly associated with the installation and configuration of the
application.
Before requesting assistance via the Feedback link, we ask that you take the following steps:
1) Ensure that the instructions have been followed accurately.
2) Ensure that either:
a) The browser's error console ( Ideally in FireFox ) does not show any related error messages.
b) You notify us of any error messages that you cannot interpret.
3) Validate your document's markup at: http://validator.w3.org or any equivalent site.
4) Provide a URL to a test document that demonstrates the problem.
Installation
~~~~~~~~~~~~
Save this text/file as 'softscroll.js', and place it in a folder associated with your web pages.
Insert the following tags in the section of the document to be scrolled:
(If softscroll.js resides in a different folder, include the relative path)
Configuration
~~~~~~~~~~~~~
For normal operation no further configuration is required.
To scroll the page to an initial anchor when it loads, insert the following code anywhere below
the installation
Options
-------
To set options, add a set of
Please note that in some circumstances this may cause a slight jump at the end of the scroll.
Cross-Frame Scrolling
---------------------
The script can scroll to anchors within a current document residing either in an iframe or another
frame from the same immediate .
The target document does not need to load a copy of the script, however if you have links that
load subsequent pages into a frame which are to be scrolled to an anchor on load, then the
subsequent pages must load a copy of the script for this purpose.
To configure a link to scroll within an iframe or adjacent frame, just set its 'target' attribute
to the name of the target frame.
The standard values: _top, _self, _parent & _blank are ignored.
Examples:
Somewhere in the iframe 'if1' in this page
Somewhere in the adjacent frame named 'main'
ALL INVOLVED FRAMED DOCUMENTS MUST BE ON THE SAME DOMAIN.
To load a new document in another frame and scroll to an anchor within it, use a conventional
link with href=URL#anchor and appropriate 'target' attribute. The new document must load a copy
of the script.
Scrolling on Load
-----------------
If the script reads a # anchor in the URL of the document that loaded it, it will scroll to that
anchor.
Notes for Correct Operation
---------------------------
1) The ID of an element may be specified as an anchor, and NAME attributes may be specified for
scrolling to form elements.
2) If any anchors have no characters between their opening and closing tags, i.e.
Triggering with other element types
-----------------------------------
Example: