Rails%203%20In%20Action

436 CHAPTER 16 Basic performance enhancements
16.1.1 Introducing Kaminari
The Kaminari gem 1 is a new breed of pagination gem written by Akira Matsuda, and is
considered the Rails 3 successor to the will_paginate gem, 2 which was the favorite
for a long time. 3
After you install this gem, you’re given an interface on the models of your application,
which allows you to make calls like this:
@project.tickets.page(2).per(50)
This call would ask for the second page of tickets, with each page containing 50 tickets.
It’s a very clean API. Those familiar with will_paginate will be used to a syntax like this:
@project.tickets.paginate(:per_page => 50, :page => 2)
The syntax is a little longer, but it’s a little clearer what it’s doing to those who are
familiar with it. You’ll use Kaminari here just for something different. In your views,
you can use the same paginate method, which is made available by both gems:
This little helper generates the output shown in figure 16.2.
To install this gem, add this line to your Gemfile underneath the searcher gem:
gem 'kaminari'
You’ll then run the bundle install command to install the gem. With the gem
installed, you can now begin to write a Cucumber feature to test that when you’re on
Figure 16.2 Pagination helper
1 http://github.com/amatsuda/kaminari.
2 http://github.com/mislav/will_paginate.
3 Since this original writing, will_paginate has been updated to be Rails 3 compatible.