This repository has been archived by the owner. It is now read-only.
jQuery Infinite Scroll plugin
Switch branches/tags
Nothing to show
Clone or download
Failed to load latest commit information.
LICENSE Rename LICENSE.txt to LICENSE Nov 14, 2014
README.rdoc updating documentation finally Aug 13, 2009
jquery.infinitescroll.js initial commit Mar 8, 2009


jQuery Infinite Scroll

A basic infinite scrolling pattern for jQuery.

Getting Started



$(window).infinitescroll({url: window.location.href});

A little more customized

   url: window.location.href,
   triggerAt: 150,
   page: 4,
   appendTo: 'table.userlist tbody'


How can I specify which page of data to load?

The “page” query parameter is appended to the URL specified

How to tell this plugin there's no more data/pages to load?

This is determined by handing back an empty response from the server. Once this happens, this plugin stops attempting to load data.


   default: null
   The URL to fetch more data to append
   default: 300
   This is the number of pixels from the bottom of the container (defaults to "document") to trigger the fetch for data
   default: 2
   The page number to fetch (sets the page=# query parameter in the URL)
   default: ".list tbody"
   The selector that .append() gets called on
   default: document
   This is the container used to measure scrolling, and then trigger a load


That this plugin will fire

infinitescroll.beforesend: Fired just before the ajax request is given
infinitescroll.finish: Fired after a successful request has finished, and the data has been inserted into the DOM
infinitescroll.maxreached: Fired after the first empty response from the server. This will disable any further loading of data.

That this plugin listens for

infinitescroll.scrollpage: This can be used to force a full-cycle load of data and append much like what happens just after the 'infinitescroll.beforesend' event is fired.
   Note: The plugin is listening for this event to be fired on whatever DOM object you initially bound it to. This assumes one the examples above were used.
   Example: $(window).trigger('infinitescroll.scrollpage', 1);