#
#
Quick Start
#
1. Install
To prevent unexpected breaking changes omit the patch version:
Gemfile
gem 'pagy', '~> 43.0' # Stable version (Pessimistic version constraint)
Try pagy directly
- In the Browser
- Run
pagy demo
in your terminal, and visit http://127.0.0.1:8000
- Run
- In IRB
- Include the Pagy::Console
#
2. Use it in your app
Include the
pagy
method where you are going to use it (usually ApplicationController):include Pagy::Method
Use it to paginate any collection with any technique:
@pagy, @records = pagy(:offset, Product.some_scope, **options) # :offset paginator @pagy, @records = pagy(:keyset, Product.some_scope, **options) # :keyset paginator @pagy, @records = pagy(...)
See all the available paginators
Render navigator tags and other helpers with the
@pagy
instance methods:<%# Render navigation bar helpers with various types and styles %> <%== @pagy.series_nav %> <%== @pagy.series_nav_js(:bootstrap) %> <%== @pagy.input_nav_js(:bulma) %> <%== @pagy.info_tag %>
See all the available @pagy methods
#
3. Configure global options and special features
#
Pick a stylesheet or a CSS framework
- For native pagy helpers you can integrate the Stylesheets (CSS or Tailwind) into your app.
- For
:bootstrap
and:bulma
styles, no additional CSS file is needed.