Medium-Style Page Transition

An article on how to achieve Medium’s next page transition effect—an effect that can be seen by clicking anywhere on the “Read Next” footer at the bottom of the page. This effect is characterized by the lower article easing upward as the current article fades up and out.

Medium, a blogging platform which has gained popularity over the past several months, has one of the smoothest, most polished user interfaces on the web. As you click and touch the interface, you’ll notice that great attention has been paid to transitions, white space, color, fonts, imagery, and iconography.

In this article, I will outline how to achieve Medium’s page transition effect—an effect that can be seen by clicking anywhere on the “Read Next” footer at the bottom of the page. This effect is characterized by the lower article easing upward as the current article fades up and out. See the animation below for an illustration of this effect.



In this demo, the page first loads with barebones HTML, which we’ll use as a template that will be filled in later with Ajax’d-in data. Below is what our <body> looks like on initial page load. One main <article> tag. Pretty simple, eh?

  <article class='page hidden'>
    <div class='big-image'></div>
    <div class='content'></div>

Once the content is Ajax’d-in, the <body> looks something like so:

  <article class='page current'><!--other HTML --></article>
  <article class='page next '><!--other HTML --></article>

The page currently being viewed has a class of current, and the next article has a class of next. The next article only has its large image being shown at the bottom of the page, which, when clicked on, brings it into focus.


The styles in this demo which control the article transitions are both applied dynamically via jQuery’s css() method, as well as by applying classes to the <article> elements using jQuery’s addClass() method.

