Problem Summary:

User is browsing paged content.

Use When:

• Retaining the user is important and clicking “Next Page” is a usability barrier.
• The full content available is too large to show on initial load.
• The content is available in paged chunks: search results, blog posts, product listings portfolio features.

Advantages:

• Users are retained on the site far better.
  • Users are less likely to continue on to the next “page” if they have to click something versus it being delivered automatically to them. ^{[citation needed]}
• Requires no adjustment in a user’s typical reading habits.
• The added functionality needs no affordances or instruction.
• As long as the functionality is enhancing an existing navigational structure (like the wordpress plugin here), it remains SEO-friendly and Accessible. It will degrade gracefully if a user does not have JavaScript enabled..

Disadvantages:

• The “footer” of the page will be typically impossible to reach.
• Currently there is no way to cancel or opt-out of the behavior.
• There is no permalink to a given state of the page.
• Dynamically adding more content to the page increases the memory footprint of the browser. Depending on the browser, this could account for around 50megs of RAM.
• Analytics will not immediately capture the event, so custom configuration is required.

Implementation Recommendations:

• Depending on site latency, new content can be fetched aggressively (when a user has 500px of the page left to scroll) versus at the last moment (with ~100px left).
• User should be notified when there is no more content available.
• Consider a faux pagination widget to allow for navigation within the new content. Travis Isaacs has ideas on a running pagination.
• Infinite scroll should be implemented as progressive enhancement. Typical navigation/pagination should be present for users with javascript disabled. Javascript-enabled users, however, will experience the more rich reading functionality.

Examples in the wild:

• Humanized Reader
• SocialThing
• Live.com Image Search
• Soup tumblelogs
• Google Reader, Yahoo Mail use the same technique but within a container

CSS Selector Setup

You need configure the plugin with CSS selectors that match your theme.

Content CSS Selector

The DIV that wraps around all posts. New posts will be inserted at the bottom of this DIV.

Post CSS Selector

The selector that selects all posts on a page. Each post must be surrounded by a single DIV.

Navigation links CSS Selector

This DIV contains the Next Posts and Previous Posts link.

Previous Posts CSS Selector

This A tag is what points to the 2nd page of posts.

Troubleshooting

• Your posts need to be wrapped in divs all next to each other.
• You need a link on your page to the next page of posts.

FAQ

Can I change the number of posts loaded?

Yup. But that’s a Wordpress thing. Go to Settings / Reading

Is it SEO-Friendly?

Yes all enhancements are made via javascript only, so search spiders see no difference.

Is it accessible?

Things won’t change for screen-readers. This technique degrades gracefully.

Why doesn’t it work on ____ page?

Currently, the plugin is disabled for everything but the main page, but I’ll work on enabling it for Archives, Categories, and Tags.

Does it still keep going, even at the end of the blog?

Infinite scroll is configured to die when it hits a 404 Not Found status code, so when it goes through all your archives it should hit a /page/43/ (or something) that doesn’t exist, then show a message “Congrats, you’ve reached the end of the internet.” Some wordpress themes don’t report not found pages with a 404. Try a different theme or contacting the theme author.

Do I need to edit my theme to make this work?

Probably not, nope.

Will this do form posts for get new data?

Nope?

You mean it just works?

Yup.

Really?

I hope so. But due to the infinitudes of wordpress installations, each case is different. Different themes and other plugins may break infinite scroll’s functionality.

Customization

This information will probably help styling.

• <div id="infscr-page-2" class="infscr-pages"> will contain the page 2 content, etc
• <div id="infscr-loading"> is the loading div.

Download the jQuery plugin

Version 1.4.100210
jquery.infinitescroll.js (9.1k)
jquery.infinitescroll.min.js (3.6k)

Usage

Minimum required configuration

This is the minimum amount of configuration you can do, if you want things to work:

// infinitescroll() is called on the element that surrounds 
// the items you will be loading more of
  $('#content').infinitescroll({
 
    navSelector  : "div.navigation",            
                   // selector for the paged navigation (it will be hidden)
    nextSelector : "div.navigation a:first",    
                   // selector for the NEXT link (to page 2)
    itemSelector : "#content div.post"          
                   // selector for all items you'll retrieve
  });

All options

 
// usage:
// $(elem).infinitescroll(options,[callback]);
 
