Options Hierarchy
This page documents the options hierarchy
The actual options are documented alongside the paginators and helpers that consume them.
Pagy implements a hierarchical options system working at three different levels, regardless of where the option gets consumed.
Levels
- For example,
Pagy::OPTIONS[:limit] = 10set in the pagy.rb initializer. - The
Pagy::OPTIONSare inherited by all paginators and helpers. - Good practice: Call
Pagy::OPTIONS.freezeafter you set yourPagy::OPTIONS.
- For example,
pagy(paginator, collection, **options). - The options passed to a paginator override the
Pagy::OPTIONSfor that instance. - They are also inherited by all the helpers used by the instance.
- For example,
@pagy.series_nav(**options). - The options passed to a helper override the options affecting its output.
- The options consumed upstream are not affected.
- Keep options local
- For clarity, set options as close to where they're consumed as possible.
- Widen the scope when needed
- Use higher-level options when they conveniently affect broader scopes.