Class: Pagy

Inherits:
Object
  • Object
show all
Extended by:
Configurable
Includes:
HelperLoader, Linkable
Defined in:
lib/pagy.rb,
lib/pagy/cli.rb,
lib/pagy/tasks/sync.rb,
lib/pagy/modules/b64.rb,
lib/pagy/classes/request.rb,
lib/pagy/modules/console.rb,
lib/pagy/modules/searcher.rb,
lib/pagy/modules/i18n/i18n.rb,
lib/pagy/modules/i18n/p11n.rb,
lib/pagy/classes/exceptions.rb,
lib/pagy/classes/calendar/day.rb,
lib/pagy/classes/calendar/unit.rb,
lib/pagy/classes/calendar/week.rb,
lib/pagy/classes/calendar/year.rb,
lib/pagy/classes/keyset/keynav.rb,
lib/pagy/classes/keyset/keyset.rb,
lib/pagy/classes/offset/offset.rb,
lib/pagy/classes/offset/search.rb,
lib/pagy/classes/calendar/month.rb,
lib/pagy/classes/offset/countish.rb,
lib/pagy/modules/i18n/p11n/other.rb,
lib/pagy/toolbox/helpers/loaders.rb,
lib/pagy/classes/calendar/quarter.rb,
lib/pagy/classes/offset/countless.rb,
lib/pagy/modules/i18n/p11n/arabic.rb,
lib/pagy/modules/i18n/p11n/polish.rb,
lib/pagy/toolbox/helpers/info_tag.rb,
lib/pagy/toolbox/helpers/page_url.rb,
lib/pagy/classes/calendar/calendar.rb,
lib/pagy/toolbox/helpers/data_hash.rb,
lib/pagy/toolbox/helpers/urls_hash.rb,
lib/pagy/toolbox/paginators/keyset.rb,
lib/pagy/toolbox/paginators/method.rb,
lib/pagy/toolbox/paginators/offset.rb,
lib/pagy/modules/abilities/linkable.rb,
lib/pagy/toolbox/helpers/series_nav.rb,
lib/pagy/modules/abilities/countable.rb,
lib/pagy/modules/abilities/rangeable.rb,
lib/pagy/modules/abilities/shiftable.rb,
lib/pagy/modules/i18n/p11n/one_other.rb,
lib/pagy/toolbox/helpers/anchor_tags.rb,
lib/pagy/toolbox/paginators/calendar.rb,
lib/pagy/toolbox/paginators/countish.rb,
lib/pagy/toolbox/helpers/headers_hash.rb,
lib/pagy/toolbox/helpers/input_nav_js.rb,
lib/pagy/toolbox/helpers/limit_tag_js.rb,
lib/pagy/toolbox/paginators/countless.rb,
lib/pagy/toolbox/paginators/keynav_js.rb,
lib/pagy/modules/i18n/p11n/east_slavic.rb,
lib/pagy/modules/i18n/p11n/west_slavic.rb,
lib/pagy/toolbox/helpers/series_nav_js.rb,
lib/pagy/toolbox/paginators/searchkick.rb,
lib/pagy/classes/keyset/adapters/sequel.rb,
lib/pagy/modules/abilities/configurable.rb,
lib/pagy/toolbox/helpers/support/series.rb,
lib/pagy/toolbox/paginators/meilisearch.rb,
lib/pagy/toolbox/helpers/bulma/series_nav.rb,
lib/pagy/toolbox/helpers/support/a_lambda.rb,
lib/pagy/toolbox/helpers/bulma/input_nav_js.rb,
lib/pagy/toolbox/paginators/typesense_rails.rb,
lib/pagy/toolbox/helpers/bulma/series_nav_js.rb,
lib/pagy/modules/i18n/p11n/one_upto_two_other.rb,
lib/pagy/toolbox/helpers/bootstrap/series_nav.rb,
lib/pagy/classes/keyset/adapters/active_record.rb,
lib/pagy/toolbox/helpers/bootstrap/input_nav_js.rb,
lib/pagy/toolbox/paginators/elasticsearch_rails.rb,
lib/pagy/toolbox/helpers/bootstrap/series_nav_js.rb,
lib/pagy/toolbox/helpers/support/wrap_series_nav.rb,
lib/pagy/toolbox/helpers/bulma/previous_next_html.rb,
lib/pagy/toolbox/helpers/support/wrap_input_nav_js.rb,
lib/pagy/toolbox/helpers/support/wrap_series_nav_js.rb,
lib/pagy/toolbox/helpers/support/data_pagy_attribute.rb,
lib/pagy/toolbox/helpers/bootstrap/previous_next_html.rb,
lib/pagy/toolbox/helpers/support/nav_aria_label_attribute.rb

Overview

Relegate internal functions. Make overriding navs easier.

Direct Known Subclasses

Calendar::Unit, Keyset, Offset

Defined Under Namespace

Modules: B64, CalendarPaginator, Configurable, Console, Countable, CountishPaginator, CountlessPaginator, ElasticsearchRailsPaginator, HelperLoader, I18n, KeynavJsPaginator, KeysetPaginator, Linkable, MeilisearchPaginator, NumericHelperLoader, NumericHelpers, OffsetPaginator, Rangeable, Search, Searcher, SearchkickPaginator, Shiftable, TypesenseRailsPaginator Classes: CLI, Calendar, ElasticsearchRails, EscapedValue, InternalError, Keyset, Meilisearch, Offset, OptionError, RailsI18nLoadError, RangeError, Request, SearchBase, Searchkick, SyncTask, TypesenseRails

Constant Summary collapse

