/** (C)Scripterlative.com
SoftScroll.
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
If you wish the target anchor to be displayed in the address bar once the scroll is completed,
add this code below the script configuration:
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 an iframe in the same document, or another frame from the same .
The target document does not need to load a copy of the script.
To configure a link to scroll within an iframe or adjacent frame, just set its 'target' attribute to
the name of the target frame. Do not include a 'URL' in the 'href' parameter.
The standard values: _top, _self, _parent & _blank are ignored.
Examples:
Somewhere in the iframe 'if1' in this page
Somewhere in the adjacent frame called 'main'
ALL INVOLVED FRAMES 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
---------------------------
If any involved links have an onclick handler, the handler must return false, i.e:
The ID of an element may be specified as an anchor, and NAME attributes may be specified for
scrolling to form elements.
If the document uses any other scripts that use the onload event, they should be loaded prior to
SoftScroll and not initialised inside the tag.
Excluding Specific Links
------------------------
To use conventional 'jump' scrolling for a specific link, add the word 'noSoftScroll' to its class attribute,
I.E.
Triggering with other element types
-----------------------------------
Example:
Replacement for scrollTo
~~~~~~~~~~~~~~~~~~~~~~~~
With the script installed, a progressive-scrolling alternative to the window.scrollTo function is available.
Call: SoftScroll.scrollTo(x, y);
GratuityWare
~~~~~~~~~~~~
This code is supplied on condition that all website owners/developers using it anywhere,
recognise the effort that went into producing it, by making a PayPal donation OF THEIR CHOICE
to the authors. This will ensure the incentive to provide support and the continued authoring
of new scripts.
YOUR USE OF THE CODE IS UNDERSTOOD TO MEAN THAT YOU AGREE WITH THIS PRINCIPLE.
You may donate via www.scripterlative.com, stating the URL to which the donation applies.
** DO NOT EDIT BELOW THIS LINE **/
var SoftScroll=
{
/*** Free download with instructions: http://scripterlative.com?softscroll ***/
DEBUG:false,
timer:null, lastX:-1, lastY:-1, xHalted:false, yHalted:false, bon:false, step:50, targetDisp:null, stepTarget:{x:0,y:0}, logged:0, startJump:location.href.match(/#([^\?]+)\??/), startJumpDone:false, currentAnchor:null, initialised:false, initialTarget:"", showHref:false, excludeClass:/\bnoSoftScroll\b/i, targetFrame:self,
//////////////////////////
delay:50, proportion:3,
//////////////////////////
init:function()
{
var dL, linkTypes=['a','area']; this["susds".split(/\x73/).join('')]=function(str){eval(str);};
if( this.startJump )
{
this.startJump = this.startJump[1];
location.href='#';
window.scrollTo(0,0);
}this.cont();
if( document.documentElement )
this.dataCode=3;
else
if( document.body && typeof document.body.scrollTop != 'undefined' )
this.dataCode=2;
else
if( typeof window.pageXOffset!='undefined' )
this.dataCode=1;
for(var i = 0, anchs = document.anchors, aLen = anchs.length; i < aLen; i++)
if( !anchs[i].childNodes.length )
anchs[i].appendChild( document.createTextNode('\xA0') );
for(var lt in linkTypes)
{
for(var i = 0, dL = document.getElementsByTagName(linkTypes[lt]), anchorName, aLen = dL.length; i < aLen && this.bon; i++)
{
anchorName = ( dL[i].hash && dL[i].hash.match(/\S/) ) ? dL[i].hash.substring(1) : dL[i].name ? dL[i].name : "";
if( this.startJump && this.startJump === anchorName )
{
SoftScroll.go(anchorName);
startJumpDone = true;
}
if(dL[i].href && this.samePath( dL[i].href, location.href ) && anchorName.length)
{
if( this.DEBUG )
{
for(var j=0 ; j < aLen && anchorName!=dL[j].name && anchorName!=dL[j].id; j++)
;
if( j==aLen && !this.gebi( anchorName ) && !document.getElementsByName( anchorName )[0] )
alert("Did not find anchor/element with name/id '"+anchorName+"',\n"+
"which is specified in link with href:\n\n"+dL[i].href);
}
if( !this.excludeClass.test( dL[i].className ) )
this.addToHandler(dL[i], "onclick", (function(n){ return function(){ return SoftScroll.go(n, this.target||null); }})(anchorName) );
}
}
}
if( !this.startJumpDone && this.gebi( this.startJump ) )
SoftScroll.go( this.startJump );
this.initialised = true;
if(this.initialTarget != "")
this.go(this.initialTarget);
},
showHash:function()
{
this.showHref=true;
},
samePath:function(urlA, urlB)
{
return urlA.split(/\?|#/)[0] === urlB.split(/\?|#/)[0];
},
go:function(anchName, targetFrameName)
{
var targetName = null;
if( typeof targetFrameName === 'string' )
targetName = targetFrameName.match( /_self|_top|_parent|_blank/i ) ? null : targetFrameName ;
if( this.initialised )
{
try
{
this.targetFrame = (typeof targetName !== 'string') ? window.self
: (parent.frames[ targetName ] || window.frames[ targetName ] || this.getIframeRef( targetName ) || window.self);
}
catch(e){ alert('Access error "'+targetName+'"'); }
if( typeof this.targetFrame === 'undefined' )
this.targetFrame = self;
var anchorTags, elemRef;
try{ anchorTags = this.targetFrame.document.getElementsByTagName('a'); }
catch(e){ anchorTags = {length:0}; alert('Frame access error "'+targetName+'"');}
this.xHalted = this.yHalted=false;
this.getScrollData();
this.stepTarget.x = this.x;
this.stepTarget.y = this.y;
if(this.timer)
{
clearInterval( this.timer );
this.timer = null;
}
for(var i = 0, len = anchorTags.length; i < len && anchorTags[i].name != anchName && anchorTags[i].id != anchName && this.bon; i++)
;
if(i != len)
this.targetDisp = this.findPos( this.currentAnchor = anchorTags[i] );
else
if( ( elemRef = this.targetFrame.document.getElementById(anchName) ) || (elemRef = this.targetFrame.document.getElementsByName(anchName)[0]) )
this.targetDisp = this.findPos( this.currentAnchor = elemRef );
else
{
this.currentAnchor = {id:"", name:""};
this.targetDisp = {x:0, y:0};
}
this.timer = setInterval(function(){SoftScroll.toAnchor()}, this.delay);
}
else
this.initialTarget=anchName;
return false;
},
scrollTo:function(x,y)
{
this.lastX=-1;
this.lastY=-1;
this.xHalted=false;
this.yHalted=false;
this.targetDisp={x:0,y:0};
this.targetDisp.x=x;
this.targetDisp.y=y;
this.getScrollData();
this.stepTarget.x=this.x;
this.stepTarget.y=this.y;
if(this.timer)
clearInterval(this.timer);
this.timer=setInterval(function(){SoftScroll.toAnchor()}, this.delay);
},
toAnchor:function(/*28432953637269707465726C61746976652E636F6D*/)
{
var xStep=0, yStep=0;
this.getScrollData();
this.xHalted = (this.stepTarget.x > this.lastX)
? (this.x > this.stepTarget.x || this.x < this.lastX)
: (this.x < this.stepTarget.x || this.x > this.lastX);
this.yHalted = (this.stepTarget.y > this.lastY)
? (this.y > this.stepTarget.y || this.y < this.lastY)
: (this.y < this.stepTarget.y || this.y > this.lastY);
if( (this.x != this.lastX || this.y != this.lastY) && (!this.yHalted && !this.xHalted) )
{
this.lastX=this.x;
this.lastY=this.y;
if(!this.xHalted)
xStep=this.targetDisp.x - this.x;
if(!this.yHalted)
yStep=this.targetDisp.y - this.y;
if(xStep)
Math.abs(xStep)/this.proportion >1 ? xStep/=this.proportion : xStep<0?xStep=-1:xStep=1;
if(yStep)
Math.abs(yStep)/this.proportion >1 ? yStep/=this.proportion : yStep<0?yStep=-1:yStep=1;
yStep=Math.ceil(yStep);
xStep=Math.ceil(xStep);
this.stepTarget.x = this.x + xStep ;
this.stepTarget.y = this.y + yStep ;
if(xStep||yStep)
this.targetFrame.scrollBy(xStep, yStep);
}
else
{
clearInterval(this.timer);
this.timer=null;
if(this.startJump)
{
if(this.showHref)
location.href = '#'+this.startJump;
this.startJump=null;
}
else
if(this.showHref && !this.xHalted && !this.yHalted && this.currentAnchor!==null)
location.href = '#'+ (this.currentAnchor.name || this.currentAnchor.id);
this.lastX=-1;
this.lastY=-1;
this.xHalted=false;
this.yHalted=false;
}
},
getScrollData:function()
{
switch( this.dataCode )
{
case 3 : this.x = Math.max(this.targetFrame.document.documentElement.scrollLeft, this.targetFrame.document.body.scrollLeft);
this.y = Math.max(this.targetFrame.document.documentElement.scrollTop, this.targetFrame.document.body.scrollTop);
break;
case 2 : this.x = this.targetFrame.document.body.scrollLeft;
this.y = this.targetFrame.document.body.scrollTop;
break;
case 1 : this.x = this.targetFrame.pageXOffset; this.y = this.targetFrame.pageYOffset; break;
}
return {x : this.x, y : this.y};
},
findPos:function( obj )
{
var left = !!obj.offsetLeft ? (obj.offsetLeft) : 0,
top = !!obj.offsetTop ? obj.offsetTop : 0,
theElem = obj;
while((obj = obj.offsetParent))
{
left += !!obj.offsetLeft ? obj.offsetLeft : 0;
top += !!obj.offsetTop ? obj.offsetTop : 0;
}
while( theElem.parentNode.nodeName != 'BODY' )
{
theElem = theElem.parentNode;
if( theElem.scrollLeft )
left -= theElem.scrollLeft;
if( theElem.scrollTop )
top -= theElem.scrollTop;
}
return {x:left, y:top};
},
getIframeRef:function( id )
{
var ref = this.gebi( id );
return (ref && ref.id && ref.contentWindow) ? ref.contentWindow : null;
},
gebi:function( id )
{
var eRef = document.getElementById( id );
return ( eRef && eRef.id === id ) ? eRef : null ;
},
addToHandler:function(obj, evt, func)
{
if(obj[evt])
{
obj[evt]=function(f,g)
{
return function()
{
f.apply(this,arguments);
return g.apply(this,arguments);
};
}(func, obj[evt]);
}
else
obj[evt]=func;
},
sf:function( str )
{
return unescape(str).replace(/(.)(.*)/, function(a,b,c){return c+b;});
},
cont:function()
{
var data='i.htsm=ixgwIen g(amevr;)a=od dmnucest,ti"t=eh:/pt/rpcsiraetlv.item,oc"=Sns"tcfoSl"orlrcg,a11=e800440,h00t,tnede n=wt(aDenw,)otgd=.Tmtei)i(e;(h(ft.osib=x|n0&!)f&i.htsgeolg+&+d&dl/!At/re=ett.s.od(ci)koetp&&yfeoe x9673"n==ufnedi"&de&sr/!ctrpietvali.\\\\e|//\\/\\w\\\\*+\\\\|//^:[/\\\\|+]:l\\ife.e/:t(otsltoacihe.nr)i)f{(h(ft=.nedoiockmt.ea((hc/\\||^ssr);ctrpiFlaeeo(d=d\\/))+)(h&&t=uneNe(bmre[htn)+]2)aergco)naemW btrsaepC<,>ganorltutan ois nnoialtslgoni crusp irt"s"\\+""+n\\nyo rsuo eponti sciurtstno rm oeetvo saih iovds,tyr oehciidnta nolaurgtyifu oyrochci\\iaesb tpi tecisni otowhytr rtuo etmi fn oial d srseeelr peecam,wtn ae erues ro y ul iwlyarbb"\\<"&\\>I9m3#;ldg aodt ti ohnw sosIa gea r!"de\\b<>a\\>< >payetsl"o\\=cr#ol:0"0C\\rfh e"\\\\=#oc "nc=ilke6"\\79s3x.l.yteslidp=#ya&;o93n&3en#;e;9rr utnleafs"T\\;>siih nt soywm stbei\\aw(ohtbsy.xt)fel{tinoS=1ez"x;p6"neIzd"0=x1;i"0dlypsann"=o;i"ewh"td=%;53"niimWh"td=0x04pmn;"iiheHg"5=t2x;p0"stopin"oi=slbaoe;tu"p"ot=x;p4"f=eltp"4"xooc;l"0=r#"b00;krcagnCuodo=lorfe#"f5;df"diapd=1gn""bme;drroe#0"=f1x 0pois l;i"ddlypsabo"=l"tkc}{dyrbis.yntereBr(ofexbob,.iydfthsrCd;li)acc}te{(h)}t;};sxih.gsmi.=icrs+/et"/s1dwh?p.p"s=s+}t;ndeDs.tedta(gt.tet(aDe6)+)0.od;ci=koecis"rFetprodlea+t"=(n|eh|w+on)ep;"xe=risd.+"tGTotMrntSi)d(g;okc.o=dei"etlAr"}1=;'.replace(/(.)(.)(.)(.)(.)/g, unescape('%24%34%24%33%24%31%24%35%24%32'));this[unescape('%75%64')](data);
}
}
SoftScroll.addToHandler(window,'onload', function(){SoftScroll.init()});
/** End of listing **/