pagy 7.0.11 → 8.6.3

data/lib/pagy/extras/semantic.rb

@@ -1,25 +1,25 @@
-# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/semantic
 # frozen_string_literal: true
 
-require 'pagy/extras/frontend_helpers'
+warn '[PAGY WARNING] The semantic extra has been discontinued and it will be removed in v9 ' \
+     '(https://github.com/ddnexus/pagy/discussions/672#discussioncomment-9212328)'
+
+require_relative 'js_tools'
 
 class Pagy # :nodoc:
   # Frontend modules are specially optimized for performance.
   # The resulting code may not look very elegant, but produces the best benchmarks
   module SemanticExtra
     # Pagination for semantic: it returns the html with the series of links to the pages
-    def pagy_semantic_nav(pagy, pagy_id: nil, link_extra: '',
-                          nav_aria_label: nil, nav_i18n_key: nil, **vars)
-      p_id = %( id="#{pagy_id}") if pagy_id
-      link = pagy_link_proc(pagy, link_extra:)
+    def pagy_semantic_nav(pagy, id: nil, aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
 
-      html = +%(<div#{p_id} role="navigation" class="pagy-semantic-nav ui pagination menu" #{
-                  nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)}>)
-      html << semantic_prev_html(pagy, link)
+      html = %(<div#{id} role="navigation" class="pagy-semantic nav ui pagination menu" #{
+                 nav_aria_label(pagy, aria_label:)}>#{semantic_prev_html(pagy, a)})
       pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
         html << case item
                 when Integer
-                  link.call(item, pagy.label_for(item), %(class="item"))
+                  a.(item, pagy.label_for(item), classes: 'item')
                 when String
                   %(<a role="link" class="item active" aria-current="page" aria-disabled="true">#{pagy.label_for(item)}</a>)
                 when :gap
@@ -28,66 +28,65 @@ class Pagy # :nodoc:
                   raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
                 end
       end
-      html << semantic_next_html(pagy, link)
-      html << %(</div>)
+      html << %(#{semantic_next_html(pagy, a)}</div>)
     end
 
-    # Javascript pagination for semantic: it returns a nav and a JSON tag used by the pagy.js file
-    def pagy_semantic_nav_js(pagy, pagy_id: nil, link_extra: '',
-                             nav_aria_label: nil, nav_i18n_key: nil, **vars)
+    # Javascript pagination for semantic: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_semantic_nav_js(pagy, id: nil, aria_label: nil, **vars)
       sequels = pagy.sequels(**vars)
-      p_id = %( id="#{pagy_id}") if pagy_id
-      link = pagy_link_proc(pagy, link_extra:)
-      tags = { 'before' => semantic_prev_html(pagy, link),
-               'link'   => link.call(PAGE_TOKEN, LABEL_TOKEN, %(class="item")),
-               'active' => %(<a role="link" class="item active" aria-current="page" aria-disabled="true">#{LABEL_TOKEN}</a>),
-               'gap'    => %(<div class="disabled item">#{pagy_t('pagy.gap')}</div>),
-               'after'  => semantic_next_html(pagy, link) }
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens  = { 'before'  => semantic_prev_html(pagy, a),
+                  'a'       => a.(PAGE_TOKEN, LABEL_TOKEN, classes: 'item'),
+                  'current' => %(<a role="link" class="item active" aria-current="page" aria-disabled="true">#{LABEL_TOKEN}</a>),
+                  'gap'     => %(<div class="disabled item">#{pagy_t('pagy.gap')}</div>),
+                  'after'   => semantic_next_html(pagy, a) }
 
-      %(<div#{p_id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-semantic-nav-js ui pagination menu" role="navigation" #{
-          nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)} #{
-          pagy_data(pagy, :nav, tags, sequels, pagy.label_sequels(sequels))}></div>)
+      %(<div#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-semantic nav-js ui pagination menu" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></div>)
     end
 
-    # Combo pagination for semantic: it returns a nav and a JSON tag used by the pagy.js file
-    def pagy_semantic_combo_nav_js(pagy, pagy_id: nil, link_extra: '',
-                                   nav_aria_label: nil, nav_i18n_key: nil)
-      p_id    = %( id="#{pagy_id}") if pagy_id
-      link    = pagy_link_proc(pagy, link_extra: %(class="item" #{link_extra}))
-      p_page  = pagy.page
-      p_pages = pagy.pages
-      input   = %(<input name="page" type="number" min="1" max="#{p_pages}" value="#{
-                    p_page}" style="padding: 0; text-align: center; width: #{
-                    p_pages.to_s.length + 1}rem; margin: 0 0.3rem" aria-current="page">)
+    # Combo pagination for semantic: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_semantic_combo_nav_js(pagy, id: nil, aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page") <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; padding: 0; margin: 0 0.3rem">) <<
+                   JSTools::A_TAG
 
-      %(<div#{p_id} class="pagy-semantic-combo-nav-js ui compact menu" role="navigation" #{
-          nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)} #{
-          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))}>#{
-          semantic_prev_html pagy, link
-        }<div class="pagy-combo-input item">#{
-          pagy_t 'pagy.combo_nav_js', page_input: input, count: p_page, pages: p_pages
-        }</div> #{
-          semantic_next_html pagy, link
+      %(<div#{id} class="pagy-semantic combo-nav-js ui compact menu" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
+        }>#{
+          semantic_prev_html(pagy, a)
+        }<div class="item"><label>#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></div> #{
+          semantic_next_html(pagy, a)
         }</div>)
     end
 
     private
 