VERSION = 
'43.4.0'
ROOT = 
Pathname.new(__dir__).parent.freeze
DEFAULT = 
{ limit: 20, limit_key: 'limit', page_key: 'page' }.freeze
PAGE_TOKEN = 
EscapedValue.new('P ')
LIMIT_TOKEN = 
EscapedValue.new('L ')
LABEL_TOKEN = 
'L'
A_TAG = 
'<a style="display: none;">#</a>'
OPTIONS =

rubocop:disable Style/MutableConstant

{}
DEFAULT_DATA_KEYS = 
i[url_template first_url previous_url current_url page_url next_url last_url
count page limit last in from to previous next options].freeze
Method =

Pagy::Method defines the #pagy method to be included in the app controller/view.

Module.new do
  protected

  define_method :pagy do |paginator = :offset, collection, **options|
    arguments = if paginator == :calendar
                  [self, collection, options]
                else
                  [collection, options = Pagy::OPTIONS.merge(options)]
                end

    options[:root_key]  = 'page' if options[:jsonapi] # enforce 'page' root_key for JSON:API
    options[:request] ||= request                     # user set request or self.request
    options[:request]   = Request.new(options)        # Pagy::Request

    Pagy.const_get(paginators[paginator]).paginate(*arguments)
  end
end
DEFAULT_HEADERS_MAP = 
{ page:  'current-page',
limit: 'page-limit',
count: 'total-count',
pages: 'total-pages' }.freeze
SERIES_SLOTS = 
7

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Configurable

dev_tools, sync, sync_javascript, translate_with_the_slower_i18n_gem!

Instance Attribute Details

#in ⇒ Object (readonly)

Returns the value of attribute in.



42
43
44
 
# File 'lib/pagy.rb', line 42

def in
  @in
end

#limit ⇒ Object (readonly)

Returns the value of attribute limit.



42
43
44
 
# File 'lib/pagy.rb', line 42

def limit
  @limit
end

#next ⇒ Object (readonly)

Returns the value of attribute next.



42
43
44
 
# File 'lib/pagy.rb', line 42

def next
  @next
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



42
43
44
 
# File 'lib/pagy.rb', line 42

def options
  @options
end

#page ⇒ Object (readonly)

Returns the value of attribute page.



42
43
44
 
# File 'lib/pagy.rb', line 42

def page
  @page
end

Class Method Details

.options ⇒ Object 



36
 
# File 'lib/pagy.rb', line 36

def self.options = OPTIONS

Instance Method Details

#data_hash(data_keys: @options[:data_keys] || DEFAULT_DATA_KEYS) ⇒ Object

Generate a hash of the wanted internal data



8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/pagy/toolbox/helpers/data_hash.rb', line 8

def data_hash(data_keys: @options[:data_keys] || DEFAULT_DATA_KEYS, **)
  template = compose_page_url(PAGE_TOKEN, **)
  to_url   = ->(page) { template.sub(PAGE_TOKEN, page.to_s) if page }

  data_keys -= i[count limit] if calendar?

  data_keys.each_with_object({}) do |key, data|
    value = case key
            when :url_template           then template
            when :first_url              then compose_page_url(nil, **)
            when :previous_url           then to_url.(@previous)
            when :current_url, :page_url then to_url.(@page)
            when :next_url               then to_url.(@next)
            when :last_url               then to_url.(@last)
            else send(key)
            end
    data[key] = value if value
  rescue NoMethodError
    raise OptionError.new(self, :data_keys, 'to contain known keys/methods', key)
  end
end

#headers_hash(headers_map: @options[:headers_map] || DEFAULT_HEADERS_MAP) ⇒ Object

Generate a hash of RFC-8288-compliant http headers



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
 
# File 'lib/pagy/toolbox/helpers/headers_hash.rb', line 13

def headers_hash(headers_map: @options[:headers_map] || DEFAULT_HEADERS_MAP, **)
  links = urls_hash(**, absolute: true).map { %(<#{_2}>; rel="#{_1}") }.join(', ')

  headers_map.each_with_object('link' => links) do |(key, name), hash|
    next unless name

    value = case key
            # :nocov:
            when :page  then @page
            when :limit then @limit unless calendar?
            when :pages then @last  if @count
            when :count then @count
              # :nocov:
            end
    hash[name] = value.to_s if value
  end
end

#next_tag ⇒ Object

Return the enabled/disabled next page anchor tag



12
 
# File 'lib/pagy/toolbox/helpers/anchor_tags.rb', line 12

def next_tag(...) = anchor_tag_for(:next, ...)

#page_url(page) ⇒ Object

Return the page url for any page



5
6
7
8
9
10
11
12
13
14
15
16
 
# File 'lib/pagy/toolbox/helpers/page_url.rb', line 5

def page_url(page, **)
  target = case page
           when :first          then nil
           when :current, :page then @page
           when :previous       then @previous
           when :next           then @next
           when :last           then @last
           else                      page
           end

  compose_page_url(target, **) if target || page == :first
end

#urls_hash ⇒ Object

Generate the hash of the pagination links



5
6
7
8
9
10
11
12
 
# File 'lib/pagy/toolbox/helpers/urls_hash.rb', line 5

def urls_hash(**)
  template = compose_page_url(PAGE_TOKEN, **)

  { first:    compose_page_url(nil, **),
    previous: @previous && template.sub(PAGE_TOKEN, @previous.to_s),
    next:     @next     && template.sub(PAGE_TOKEN, @next.to_s),
    last:     @count    && template.sub(PAGE_TOKEN, @last.to_s) }.compact
end