MooTools onLoad SmoothScrolling

By  on  

SmoothScroll is a fantastic MooTools plugin but smooth scrolling only occurs when the anchor is on the same page. Making SmoothScroll work across pages is as easy as a few extra line of MooTools and a querystring variable.

The MooTools / PHP

//once the DOM is ready...
window.addEvent('domready', function() { 
	//smooooooth scrolling enabled
	new SmoothScroll({ duration:700 }, window); 

<?php if($_GET['scrollto']) { ?>
//once the window has loaded...
window.addEvent('load', function() {
	//scroll down to the specific spot
	var scroll = new Fx.Scroll(window, { wait: false, duration: 2500, transition: Fx.Transitions.Quad.easeInOut });
	scroll.toElement('<?php echo $_GET['scrollto']; ?>');
<?php } ?>

Of course, this is a system you would only want to implement on a small site with few anchors.

Recent Features

  • By
    Designing for Simplicity

    Before we get started, it's worth me spending a brief moment introducing myself to you. My name is Mark (or @integralist if Twitter happens to be your communication tool of choice) and I currently work for BBC News in London England as a principal engineer/tech...

  • By
    CSS @supports

    Feature detection via JavaScript is a client side best practice and for all the right reasons, but unfortunately that same functionality hasn't been available within CSS.  What we end up doing is repeating the same properties multiple times with each browser prefix.  Yuck.  Another thing we...

Incredible Demos

  • By
    dwImageProtector Plugin for jQuery

    I've always been curious about the jQuery JavaScript library. jQuery has captured the hearts of web designers and developers everywhere and I've always wondered why. I've been told it's easy, which is probably why designers were so quick to adopt it NOT that designers...

  • By
    Parallax Sound Waves Animating on Scroll

    Scrolling animations are fun. They are fun to create and fun to use. If you are tired of bootstrapping you might find playing with scrolling animations as a nice juicy refreshment in your dry front-end development career. Let's have a look how to create animating...


  1. Nice, but actually, this can be done without PHP. By simply using the URL hash, this can be done better:

    window.addEvent('domready', function(e) {
    	var el = window.location.hash.substring(1); // the hash
    		var scroll = new Fx.Scroll(window, { wait: false, duration: 2500, transition: Fx.Transitions.Quad.easeInOut });
    		new SmoothScroll({ duration:700 }, window);
  2. @Lim Chee Aug: Cool, I’ll test that out!

  3. Oh ya, ignore the ‘else’ and the ‘e’ parameter in my code. Was typing too fast :P

  4. Nice david !
    But the page is reload :S
    It is the only lacking, but otherwise there was no other choice.

  5. @Catar4x: I think the page reload is the whole point of this script. It’s showing you how to make the smoothscroll effect when the page reloads. David Walsh made a tutorial previously on how to smoothscroll without reloading the page. You can read that at this link:

  6. Johan Douma

    Would be good to loop thru each link that links to a named anchor and then change them to have ?scrollto=### in the href.
    If there is already a smoothscrolling script that looped thru the page, the page will not reload when clicked.
    That way search engines will not index the same page with scrollto’s params several times.

  7. Chris Martin

    @Josh: The main reason to use Lim Chee’s method rather than the PHP-based solution using GET is that it ensures that the anchor links retain their functionality when JS is disabled (the anchor links in the PHP version do nothing without JS).

    With Lim Chee’s, without JS you get old school anchor links, but with JS if you navigate directly to a page with a # in the URL, it will automatically SmoothScroll you down to it once the page has loaded. It’s a great example of progressive enhancement! :)

    The full code:

    window.addEvent('domready', function() {   
      new SmoothScroll({ duration:700 }, window);
      var el = window.location.hash.substring(1); // the hash
      if(el) {
        var scroll = new Fx.Scroll(window, { wait: false, duration: 700, transition: Fx.Transitions.Quad.easeInOut });
  8. Eric

    Doesn’t scroll to top?

  9. I like using this method: using ? instead oh hash stops the page jumping around etc.

         var scroll = new Fx.Scroll(window, { wait: false, duration: 2500, 
         transition: Fx.Transitions.Quad.easeInOut });
                      var loc = document.location.href;
                      var splitLoc = loc.split("?");
                        var to = splitLoc[1]

    with the url being and RCIS is the id of the element.

  10. Johan

    @ Ricky, That’s not the best thing to do concerning SEO. Using ?, you’ll end up with duplicates of your pages in the search engine indexes.

  11. Lukie

    Hi, i cant quite get it. How for example start a new page and force it automaticcly to scroll to let’s say “chapter 4” ( your examples ). And do it on start without any click from he user, this examples are not working for me. Normal smooth scroll works perfectly. If i could just specify one point on the page this would works quite fine. Thx for help ;-) i know its quite noobish question.

  12. Lukie

    Ah sry for double post… it can really be an ugly,, ugly solution like pointing to the page content by pixels or so… :-).

  13. Lukie tr this link see if it works . I changed the code on the site because its under construction. O and it works by firing the scroll event onDomReady or page load.

  14. I’m only 13 years old and I really don’t know anything about html or java or any other code, but I’m making a website using adobe dreamweaver cs3. I was wondering if anyone would be so kind to make a code for me with a horizontal smoothscroll to a location like x:1000 pixels. Also could you tell me how to activate the code when a button is pressed. I’m willing to make a donation, since I don’t know how much work this is.

  15. @Chris

    this is a cool method, but I’m not sure if it works in webkit. I’m testing on Chrome & Firefox…things work perfectly in FF, but webkit seems to want to go directly to the # on the page immediately.

  16. correction, I had my function attached to a delay method, I took that out and it works…kind of. Its jumps all round the place in webkit.

  17. Hi Great post thanks for sharing. Im giving it a try now.

  18. Thanks so much for this man! You’ve saved me after hours and hours of screwing around.

  19. hi everyone, does anyone please have a sample files of this smooth scroll for php?, i can’t get it to work on load, im using the original php example from david but cant get it to work,

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!