// infinitescroll() is called on the element that surrounds 
// the items you will be loading more of
$('#content').infinitescroll({
 
  navSelector  : "div.navigation",            
                 // selector for the paged navigation (it will be hidden)
 
  nextSelector : "div.navigation a:first",    
                 // selector for the NEXT link (to page 2)
 
  itemSelector : "#content div.post",          
                 // selector for all items you'll retrieve
 
  debug        : true,                        
                 // enable debug messaging ( to console.log )
 
  loadingImg   : "/img/loading.gif",          
                 // loading image.
                 // default: "http://www.infinite-scroll.com/loading.gif"
 
  loadingText  : "Loading new posts...",      
                 // text accompanying loading image
                 // default: "<em>Loading the next set of posts...</em>"
 
  animate      : true,      
                 // boolean, if the page will do an animated scroll when new content loads
                 // default: false
 
  extraScrollPx: 50,      
                 // number of additonal pixels that the page will scroll 
                 // (in addition to the height of the loading div)
                 // animate must be true for this to matter
                 // default: 150
 
  donetext     : "I think we've hit the end, Jim" ,
                 // text displayed when all items have been retrieved
                 // default: "<em>Congratulations, you've reached the end of the internet.</em>"
 
  bufferPx     : 40,
                 // increase this number if you want infscroll to fire quicker
                 // (a high number means a user will not see the loading message)
                 // new in 1.2
                 // default: 40
 
  errorCallback: function(){},
                 // called when a requested page 404's or when there is no more content
                 // new in 1.2                   
 
  localMode    : true
                 // enable an overflow:auto box to have the same functionality
                 // demo: http://paulirish.com/demo/infscr
                 // instead of watching the entire window scrolling the element this plugin
                 //   was called on will be watched
                 // new in 1.2
                 // default: false
 
 
                },function(){
 
                 // optional callback when new content is successfully loaded in.
                 // keyword 'this' will refer to the new DOM content that was just added.
});

Custom trigger, non-automatic. Twitter-style

In 1.4 you can trigger the loading of the next page of content at will. You’ll first unbind the default behavior. And then trigger the next pull whenever you like..

// unbind normal behavior. needs to occur after normal infinite scroll setup.
$(window).unbind('.infscr');

// call this whenever you want to retrieve the next page of content
// likely this would go in a click handler of some sort
$(document).trigger('retrieve.infscr');

Demo of the triggered infinite scroll functionality.

How does it work?

There is a little known feature in the .load() method that lets you specify the CSS selector of the html you want to include. jQuery will load in any local URL, then parse the html and grab only the elements you’ve defined with your selector. This allows for some pretty fun shit: client-side transclusions (a la purple include) ; and some really kickass shit when you combo it with a local php proxy.

This is really the meat of the code:

// load all post divs from page 2 into an off-DOM div
$('<div/>').load('/page/2/ #content div.post',function(){ 
    $(this).appendTo('#content');    // once they're loaded, append them to our content area
});

So it basically leverages that load() method at its core. It’s basically scraping your existing page structure, which means you don’t need to code any custom backend stuff to enable this functionality! Booyah, right?

dirkhaim of tinyways took Paul’s original code and built it out into a full fledged Wordpress plugin with configurable options.

Autopagerize adds infinite scroll functionality to hundreds of websites, including Google, Yahoo, Blogger, and Twitter. It was written by Japanese hacker swdyh with inspiration and ideas from ma.la. I strongly recommend you check it out. Naturally you’ll need the Firefox extension Greasemonkey in order for it to work.

If you’re not a greasemonkey type of person, you can install the AutoPager firefox extension.

If you’re a Safari user, install Greasekit and then use oAutoPagerize.

If you’re a Google Chrome user, install Greasemetal and then use oAutoPagerize.

If you’re an IE user, please get yourself a better browser and I’ll think about forgiving you..

• 2005 June 23 - Ma.La releases the Google Auto Pager greasemonkey script.
• 2005 June 28 - Bill Scott releases Rico LiveGrid and writes “Death To Paging!”
• 2006 April 25 - Humanized Reader launches with “Infinite History”
• 2006 September 14(ish) - Yahoo Mail (beta) utilizes the same LiveGrid technology
• 2006 September 17 - Microsoft’s Live.com Image Search includes infinite scroll.
• 2006 October 31 - Peter Forde writes Endless Pageless and releases a Rails plugin
• 2007 April 17 - swdyh releases AutoPagerize greasemonkey script, enabling infinite scroll for nearly every site.
• 2008 June 29 - infinite-scroll.com debuts with initial release of wordpress plugin

* Google Reader uses the same preloading LiveGrid technology. Anyone know when this debuted?

For the plugins below, the following code goes in the Javascript Callback option.

Lightbox JS 1.0:
No compatibility code available.
Lightbox JS 2.0:

myLightbox.updateImageList();

Shutter Reloaded:

shutterReloaded.Init('sh');

Thickbox:

 tb_init( $('a.thickbox, area.thickbox, input.thickbox',this) );

1 Pixel Out Audio Player:
Compatible! Version 2.0, too.
Yahoo Media Player:

YAHOO.MediaPlayer.addTracks( this );

HighslideJS:

$('a.highslide',this).click(function() {  return hs.expand(this);})

WP-SimpleViewer:
Not compatible.
Flare Smith Feed Flare:
Not compatible. (relies on inline script tags)

ShareThis plugin:
Not compatible. (relies on inline script tags)

SyntaxHighlighter Evolved:

SyntaxHighlighter.highlight(undefined,$('pre',this).get());

Smooth Scroll Links [SSL]

$('a',this).each(function(){
 ss.addEvent(this,'click',ss.smoothScroll);
});

To refer to the most recently added content:

    this;     // as of ver 1.1, the keyword this is the content wrapper (typically a DIV)
    $(this);  // the jQuery object including this
    $jQis('#infscr-page-'+INFSCR.currPage) // old 'n busted ver 1.0 style.