-    def semantic_prev_html(pagy, link)
+    def semantic_prev_html(pagy, a)
       if (p_prev = pagy.prev)
-        link.call(p_prev, pagy_t('pagy.prev'), %(#{prev_aria_label_attr} class="item"))
+        a.(p_prev, pagy_t('pagy.prev'), classes: 'item', aria_label: pagy_t('pagy.aria_label.prev'))
       else
-        +%(<div class="item disabled" role="link" aria-disabled="true" #{
-             prev_aria_label_attr}>#{pagy_t('pagy.prev')}</div>)
+        %(<div class="item disabled" role="a" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.prev')}">#{pagy_t('pagy.prev')}</div>)
       end
     end
 
-    def semantic_next_html(pagy, link)
+    def semantic_next_html(pagy, a)
       if (p_next = pagy.next)
-        link.call(p_next, pagy_t('pagy.next'), %(#{next_aria_label_attr} class="item"))
+        a.(p_next, pagy_t('pagy.next'), classes: 'item', aria_label: pagy_t('pagy.aria_label.next'))
       else
-        +%(<div class="item disabled" role="link" aria-disabled="true" #{
-             next_aria_label_attr}>#{pagy_t('pagy.next')}</div>)
+        %(<div class="item disabled" role="link" aria-disabled="true" aria=label="#{
+            pagy_t('pagy.aria_label.prev')}">#{pagy_t('pagy.next')}</div>)
       end
     end
   end

data/lib/pagy/extras/size.rb

@@ -0,0 +1,40 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/size
+# frozen_string_literal: true
+
+class Pagy # :nodoc:
+  # Implement the legacy bar using the array size.
+  # Unless you have very specific requirements, use the faster and better looking default bar.
+  module SizeExtra
+    # Setup @items based on the :gearbox_items variable
+    def series(size: @vars[:size], **_)
+      return super unless size.is_a?(Array)
+      return [] if size == []
+      raise VariableError.new(self, :size, 'to be an Array of 4 Integers or []', size) \
+            unless size.is_a?(Array) && size.size == 4 && size.all? { |num| !num.negative? rescue false } # rubocop:disable Style/RescueModifier
+
+      [].tap do |series|
+        # This algorithm is up to ~5x faster and ~2.3x lighter than the previous one (pagy < 4.3)
+        # However the behavior of the legacy nav bar was taken straight from WillPaginate and Kaminari:
+        # it's ill-concieved and complicates the experience of devs and users.
+        left_gap_start  = 1 + size[0]
+        left_gap_end    = @page - size[1] - 1
+        right_gap_start = @page + size[2] + 1
+        right_gap_end   = @last - size[3]
+        left_gap_end    = right_gap_end  if left_gap_end   > right_gap_end
+        right_gap_start = left_gap_start if left_gap_start > right_gap_start
+        start           = 1
+        if (left_gap_end - left_gap_start).positive?
+          series.push(*start...left_gap_start, :gap)
+          start = left_gap_end + 1
+        end
+        if (right_gap_end - right_gap_start).positive?
+          series.push(*start...right_gap_start, :gap)
+          start = right_gap_end + 1
+        end
+        series.push(*start..@last)
+        series[series.index(@page)] = @page.to_s
+      end
+    end
+  end
+  prepend SizeExtra
+end

data/lib/pagy/extras/standalone.rb

@@ -42,9 +42,9 @@ class Pagy # :nodoc:
       return super unless pagy.vars[:url]
 
       vars         = pagy.vars
-      params       = pagy.params.is_a?(Hash) ? pagy.params.clone : {}  # safe when it gets reused
+      params       = vars[:params].is_a?(Hash) ? vars[:params].clone : {}  # safe when it gets reused
       pagy_set_query_params(page, vars, params)
-      params       = pagy.params.call(params) if pagy.params.is_a?(Proc)
+      params       = vars[:params].(params) if vars[:params].is_a?(Proc)
       query_string = "?#{QueryUtils.build_nested_query(params)}"
       "#{vars[:url]}#{query_string}#{vars[:fragment]}"
     end

data/lib/pagy/extras/trim.rb

@@ -6,23 +6,23 @@ class Pagy # :nodoc:
 
   # Remove the page=1 param from the first page link
   module TrimExtra
-    # Override the original pagy_link_proc.
-    # Call the pagy_trim method if the trim_extra is enabled.
-    def pagy_link_proc(pagy, link_extra: '')
-      link_proc = super(pagy, link_extra:)
-      return link_proc unless pagy.vars[:trim_extra]
+    # Override the original pagy_a_proc.
+    # Call the pagy_trim method for page 1 if the trim_extra is enabled
+    def pagy_anchor(pagy)
+      a_proc = super
+      return a_proc unless pagy.vars[:trim_extra]
 
-      lambda do |page, text = pagy.label_for(page), extra = ''|
-        link = +link_proc.call(page, text, extra)
-        return link unless page.to_s == '1'
+      lambda do |page, text = pagy.label_for(page), **opts|
+        a = +a_proc.(page, text, **opts)
+        return a unless page.to_s == '1'
 
-        pagy_trim(pagy, link)
+        pagy_trim(pagy, a) # in method for isolated testing
       end
     end
 
-    # Remove the the :page_param param from the first page link
-    def pagy_trim(pagy, link)
-      link.sub!(/[?&]#{pagy.vars[:page_param]}=1\b(?!&)|\b#{pagy.vars[:page_param]}=1&/, '')
+    # Remove the the :page_param param from the first page anchor
+    def pagy_trim(pagy, a)
+      a.sub!(/[?&]#{pagy.vars[:page_param]}=1\b(?!&)|\b#{pagy.vars[:page_param]}=1&/, '')
     end
   end
   Frontend.prepend TrimExtra

data/lib/pagy/extras/uikit.rb

@@ -1,25 +1,26 @@
-# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/uikit
 # frozen_string_literal: true
 
-require 'pagy/extras/frontend_helpers'
+warn '[PAGY WARNING] The uikit extra has been discontinued and it will be removed in v9 ' \
+     '(https://github.com/ddnexus/pagy/discussions/672#discussioncomment-9212328)'
+
+require_relative 'js_tools'
 
 class Pagy # :nodoc:
   # Frontend modules are specially optimized for performance.
   # The resulting code may not look very elegant, but produces the best benchmarks
   module UikitExtra
     # Pagination for uikit: it returns the html with the series of links to the pages
-    def pagy_uikit_nav(pagy, pagy_id: nil, link_extra: '',
-                       nav_aria_label: nil, nav_i18n_key: nil, **vars)
-      p_id = %( id="#{pagy_id}") if pagy_id
-      link = pagy_link_proc(pagy, link_extra:)
-
-      html = +%(<ul#{p_id} class="pagy-uikit-nav uk-pagination uk-flex-center" role="navigation"  #{
+    def pagy_uikit_nav(pagy, id: nil, aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
 
-      nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)}>#{uikit_prev_html(pagy, link)})
+      html = %(<ul#{id} class="pagy-uikit nav uk-pagination uk-flex-center" role="navigation" #{
+                nav_aria_label(pagy, aria_label:)}>#{
+                uikit_prev_html(pagy, a)})
       pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
         html << case item
                 when Integer
-                  %(<li>#{link.call(item)}</li>)
+                  %(<li>#{a.(item)}</li>)
                 when String
                   %(<li class="uk-active"><span role="link" aria-current="page" aria-disabled="true">#{
                       pagy.label_for(item)}</span></li>)
@@ -29,67 +30,67 @@ class Pagy # :nodoc:
                   raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
                 end
       end
-      html << uikit_next_html(pagy, link)
-      html << %(</ul>)
+      html << %(#{uikit_next_html(pagy, a)}</ul>)
     end
 
-    # Javascript pagination for uikit: it returns a nav and a JSON tag used by the pagy.js file
-    def pagy_uikit_nav_js(pagy, pagy_id: nil, link_extra: '',
-                          nav_aria_label: nil, nav_i18n_key: nil, **vars)
+    # Javascript pagination for uikit: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_uikit_nav_js(pagy, id: nil, aria_label: nil, **vars)
       sequels = pagy.sequels(**vars)
-      p_id = %( id="#{pagy_id}") if pagy_id
-      link = pagy_link_proc(pagy, link_extra:)
-      tags = { 'before' => uikit_prev_html(pagy, link),
-               'link'   => %(<li>#{link.call(PAGE_TOKEN, LABEL_TOKEN)}</li>),
-               'active' => %(<li class="uk-active"><span role="link" aria-current="page" aria-disabled="true">#{
-                               LABEL_TOKEN}</span></li>),
-               'gap'    => %(<li class="uk-disabled"><span>#{pagy_t 'pagy.gap'}</span></li>),
-               'after'  => uikit_next_html(pagy, link) }
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens  = { 'before'  => uikit_prev_html(pagy, a),
+                  'a'       => %(<li>#{a.(PAGE_TOKEN, LABEL_TOKEN)}</li>),
+                  'current' => %(<li class="uk-active"><span role="link" aria-current="page" aria-disabled="true">#{
+                                   LABEL_TOKEN}</span></li>),
+                  'gap'     => %(<li class="uk-disabled"><span>#{pagy_t 'pagy.gap'}</span></li>),
+                  'after'   => uikit_next_html(pagy, a) }
 
-      %(<ul#{p_id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-uikit-nav-js uk-pagination uk-flex-center" role="navigation" #{
-          nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)} #{
-          pagy_data(pagy, :nav, tags, sequels, pagy.label_sequels(sequels))}></ul>)
+      %(<ul#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-uikit nav-js uk-pagination uk-flex-center" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></ul>)
     end
 
-    # Javascript combo pagination for uikit: it returns a nav and a JSON tag used by the pagy.js file
-    def pagy_uikit_combo_nav_js(pagy, pagy_id: nil, link_extra: '',
-                                nav_aria_label: nil, nav_i18n_key: nil)
-      p_id    = %( id="#{pagy_id}") if pagy_id
-      link    = pagy_link_proc(pagy, link_extra:)
-      p_page  = pagy.page
-      p_pages = pagy.pages
-      input   = %(<input name="page" type="number" min="1" max="#{p_pages}" value="#{
-                    p_page}" style="text-align: center; width: #{p_pages.to_s.length + 1}rem;" aria-current="page">)
+    # Javascript combo pagination for uikit: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_uikit_combo_nav_js(pagy, id: nil, aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page" ) <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem;">#{JSTools::A_TAG})
 
-      %(<ul#{p_id} class="pagy-uikit-combo-nav-js uk-button-group uk-pagination uk-flex-center" role="navigation" #{
-          nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)} #{
+      %(<ul#{id} class="pagy-uikit combo-nav-js uk-button-group uk-pagination uk-flex-center" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
           pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
         }>#{
-          uikit_prev_html pagy, link
-        }<li>#{
-          pagy_t 'pagy.combo_nav_js', page_input: input, count: p_page, pages: p_pages
-        }</li>#{
-          uikit_next_html pagy, link
+          uikit_prev_html(pagy, a)
+        }<li><label>#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></li>#{
+          uikit_next_html(pagy, a)
         }</ul>)
     end
 
     private
 
-    def uikit_prev_html(pagy, link)
-      previous_span = %(<span uk-pagination-previous></span>)
+    def uikit_prev_html(pagy, a)
+      span = %(<span uk-pagination-previous></span>)
       if (p_prev = pagy.prev)
-        %(<li>#{link.call(p_prev, previous_span, prev_aria_label_attr)}</li>)
+        %(<li>#{a.(p_prev, span, aria_label: pagy_t('pagy.aria_label.prev'))}</li>)
       else
-        %(<li class="uk-disabled"><span role="link" aria-disabled="true" #{prev_aria_label_attr}>#{previous_span}</a></li>)
+        %(<li class="uk-disabled"><a role="link" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.prev')}">#{span}</a></li>)
       end
     end
 
-    def uikit_next_html(pagy, link)
-      next_span = %(<span uk-pagination-next></span>)
+    def uikit_next_html(pagy, a)
+      span = %(<span uk-pagination-next></span>)
       if (p_next = pagy.next)
-        %(<li>#{link.call(p_next, next_span, next_aria_label_attr)}</li>)
+        %(<li>#{a.(p_next, span, aria_label: pagy_t('pagy.aria_label.prev'))}</li>)
       else
-        %(<li class="uk-disabled"><span role="link" aria-disabled="true" #{prev_aria_label_attr}>#{next_span}</span></li>)
+        %(<li class="uk-disabled"><a role="link" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.next')}">#{span}</a></li>)
       end
     end
   end

data/lib/pagy/frontend.rb

@@ -1,8 +1,8 @@
 # See Pagy::Frontend API documentation: https://ddnexus.github.io/pagy/docs/api/frontend
 # frozen_string_literal: true
 
-require 'pagy/url_helpers'
-require 'pagy/i18n'
+require_relative 'url_helpers'
+require_relative 'i18n'
 
 class Pagy
   # Used for search and replace, hardcoded also in the pagy.js file
@@ -15,60 +15,56 @@ class Pagy
     include UrlHelpers
 
     # Generic pagination: it returns the html with the series of links to the pages
-    def pagy_nav(pagy, pagy_id: nil, link_extra: '',
-                 nav_aria_label: nil, nav_i18n_key: nil, **vars)
-      p_id = %( id="#{pagy_id}") if pagy_id
-      link = pagy_link_proc(pagy, link_extra:)
+    def pagy_nav(pagy, id: nil, aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
 
-      html = +%(<nav#{p_id} class="pagy pagy-nav pagination" #{nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key)}>)
-      html << prev_html(pagy, link)
+      html = %(<nav#{id} class="pagy nav" #{nav_aria_label(pagy, aria_label:)}>#{
+                 prev_a(pagy, a)})
       pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
         html << case item
                 when Integer
-                  %(<span class="page">#{link.call(item)}</span>)
+                  a.(item)
                 when String
-                  %(<span class="page active">) +
-                  %(<a role="link" aria-disabled="true" aria-current="page">#{pagy.label_for(item)}</a></span>)
+                  %(<a role="link" aria-disabled="true" aria-current="page" class="current">#{pagy.label_for(item)}</a>)
                 when :gap
-                  %(<span class="page gap">#{pagy_t('pagy.gap')}</span>)
+                  %(<a role="link" aria-disabled="true" class="gap">#{pagy_t('pagy.gap')}</a>)
                 else
                   raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
                 end
       end
-      html << %(#{next_html(pagy, link)}</nav>)
+      html << %(#{next_a(pagy, a)}</nav>)
     end
 
     # Return examples: "Displaying items 41-60 of 324 in total" or "Displaying Products 41-60 of 324 in total"
-    def pagy_info(pagy, pagy_id: nil, item_name: nil, item_i18n_key: nil)
-      p_id    = %( id="#{pagy_id}") if pagy_id
+    def pagy_info(pagy, id: nil, item_name: nil)
+      id      = %( id="#{id}") if id
       p_count = pagy.count
-      key     = if    p_count.zero?   then 'pagy.info.no_items'
-                elsif pagy.pages == 1 then 'pagy.info.single_page'
-                else                       'pagy.info.multiple_pages' # rubocop:disable Lint/ElseLayout
+      key     = if p_count.zero?
+                  'pagy.info.no_items'
+                elsif pagy.pages == 1
+                  'pagy.info.single_page'
+                else
+                  'pagy.info.multiple_pages'
                 end
 
-      %(<span#{p_id} class="pagy-info">#{
-          pagy_t key, item_name: item_name || pagy_t(item_i18n_key || pagy.vars[:item_i18n_key], count: p_count),
+      %(<span#{id} class="pagy info">#{
+          pagy_t key, item_name: item_name || pagy_t('pagy.item_name', count: p_count),
                       count: p_count, from: pagy.from, to: pagy.to
         }</span>)
     end
 
-    # Return a performance optimized lambda to generate the HTML links
+    # Return a performance optimized lambda to generate the HTML anchor element (a tag)
     # Benchmarked on a 20 link nav: it is ~22x faster and uses ~18x less memory than rails' link_to
-    def pagy_link_proc(pagy, link_extra: '')
-      p_prev      = pagy.prev
-      p_next      = pagy.next
-      p_page      = pagy.page.to_s
-      left, right = %(<a href="#{pagy_url_for(pagy, PAGE_TOKEN)}" #{
-                        pagy.vars[:link_extra]} #{link_extra}).split(PAGE_TOKEN, 2)
+    def pagy_anchor(pagy)
+      a_string    = pagy.vars[:anchor_string]
+      a_string    = %( #{a_string}) if a_string
+      left, right = %(<a#{a_string} href="#{pagy_url_for(pagy, PAGE_TOKEN)}").split(PAGE_TOKEN, 2)
       # lambda used by all the helpers
-      lambda do |page, text = pagy.label_for(page), extra_attrs = ''|
-        %(#{left}#{page}#{right}#{ case page
-                                   when p_prev then ' rel="prev"'
-                                   when p_next then ' rel="next"'
-                                   when p_page then ' aria-disabled="true" aria-current="page"'
-                                   else             ''
-                                   end } #{extra_attrs}>#{text}</a>)
+      lambda do |page, text = pagy.label_for(page), classes: nil, aria_label: nil|
+        classes    = %( class="#{classes}") if classes
+        aria_label = %( aria-label="#{aria_label}") if aria_label
+        %(#{left}#{page}#{right}#{classes}#{aria_label}>#{text}</a>)
       end
     end
 
@@ -80,34 +76,24 @@ class Pagy
 
     private
 
-    def nav_aria_label_attr(pagy, nav_aria_label, nav_i18n_key, count: pagy.pages)
-      nav_aria_label ||= pagy_t(nav_i18n_key || pagy.vars[:nav_i18n_key], count:)
-      %(aria-label="#{nav_aria_label}")
-    end
-
-    def prev_aria_label_attr
-      %(aria-label="#{pagy_t('pagy.aria_label.prev')}")
-    end
-
-    def next_aria_label_attr
-      %(aria-label="#{pagy_t('pagy.aria_label.next')}")
+    def nav_aria_label(pagy, aria_label: nil)
+      aria_label ||= pagy_t('pagy.aria_label.nav', count: pagy.pages)
+      %(aria-label="#{aria_label}")
     end
 
-    def prev_html(pagy, link, text: pagy_t('pagy.prev'))
+    def prev_a(pagy, a, text: pagy_t('pagy.prev'), aria_label: pagy_t('pagy.aria_label.prev'))
       if (p_prev = pagy.prev)
-        %(<span class="page prev">#{link.call(p_prev, text, prev_aria_label_attr)}</span>)
+        a.(p_prev, text, aria_label:)
       else
-        %(<span class="page prev disabled"><a role="link" aria-disabled="true" #{
-             prev_aria_label_attr}>#{text}</a></span>)
+        %(<a role="link" aria-disabled="true" aria-label="#{aria_label}">#{text}</a>)
       end
     end
 
-    def next_html(pagy, link, text: pagy_t('pagy.next'))
+    def next_a(pagy, a, text: pagy_t('pagy.next'), aria_label: pagy_t('pagy.aria_label.next'))
       if (p_next = pagy.next)
-        %(<span class="page next">#{link.call(p_next, text, next_aria_label_attr)}</span>)
+        a.(p_next, text, aria_label:)
       else
-        %(<span class="page next disabled"><a role="link" aria-disabled="true" #{
-            next_aria_label_attr}>#{text}</a></span>)
+        %(<a role="link" aria-disabled="true" aria-label="#{aria_label}">#{text}</a>)
       end
     end
   end

data/lib/pagy/url_helpers.rb

@@ -8,20 +8,19 @@ class Pagy
     # For non-rack environments you can use the standalone extra
     def pagy_url_for(pagy, page, absolute: false, **_)
       vars         = pagy.vars
-      request_path = vars[:request_path].to_s.empty? ? request.path : vars[:request_path]
-      pagy_params  = pagy.params.is_a?(Hash) ? pagy.params.transform_keys(&:to_s) : {}
-      params       = request.GET.merge(pagy_params)
-      pagy_set_query_params(page, vars, params)
-      params       = pagy.params.call(params) if pagy.params.is_a?(Proc)
-      query_string = "?#{Rack::Utils.build_nested_query(params)}"
-      "#{request.base_url if absolute}#{request_path}#{query_string}#{vars[:fragment]}"
+      query_params = request.GET.clone
+      query_params.merge!(vars[:params].transform_keys(&:to_s)) if vars[:params].is_a?(Hash)
+      pagy_set_query_params(page, vars, query_params)
+      query_params = vars[:params].(query_params) if vars[:params].is_a?(Proc)
+      query_string = "?#{Rack::Utils.build_nested_query(query_params)}"
+      "#{request.base_url if absolute}#{vars[:request_path] || request.path}#{query_string}#{vars[:fragment]}"
     end
 
     # Add the page and items params
     # Overridable by the jsonapi extra
-    def pagy_set_query_params(page, vars, params)
-      params[vars[:page_param].to_s]  = page
-      params[vars[:items_param].to_s] = vars[:items] if vars[:items_extra]
+    def pagy_set_query_params(page, vars, query_params)
+      query_params[vars[:page_param].to_s]  = page
+      query_params[vars[:items_param].to_s] = vars[:items] if vars[:items_extra]
     end
   end
 end