paginate

Pagination. Especially useful with Mongoose + Express/Jade.

npm install paginate
3 downloads in the last day
10 downloads in the last week
44 downloads in the last month

paginate

Pagination. Especially useful with Mongoose + Express/Jade.

Getting Started

Install the module with: npm install paginate

The paginate plugin returns a function that accepts an options object. Call this to get access to the module functionality itself. E.g:

var paginate = require('paginate')({
    // options go here...
});

Documentation

(Coming soon)

Examples

Basic (non Mongoose) usage

var paginate = require('paginate')();
var data = new Array(95);

var PER_PAGE = 10;
var currentPage = 6;

var pagination = paginate.page(data.length, PER_PAGE, currentPage);
var html = pagination.render({ baseUrl: '/example' });

Mongoose + Express usage

var mongoose = require('mongoose');
var paginate = require('paginate')({
    mongoose: mongoose
});

// @NOTE: Assuming a post model has been created and registered...
var Post = mongoose.model('posts');

// An express route action:
app.get('/posts', function(req, res, next) {
    Post.find()
    .paginate({ page: req.query.page }, function(err, posts) {
        res.render('posts/index', {
            posts: posts
        })
    });
});

Then in the posts/index template, you could include the html generated from posts.pagination.render(). E.g. in Jade, this might look like:

!= posts.pagination.render({ baseUrl: '/posts })

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.

Release History

0.1.1

  • FIX: Queries with 0 results caused an invalid skip value to throw an error.
  • FIX: Typo in the readme params to query.

License

Copyright (c) 2012 Tony Milne Licensed under the MIT license.

npm loves you