Class: GovukPublishingComponents::Presenters::PaginationHelper

Inherits:
Object
  • Object
show all
Includes:
ActionView::Context, ActionView::Helpers
Defined in:
lib/govuk_publishing_components/presenters/pagination_helper.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(local_assigns) ⇒ PaginationHelper 



9
10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 9

def initialize(local_assigns)
  @arrow_links = {
    next: local_assigns[:next_page] || nil,
    prev: local_assigns[:previous_page] || nil,
  }
  @items = local_assigns[:items] || nil

  @disable_ga4 = local_assigns[:disable_ga4] || nil
  @ga4_type = has_pages? ? "pagination" : "previous and next"
  @prev_link = arrow_link_helper(direction: "prev")
  @next_link = arrow_link_helper(direction: "next")
  @page_links = pages_link_helper
end

Instance Attribute Details

#ga4_type ⇒ Object (readonly)

Returns the value of attribute ga4_type.



7
8
9
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 7

def ga4_type
  @ga4_type
end

#next_link ⇒ Object (readonly)

Returns the value of attribute next_link.



7
8
9
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 7

def next_link
  @next_link
end

#page_links ⇒ Object (readonly)

Returns the value of attribute page_links.



7
8
9
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 7

def page_links
  @page_links
end

#prev_link ⇒ Object (readonly)

Returns the value of attribute prev_link.



7
8
9
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 7

def prev_link
  @prev_link
end

Instance Method Details



72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 72

def arrow_link_helper(direction:)
  arrow_link_options = @arrow_links[direction.to_sym]

  return if arrow_link_options.blank?

  { href: nil, label: nil, title: nil, icon: nil, **arrow_link_options.symbolize_keys } => { href:, label:, title:, icon: }

  title ||= {
    "prev": t("components.pagination.previous"),
    "next": t("components.pagination.next"),
  }[direction.to_sym]

  section = {
    prev: "Previous",
    next: "Next",
  }[direction.to_sym]

  ga4_link = ga4_link_event(text: label || title, section:)

  link_text_classes = %w[govuk-pagination__link-title]
  link_text_classes << "govuk-pagination__link-title--decorated" if label.blank?

  content_tag(:div, class: "govuk-pagination__#{direction}") do
    content_tag(:a, href:, class: "govuk-link govuk-pagination__link", data: { ga4_link: }) do
      concat icon if direction == "prev" || !has_pages? && direction == "next"
      concat content_tag(:span, title, class: link_text_classes)
      concat icon if has_pages? && direction == "next"
      concat content_tag(:span, ":", class: "govuk-visually-hidden") if label.present?
      concat content_tag(:span, label, class: "govuk-pagination__link-label") if label.present?
    end
  end
end

#ga4_link_event(text:, section:) ⇒ Object 



23
24
25
26
27
28
29
30
31
32
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 23

def ga4_link_event(text:, section:)
  unless @disable_ga4
    {
      event_name: "navigation",
      type: @ga4_type,
      text:,
      section:,
    }.to_json
  end
end

#has_links? ⇒ Boolean 



34
35
36
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 34

def has_links?
  has_pages? || @prev_link || @next_link
end

#has_pages? ⇒ Boolean 



38
39
40
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 38

def has_pages?
  @items.present?
end

#pages_link_helper ⇒ Object 



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'lib/govuk_publishing_components/presenters/pagination_helper.rb', line 42

def pages_link_helper
  return unless has_pages?

  page_links = @items.each_with_index.map do |item, index|
    { href: nil, ellipsis: nil, current: nil, number: nil, visually_hidden_text: nil, **item.symbolize_keys } => { href:, ellipsis:, current:, number:, visually_hidden_text: }

    raise ArgumentError, "Number or ellipsis value required for item #{index}" if ellipsis.blank? && number.blank?

    list_item_classes = %w[govuk-pagination__item]
    list_item_classes << "govuk-pagination__item--ellipsis" if ellipsis
    list_item_classes << "govuk-pagination__item--current" if current

    item_aria_label = visually_hidden_text || "Page #{number}"

    ga4_link = ga4_link_event(text: number, section: "Pagination list")

    content_tag(:li, class: list_item_classes) do
      if ellipsis
        "&ctdot;".html_safe
      else
        content_tag(:a, number, class: "govuk-link govuk-pagination__link", href:, aria: { label: item_aria_label, current: current ? "page" : nil }, data: { ga4_link: })
      end
    end
  end

  content_tag(:ul, class: "govuk-pagination__list") do
    page_links.collect { |page_link| concat(page_link) }
  end
end