govuk-components 3.0.6 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29b10e73219c963307d21f99d72735e6a3c111864f539f854a7909959079a7a9
-  data.tar.gz: 6d0f7e00ac6997453d35257300d6691ebe34522fb472198366e35a31fe2e4159
+  metadata.gz: e7d91723138110b84d128cc377b0c458ee7dca3714b77708581ffc2ce7c55e8e
+  data.tar.gz: 784446ce4999d80eefe5c176ce17d4e4952163cd460996b9530a01e6a51d17e1
 SHA512:
-  metadata.gz: f04e75ad394385e5307995baee4389ef1e564a09511db958afb49996888fa21bba1bb5216e9e9af7f23baed47c5733f7afde289efa591ece0d388c7c87c37627
-  data.tar.gz: 5671279d11164ea6d9acc834ee34feaada6f9d3ed9a3851ad3d73d56f2ace240c98ff7bbb7b65dd214f1e398b5c010d61770fc602448690e1958cfb86ef6542e
+  metadata.gz: 106c70d02e199030904967f1a814baa564d6c4397978d99b1afdbcbe80f8414d94589a83c39317c80a0fa75fa0841d835090f49b76b2597956f0838ec763824f
+  data.tar.gz: 5aa69c78b7879be82256aac6d6e7ba967de6179ae4ba9386501d4f31179a5b0b07cd2d16648e0c135d2cf32b5462725a2a7931433a4af08bb2133f9889dbef4d

data/README.md

