mislav /will_paginate

Pagination library for Rails and other Ruby applications

★ 5,677⑂ 850👁 68⑃ 224● 439▤ 22
RubyMITCreated 2008-02-25github.com/mislav/will_paginate/wikis
下载:will_paginate 4.0.1will_paginate-4.0.1 ↓4.0.12024-06-10
+0
日增长
5,677
stars
850
forks
68
watchers
224
prs
439
issues
22
releases

README

will_paginate

will_paginate is a pagination library that integrates with Ruby on Rails, Sinatra, Hanami::View, and Sequel.

 ruby
gem 'will_paginate', '~ 4.0'


See [installation instructions][install] on the wiki for more info.

ℹ️ will_paginate is now in _maintenance mode_ and it will not be receiving new features. See alternatives

 Basic will_paginate use

 ruby
 perform a paginated query:
@posts = Post.paginate(page: params[:page])

 or, use an explicit "per page" limit:
Post.paginate(page: params[:page], per_page: 30)

 render page links in the view:



And that's it! You're done. You just need to add some CSS styles to [make those pagination links prettier][css].

You can customize the default "per_page" value:

 ruby
 for the Post model
class Post
  self.per_page = 10
end

 set per_page globally
WillPaginate.per_page = 10


New in Active Record 3:

 ruby
 paginate in Active Record now returns a Relation
Post.where(published: true).paginate(page: params[:page]).order(id: :desc)

 the new, shorter page() method
Post.page(params[:page]).order(created_at: :desc)


See [the wiki][wiki] for more documentation. [Report bugs][issues] on GitHub.

Happy paginating.


[wiki]: https://github.com/mislav/will_paginate/wiki
[install]: https://github.com/mislav/will_paginate/wiki/Installation "will_paginate installation"
[issues]: https://github.com/mislav/will_paginate/issues
[css]: http://mislav.github.io/will_paginate/

Top issues

Latest release

will_paginate 4.0.1 v4.0.1 2024-06-10
What's Changed
 Ruby 3.4 compatibility: fix running with RUBYOPT="--enable-frozen-string-literal" by @jdelStrother in https://github.com/mislav/will_paginate/pull/651
 CI: test with Ruby 3.3, Rails 7.1 by @mislav in https://github.com/mislav/will_paginate/pull/659
 CI: Update GitHub Actions using dependabot by @olleolleolle in https://github.com/mislav/will_paginate/pull/653
 Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/mislav/will_paginate/pull/654
 README.md: Avoid hashrockets for args by @olleolleolle in https://github.com/mislav/will_paginate/pull/650
 boots

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON