module ActionView module Helpers # Provides methods for linking to ActionController::Pagination objects. # # You can also build your links manually, like in this example: # # <%= link_to "Previous page", { :page => paginator.current.previous } if paginator.current.previous %> # # <%= link_to "Next page", { :page => paginator.current.next } if paginator.current.next =%> module PaginationHelper unless const_defined?(:DEFAULT_OPTIONS) DEFAULT_OPTIONS = { :name => :page, :window_size => 2, :always_show_anchors => true, :link_to_current_page => false, :params => {} } end # Creates a basic HTML link bar for the given +paginator+. # # +options+ are: # :name:: the routing name for this paginator # (defaults to +page+) # :window_size:: the number of pages to show around # the current page (defaults to +2+) # :always_show_anchors:: whether or not the first and last # pages should always be shown # (defaults to +true+) # :link_to_current_page:: whether or not the current page # should be linked to (defaults to # +false+) # :params:: any additional routing parameters # for page URLs def pagination_links(paginator, options={}) options.merge!(DEFAULT_OPTIONS) {|key, old, new| old} pagination_links_each(paginator, options[:window_size], options[:always_show_anchors], options[:link_to_current_page]) do |n| link_to(n.to_s, { options[:name] => n }.update(options[:params])) end end # Iterate through the pages of a given +paginator+, invoking a # block for each page number that needs to be rendered as a link. def pagination_links_each(paginator, window_size=2, always_show_anchors=true, link_to_current_page=false) current_page = paginator.current_page window_pages = current_page.window(window_size).pages return if window_pages.length <= 1 unless link_to_current_page first, last = paginator.first, paginator.last html = '' if always_show_anchors and not (wp_first = window_pages[0]).first? html << yield(first.number) html << ' ... ' if wp_first.number - first.number > 1 html << ' ' end window_pages.each do |page| if current_page == page && !link_to_current_page html << page.number.to_s else html << yield(page.number) end html << ' ' end if always_show_anchors and not (wp_last = window_pages[-1]).last? html << ' ... ' if last.number - wp_last.number > 1 html << yield(last.number) end html end end # PaginationHelper end # Helpers end # ActionView