@@ -6,7 +6,7 @@
 [![Gem](https://img.shields.io/gem/dt/govuk-components?logo=rubygems)](https://rubygems.org/gems/govuk-components)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/cbcbc140f300b920d833/test_coverage)](https://codeclimate.com/github/DFE-Digital/govuk-components/test_coverage)
 [![GitHub license](https://img.shields.io/github/license/DFE-Digital/govuk-components)](https://github.com/DFE-Digital/govuk-components/blob/main/LICENSE)
-[![GOV.UK Design System Version](https://img.shields.io/badge/GOV.UK%20Design%20System-4.1.0-brightgreen)](https://design-system.service.gov.uk)
+[![GOV.UK Design System Version](https://img.shields.io/badge/GOV.UK%20Design%20System-4.2.0-brightgreen)](https://design-system.service.gov.uk)
 [![Rails](https://img.shields.io/badge/Rails-6.1.5%20%E2%95%B1%207.0.3-E16D6D)](https://weblog.rubyonrails.org/releases/)
 [![Ruby](https://img.shields.io/badge/Ruby-2.7.5%20%20%E2%95%B1%203.0.3%20%20%E2%95%B1%203.1.0-E16D6D)](https://www.ruby-lang.org/en/downloads/)
 

data/app/components/govuk_component/base.rb

@@ -4,6 +4,11 @@ class GovukComponent::Base < ViewComponent::Base
   attr_reader :html_attributes
 
   def initialize(classes:, html_attributes:)
+    if classes.nil?
+      Rails.logger.warn("classes is nil, if no custom classes are needed omit the param")
+
+      classes = []
+    end
     # FIXME: remove first merge when we deprecate classes
     #
     # This step only needs to be here while we still accept classes:, now

data/app/components/govuk_component/header_component.html.erb

@@ -32,7 +32,7 @@
     <% if service_name.present? || navigation_items.present? %>
       <div class="govuk-header__content">
         <% if service_name.present? %>
-          <%= link_to(service_name, service_url, class: %w(govuk-header__link govuk-header__link--service-name)) %>
+          <%= link_to(service_name, service_url, class: %w(govuk-header__link govuk-header__service-name)) %>
         <% end %>
 
         <% if navigation_items.any? %>

data/app/components/govuk_component/pagination_component/adjacent_page.rb

@@ -0,0 +1,60 @@
+class GovukComponent::PaginationComponent::AdjacentPage < GovukComponent::Base
+  attr_reader :href, :label_text, :text, :suffix, :block_mode, :visually_hidden_text
+  alias_method :block_mode?, :block_mode
+
+  def initialize(href:, suffix:, visually_hidden_text:, text:, block_mode: true, label_text: nil, classes: [], html_attributes: {})
+    @href                 = href
+    @label_text           = label_text
+    @text                 = text
+    @block_mode           = block_mode
+    @suffix               = suffix
+    @visually_hidden_text = visually_hidden_text
+
+    super(html_attributes: html_attributes, classes: classes)
+  end
+
+  def call
+    tag.div(**html_attributes) do
+      tag.a(href: href, class: %w(govuk-link govuk-pagination__link), rel: suffix, aria: { label: aria_label }) do
+        safe_join([body, divider, label_content])
+      end
+    end
+  end
+
+private
+
+  def default_attributes
+    { class: ["govuk-pagination__#{suffix}"] }
+  end
+
+  def body
+    [arrow, title_span]
+  end
+
+  def title_span
+    tag.span(text, class: title_classes)
+  end
+
+  def divider
+    return if label_text.blank?
+
+    tag.span(":", class: %w(govuk-visually-hidden))
+  end
+
+  def label_content
+    return if label_text.blank?
+
+    tag.span(label_text, class: label_classes)
+  end
+
+  def title_classes
+    class_names(
+      %(govuk-pagination__link-title),
+      %(govuk-pagination__link-title--decorated) => label_text.blank?
+    )
+  end
+
+  def label_classes
+    %w(govuk-pagination__link-label)
+  end
+end

data/app/components/govuk_component/pagination_component/item.rb

@@ -0,0 +1,77 @@
+class GovukComponent::PaginationComponent::Item < GovukComponent::Base
+  attr_reader :number, :href, :visually_hidden_text, :mode
+
+  def initialize(number: nil, href: nil, current: false, ellipsis: false, from_pagy: false, visually_hidden_text: nil, classes: [], html_attributes: {})
+    @number               = number
+    @href                 = href
+    @visually_hidden_text = visually_hidden_text
+
+    # We have three modes for rendering links:
+    #
+    #  * link    (a link to another page)
+    #  * current (a link to the current page)
+    #  * gap     (an ellipsis symbol)
+    #
+    # Pagy sets these by object type:
+    # Integer = link
+    # String  = current
+    # :gap    = gap
+    #
+    # The original Nunjucks component has two boolean settings instead,
+    # ellipsis and current. When ellipsis is true all other arguments are
+    # ignored
+    @mode = from_pagy ? pagy_mode(number) : manual_mode(ellipsis, current)
+
+    super(classes: classes, html_attributes: html_attributes)
+  end
+
+  def call
+    case mode
+    when :link
+      link(current: false)
+    when :current
+      link(current: true)
+    when :gap
+      ellipsis_item
+    end
+  end
+
+private
+
+  def pagy_mode(number)
+    return :link    if number.is_a?(Integer)
+    return :current if number.is_a?(String)
+
+    :gap
+  end
+
+  def manual_mode(ellipsis, current)
+    return :gap     if ellipsis
+    return :current if current
+
+    :link
+  end
+
+  def link(current: false)
+    attributes = html_attributes.tap { |ha| ha[:class] << "govuk-pagination__item--current" if current }
+
+    tag.li(**attributes) do
+      tag.a(href: href, class: %w(govuk-link govuk-pagination__link)) { number.to_s }
+    end
+  end
+
+  def ellipsis_item
+    tag.li("⋯", class: %w(govuk-pagination__item govuk-pagination__item--ellipses))
+  end
+
+  def default_attributes
+    {
+      class: %w(govuk-pagination__item),
+      aria: { label: aria_label }
+    }
+  end
+
+  def aria_label
+    visually_hidden_text || "Page #{number}"
+  end
+end

data/app/components/govuk_component/pagination_component/next_page.rb

@@ -0,0 +1,32 @@
+class GovukComponent::PaginationComponent::NextPage < GovukComponent::PaginationComponent::AdjacentPage
+  def initialize(href:, text:, label_text: nil, visually_hidden_text: nil, block_mode: true, classes: [], html_attributes: {})
+    super(
+      suffix: "next",
+      text: text,
+      href: href,
+      label_text: label_text,
+      block_mode: block_mode,
+      visually_hidden_text: visually_hidden_text,
+      classes: classes,
+      html_attributes: html_attributes
+    )
+  end
+
+  def body
+    return [arrow, title_span] if block_mode?
+
+    [title_span, arrow]
+  end
+
+private
+
+  def aria_label
+    @visually_hidden_text || "Next page"
+  end
+
+  def arrow
+    tag.svg(class: "govuk-pagination__icon govuk-pagination__icon--next", xmlns: "http://www.w3.org/2000/svg", height: "13", width: "15", focusable: "false", viewBox: "0 0 15 13", aria: { hidden: "true" }) do
+      tag.path(d: "m8.107-0.0078125-1.4136 1.414 4.2926 4.293h-12.986v2h12.896l-4.1855 3.9766 1.377 1.4492 6.7441-6.4062-6.7246-6.7266z")
+    end
+  end
+end

data/app/components/govuk_component/pagination_component/previous_page.rb

@@ -0,0 +1,26 @@
+class GovukComponent::PaginationComponent::PreviousPage < GovukComponent::PaginationComponent::AdjacentPage
+  def initialize(href:, text:, label_text: nil, visually_hidden_text: nil, block_mode: true, classes: [], html_attributes: {})
+    super(
+      suffix: "prev",
+      text: text,
+      href: href,
+      label_text: label_text,
+      block_mode: block_mode,
+      visually_hidden_text: visually_hidden_text,
+      classes: classes,
+      html_attributes: html_attributes
+    )
+  end
+
+private
+
+  def aria_label
+    @visually_hidden_text || "Previous page"
+  end
+
+  def arrow
+    tag.svg(class: "govuk-pagination__icon govuk-pagination__icon--prev", xmlns: "http://www.w3.org/2000/svg", height: "13", width: "15", focusable: "false", viewBox: "0 0 15 13", aria: { hidden: "true" }) do
+      tag.path(d: "m6.5938-0.0078125-6.7266 6.7266 6.7441 6.4062 1.377-1.449-4.1856-3.9768h12.896v-2h-12.984l4.2931-4.293-1.414-1.414z")
+    end
+  end
+end

data/app/components/govuk_component/pagination_component.rb

@@ -0,0 +1,121 @@
+class GovukComponent::PaginationComponent < GovukComponent::Base
+  include Pagy::UrlHelpers
+
+  attr_reader :pagy,
+              :next_text,
+              :previous_text,
+              :visually_hidden_next_text,
+              :visually_hidden_previous_text,
+              :page_items,
+              :previous_content,
+              :next_content,
+              :block_mode,
+              :landmark_label
+
+  alias_method :block_mode?, :block_mode
+
+  renders_many :items, "GovukComponent::PaginationComponent::Item"
+
+  renders_one :next_page, ->(href:, text: default_next_text, label_text: nil, visually_hidden_text: nil, classes: [], html_attributes: {}) do
+    GovukComponent::PaginationComponent::NextPage.new(
+      text: text,
+      href: href,
+      label_text: label_text,
+      block_mode: block_mode?,
+      visually_hidden_text: visually_hidden_text,
+      classes: classes,
+      html_attributes: html_attributes
+    )
+  end
+
+  renders_one :previous_page, ->(href:, text: default_previous_text, label_text: nil, visually_hidden_text: nil, classes: [], html_attributes: {}) do
+    GovukComponent::PaginationComponent::PreviousPage.new(
+      text: text,
+      href: href,
+      label_text: label_text,
+      block_mode: block_mode?,
+      visually_hidden_text: visually_hidden_text,
+      classes: classes,
+      html_attributes: html_attributes
+    )
+  end
+
+  def initialize(pagy: nil, next_text: nil, previous_text: nil, visually_hidden_next_text: nil, visually_hidden_previous_text: nil, block_mode: false, landmark_label: "results", classes: [], html_attributes: {})
+    @pagy                          = pagy
+    @next_text                     = next_text
+    @previous_text                 = previous_text
+    @visually_hidden_next_text     = visually_hidden_next_text
+    @visually_hidden_previous_text = visually_hidden_previous_text
+    @block_mode                    = block_mode
+    @landmark_label                = landmark_label
+
+    build_items if pagy.present?
+
+    super(classes: classes, html_attributes: html_attributes)
+  end
+
+  def before_render
+    @page_items       = items || build_items
+    @previous_content = previous_page || build_previous
+    @next_content     = next_page || build_next
+  end
+
+  def call
+    attributes = html_attributes.tap { |ha| (ha[:class] << "govuk-pagination--block") if items.empty? }
+
+    tag.nav(**attributes) do
+      safe_join([
+        previous_content,
+        tag.ul(class: "govuk-pagination__list") { safe_join(page_items) },
+        next_content
+      ])
+    end
+  end
+
+  def render?
+    # probably isn't any point rendering if there's only one page
+    (pagy.present? && pagy.series.size > 1) || @previous_content.present? || @next_content.present?
+  end
+
+private
+
+  def default_attributes
+    { role: "navigation", aria: { label: landmark_label }, class: %w(govuk-pagination) }
+  end
+
+  def build_previous
+    return unless pagy&.prev
+
+    kwargs = {
+      href: pagy_url_for(pagy, pagy.prev),
+      text: @previous_text,
+      visually_hidden_text: visually_hidden_previous_text,
+    }
+
+    previous_page(**kwargs.compact)
+  end
+
+  def build_next
+    return unless pagy&.next
+
+    kwargs = {
+      href: pagy_url_for(pagy, pagy.next),
+      text: @next_text,
+      visually_hidden_text: visually_hidden_next_text,
+    }
+
+    next_page(**kwargs.compact)
+  end
+
+  def build_items
+    pagy.series.map { |i| item(number: i, href: pagy_url_for(pagy, i), from_pagy: true) }
+  end
+
+  def default_next_text
+    safe_join(["Next", tag.span(class: "govuk-visually-hidden") { " page" }])
+  end
+
+  def default_previous_text
+    safe_join(["Previous", tag.span(class: "govuk-visually-hidden") { " page" }])
+  end
+end

data/app/helpers/govuk_components_helper.rb

@@ -9,6 +9,7 @@ module GovukComponentsHelper
     govuk_header: 'GovukComponent::HeaderComponent',
     govuk_inset_text: 'GovukComponent::InsetTextComponent',
     govuk_notification_banner: 'GovukComponent::NotificationBannerComponent',
+    govuk_pagination: 'GovukComponent::PaginationComponent',
     govuk_panel: 'GovukComponent::PanelComponent',
     govuk_phase_banner: 'GovukComponent::PhaseBannerComponent',
     govuk_section_break: 'GovukComponent::SectionBreakComponent',

data/lib/govuk/components/version.rb

@@ -1,5 +1,5 @@
 module Govuk
   module Components
-    VERSION = '3.0.6'.freeze
+    VERSION = '3.1.0'.freeze
   end
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: govuk-components
 version: !ruby/object:Gem::Version
-  version: 3.0.6
+  version: 3.1.0
 platform: ruby
 authors:
 - DfE developers
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-09 00:00:00.000000000 Z
+date: 2022-06-27 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
@@ -44,28 +58,34 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.2
 - !ruby/object:Gem::Dependency
   name: view_component
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.49.1
+        version: 2.56.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.49.1
+        version: 2.56.2
 - !ruby/object:Gem::Dependency
   name: deep_merge
   requirement: !ruby/object:Gem::Requirement
@@ -206,6 +226,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.11'
+- !ruby/object:Gem::Dependency
+  name: pagy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.10.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.10.1
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -348,6 +382,11 @@ files:
 - app/components/govuk_component/inset_text_component.rb
 - app/components/govuk_component/notification_banner_component.html.erb
 - app/components/govuk_component/notification_banner_component.rb
+- app/components/govuk_component/pagination_component.rb
+- app/components/govuk_component/pagination_component/adjacent_page.rb
+- app/components/govuk_component/pagination_component/item.rb
+- app/components/govuk_component/pagination_component/next_page.rb
+- app/components/govuk_component/pagination_component/previous_page.rb
 - app/components/govuk_component/panel_component.rb
 - app/components/govuk_component/phase_banner_component.html.erb
 - app/components/govuk_component/phase_banner_component.rb