Here’s a rundown of the pertinent classes used:

        display: none 
    } .content { 
        display: none 

    article.fade-up-out {
        opacity: 0;
        transform: scale(0.8) translate3d(0, -10%, 0);
        transition: all 450ms cubic-bezier(0.165, 0.840, 0.440, 1.000);

    article.easing-upward {
        transition: all 450ms cubic-bezier(0.165, 0.840, 0.440, 1.000);


Before getting into the Javascript code, I want to first outline the algorithm used to transition the “next” article upward, and transition the “current” article up and away.

User clicks on big image of next article:

  1. Disable scrolling on the page
  2. Fade current article to opacity of 0, a scale of 0.8, and move it upward by 10%.
  3. Show the next article’s content, give it smooth transitions, then move it upward to the top of the window
  4. After 500ms:
    1. Remove the current article from the DOM
    2. Remove smooth transitions from next article
    3. Scroll to top of page programmatically.
    4. Make next article the current article
    5. Enable scroll on the page
    6. Make Ajax request for next article’s content

The Code

  ArticleAnimator.animatePage = function(callback){
  var self              = this;
  var translationValue  = this.$next.get(0).getBoundingClientRect().top;
  this.canScroll        = false;


  this.$next.removeClass('content-hidden next')
       .css({ "transform": "translate3d(0, -"+ translationValue +"px, 0)" });


      self.$next.css({ "transform": "" });
          self.$current = self.$next.addClass('current');

      self.canScroll = true;
      self.currentPostIndex = self.nextPostIndex( self.currentPostIndex );

  }, self.animationDuration + 300 );

Throughout the CSS & Javascript code, you’ll notice that, in order to achieve fluid animations, I am using transform: translate3d(x,y,z) to move my DOM elements. By doing this, we “hardware accelerate” the DOM elements movement. This method is preferred over animating an element using top/left or transform: translate(x,y,z), which are not hardware accelerated by default.

Side notes

As outlined earlier, the page is populated by making Ajax requests to static json files. Page state is managed using the PushState API and location.hash.

Photos in the demo were used courtesy of Unsplash. The page font is set in PT Serif and the headings in Source Sans.

Tagged with:

Stay up to date with the latest web design and development news and relevant updates from Codrops.

Feedback 90

Comments are closed.
  1. Great Just loved it!! i was searching for this trick but i didn’t found the best one but now i think i found it thank’s very much!!

  2. This is by far one of the best page transition I have ever seen. Simple and saves me the from the dreaded infinite scrolling.

  3. If I download the code, it does not load any content, I tried it on WAMP and on my website as well, but it does not work…

    What do I need to setup to get the AJAX loading?


    Since the page uses ajax, it’s best to serve the “index.html” with a true http server, and not from file. I like to use a Ruby gem called serve to achieve this.

    Simply gem install serve, then type serve from with the project’s root, and you’ll be able to access the page at localhost:4000. Hope this helps!

  5. very interesting transition
    Work well on Mozilla / Safari / IE
    but doesn’t work on Google Chrome

  6. It’s really frustrating to find the scrollbar missing in the demo page, it’s unaccessible for me as my mouse does not have a scrolling wheel – any possibility of fixing it?

    • The scroll bar is there but it’s only 1px wide on chrome. Not all of us use a Macbook with gestures or even a mouse with a scroll wheel. Very unusable.

      Clicking and using the down arrow is not an acceptable solution as it’s not natural behavior for most people.

  7. Awesome.
    Just a question, how did you do the gif animation above?
    Maybe a tutorial on that.

  8. What about a “Back” button or “Last Article”? It seems like should work just tagging the link on a #NUMBER.


    By the way, it’s pretty awesome!

  9. Sweet article Brian!

    One question though. What would i need to change if i didn’t want the pages to loop once it reached the end of my articles?
    Any help would be much appreciated 🙂

  10. Wow! awesome, great way to let the viewer see what’s next and smooth transition! I’m going to have to give this a try.

  11. I visited Medium’s website a day ago and was interesting how this page transition works…. Thank you for explanation and great article! 🙂 Just in time!

  12. Nice one Brian

    Can it be used also to go back to the top of the page quicker than via scolling ?

  13. Safari version 6.0.5 (8536.30.1), when you click on the next article at the bottom of the page, new article opens and scrolls down and does not stay on the top of the page. how to fix it? thank for the sharing, very very good work!

  14. Very cool mechanic, but there seems to be some serious lag involved where if you click ‘back’ too quickly there is no action (chrome 30, win7). the view stays the same. If you wait a while before going back it seems to go fine

  15. Great tutorial. Do you have a javascript books to recommend? Completely of the topic here, But i was wondering how you created that swipe animated gif?

  16. Great, exactly what I needed !
    However, I don’t think that ajax’ing the content of the main article is a good thing because people who do not have javascript enabled wouldn’t be able to see any content.

    • So many people have disabled javascript… It shouldn’t be an issue, however if it really is a concern to you: use regular <a href rel=”nofollow”> to the next page. Fetch the click action with javascript for people who have javascript enabled and serve it with ajax. People who have it disabled just go to a new page. Hope that makes sense.

  17. Hi, I have downloaded the file but it doesn’t work at all. Is there something that I suppose to change?

  18. this is great work. Can we disable looping. Also can we put static text after that like contact form or something in the index file itself?

  19. I downloaded and dosnt work at all, the images dont load and it says file:///data/post_1.json?_=1384654457169 failed to load resource in the console log.

  20. Anybody figured out how to implement a second picture? If you look at “Medium” you’ll see pictures in the middle of the article. I already tried to put am tag in the ajax data, but this will crash the site. I hope you can help me out 🙂

  21. Hey guys!
    I read trough the comments and saw that certain ppl had the sam issue as me, then I downloaded the updated example from gitHub BUT it’s still not working. I still get a ‘white’ page with:
    – Published by
    – Read Next

    There are no images displaying (even if I detect them with MOZ/Firebug), no text, Links not working ecc.

    Resume: The entire page isn’t working as it should! Tried it with Firefox, Chrome, Safari. Tried also hosting it, doesn’t change anything.


    BIG Thanks in advance!!

    • In your next update, can you please add a “previous article/post link” also.
      oh and great work by the way.

  22. awesome script, things are working fine in firefox but page don’t show in chrome or IE. anyone knows how to fix it?

    file:///C:/Main/post_1.json?_=1386317103426 No ‘Access-Control-Allow-Origin’ header is present on the requested resource. Origin ‘null’ is therefore not allowed access. jquery.js:6
    XMLHttpRequest cannot load file:///C:/Main/post_1.json?_=1386317103426. No ‘Access-Control-Allow-Origin’ header is present on the requested resource. Origin ‘null’ is therefore not allowed access.

    • Hi !

      Have you found the solution for this ? I have the same problem. I solved by placing in server. ( MAMP )

  23. Any ideas how I could modify this work with post numbers that increment by more than 1? For example, if my files were named post_3.json, post_7.json, post_15.json, could I make it ignore the missing posts?

  24. Hi Brian,

    … + thaks for this, so cool!

    Is it somehow possible to implement some php into this?

    I tryed this:

    “content”: “”

    … but it didn’t seem to work : )

    very best,

  25. Thank you for this code, it helped me a lot! But what if I want to had a link to another post in a post? The window.location changes well but nothing happened on the page (which seems logical, because we juste change the hash). Do I have to handle those links in JS as well or is their any other solutions ?
    And second important question, what about the url rewritting? I don’t think it’s possible with the hash. (But medium doesn’t have URLs with #1 🙂 )

    Thank you!

  26. Hi guys! I like this! But I have a problem. I want to write russian texts, but when I change it, it looks like ??????????. HTML works good in Russian, but .json files don’t. How can I change encoding from UTF-8 to chcp-1251?

  27. Thank you for this code. It’s a great help for me especially working in my own site. Thank you for sharing this interesting tutorial.