govuk-components 3.1.4 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3840e40ffafa0fc239e251a1fd9f76c2bf6b290d0ea2f6df6a0dfd7300dd5f7
-  data.tar.gz: e0bbfa5d779cf3a40edce2b7282beb355738643098f50bb6a24dcb5c182a3548
+  metadata.gz: 82c6c791cb04272f6d9c26584648e77df868106c405b03e8ab45de1d887e982c
+  data.tar.gz: 97a343854b2584929d0bbe0e184773463cfc208c6d100d6719650fe117839607
 SHA512:
-  metadata.gz: bdf53c97e701ab06061022e6058e70a5bc8566cd5b6fb563c51c53c364d2d70281f2aea9883bafc8f7c510be4e3fbe478580cd3dd6496e00f774c7b9f5e4b044
-  data.tar.gz: 7b85bbcdd1f5f05fe12a1bacdd6a56e488428174976f1b92db1eb9cfb17e9487f3c569e14532c91e6f5611e94afff18251984200c8406345dd463f296f1421e9
+  metadata.gz: fab4a1347e860c70cfa70314c634c550e776fce5a3b661877c0daaba84fa1da8678c56a58dbae572299ac6ddf279ee8277ae29509edc46933bb47c4dc94e7173
+  data.tar.gz: 678e902ca916bc9ad00944d555e8678b3897071f2b1f50e3eeb99585f5f412e3d91d22a7909c882b336ec98be4beadfd2ed488485fd472996c8b5552901782ab

data/README.md

@@ -6,14 +6,23 @@
 [![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.2.0-brightgreen)](https://design-system.service.gov.uk)
+[![GOV.UK Design System Version](https://img.shields.io/badge/GOV.UK%20Design%20System-4.3.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.2-E16D6D)](https://www.ruby-lang.org/en/downloads/)
+[![Ruby](https://img.shields.io/badge/Ruby-2.7.6%20%20%E2%95%B1%203.0.3%20%20%E2%95%B1%203.1.2-E16D6D)](https://www.ruby-lang.org/en/downloads/)
 
 This gem provides a suite of reusable components for the [GOV.UK Design System](https://design-system.service.gov.uk/). It is intended to provide a lightweight alternative to the [GOV.UK Publishing Components](https://github.com/alphagov/govuk_publishing_components) library and is built with GitHub’s [ViewComponent](https://github.com/github/view_component) framework.
 
 It aims to implement the functionality from the original Nunjucks macros in a way that will feel more familiar to Rails developers. Blocks are preferred over strings of HTML, beneath the surface each component is just a Ruby object, everything is inheritable and overrideable.
 
+## Documentation
+
+The gem comes with [a full guide](https://govuk-components.netlify.app/) that
+covers most aspects of day-to-day use, along with code and output examples. The
+examples in the guide (and the guide itself) are built using the components,
+so it will always be up to date.
+
+[![Netlify Status](https://api.netlify.com/api/v1/badges/d40a5a0a-b086-4c35-b046-97fbcbf9f219/deploy-status)](https://app.netlify.com/sites/govuk-components/deploys)
+
 ## What’s included?
 
 All of the non-form components from the GOV.UK Design System are implemented by this library as ViewComponents. Form components are implemented by the [GOV.UK Form Builder](https://govuk-form-builder.netlify.app/).

data/app/components/govuk_component/back_link_component.rb

@@ -1,7 +1,7 @@
 class GovukComponent::BackLinkComponent < GovukComponent::Base
   attr_reader :text, :href
 
-  def initialize(href:, text: 'Back', classes: [], html_attributes: {})
+  def initialize(href:, text: config.default_back_link_text, classes: [], html_attributes: {})
     @text = text
     @href = href
 

data/app/components/govuk_component/base.rb

@@ -3,6 +3,8 @@ class GovukComponent::Base < ViewComponent::Base
 
   attr_reader :html_attributes
 
+  delegate :config, to: Govuk::Components
+
   def initialize(classes:, html_attributes:)
     if classes.nil?
       Rails.logger.warn("classes is nil, if no custom classes are needed omit the param")

data/app/components/govuk_component/breadcrumbs_component.rb

@@ -1,7 +1,12 @@
 class GovukComponent::BreadcrumbsComponent < GovukComponent::Base
   attr_reader :breadcrumbs, :hide_in_print, :collapse_on_mobile
 
-  def initialize(breadcrumbs:, hide_in_print: false, collapse_on_mobile: false, classes: [], html_attributes: {})
+  def initialize(breadcrumbs:,
+                 hide_in_print: config.default_breadcrumbs_hide_in_print,
+                 collapse_on_mobile: config.default_breadcrumbs_collapse_on_mobile,
+                 classes: [],
+                 html_attributes: {})
+
     @breadcrumbs        = build_list(breadcrumbs)
     @hide_in_print      = hide_in_print
     @collapse_on_mobile = collapse_on_mobile

data/app/components/govuk_component/cookie_banner_component.rb

@@ -4,7 +4,13 @@ module GovukComponent
 
     attr_accessor :aria_label, :hidden, :hide_in_print
 
-    def initialize(aria_label: "Cookie banner", hidden: false, hide_in_print: true, classes: [], html_attributes: {})
+    def initialize(
+      aria_label: config.default_cookie_banner_aria_label,
+      hidden: false,
+      hide_in_print: config.default_cookie_banner_hide_in_print,
+      classes: [],
+      html_attributes: {}
+    )
       @aria_label    = aria_label
       @hidden        = hidden
       @hide_in_print = hide_in_print

data/app/components/govuk_component/footer_component.rb

@@ -11,13 +11,13 @@ class GovukComponent::FooterComponent < GovukComponent::Base
     classes: [],
     container_classes: [],
     container_html_attributes: {},
-    copyright_text: default_copright_text,
-    copyright_url: default_copyright_url,
+    copyright_text: config.default_footer_copyright_text,
+    copyright_url: config.default_footer_copyright_url,
     html_attributes: {},
     meta_items: {},
     meta_items_title: "Support links",
     meta_licence: nil,
-    meta_text: nil,
+    meta_text: config.default_footer_component_meta_text,
     meta_classes: [],
     meta_html_attributes: {}
   )
@@ -84,12 +84,4 @@ private
   def build_copyright(text, url)
     link_to(text, url, class: %w(govuk-footer__link govuk-footer__copyright-logo))
   end
-
-  def default_copright_text
-    raw(%(© Crown copyright))
-  end
-
-  def default_copyright_url
-    "https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/"
-  end
 end

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

@@ -37,7 +37,7 @@
 
         <% if navigation_items.any? %>
           <%= tag.nav(**navigation_html_attributes) do %>
-            <%= tag.button("Menu", type: "button", class: %w(govuk-header__menu-button govuk-js-header-toggle), aria: { controls: "navigation", label: menu_button_label }) %>
+            <%= tag.button("Menu", type: "button", class: %w(govuk-header__menu-button govuk-js-header-toggle), hidden: true, aria: { controls: "navigation", label: menu_button_label }) %>
             <ul id="navigation" class="govuk-header__navigation-list">
               <% navigation_items.each do |item| %>
                 <%= item %>

data/app/components/govuk_component/header_component.rb

@@ -16,15 +16,15 @@ class GovukComponent::HeaderComponent < GovukComponent::Base
 
   def initialize(classes: [],
                  html_attributes: {},
-                 logotype: 'GOV.UK',
+                 logotype: config.default_header_logotype,
                  crown: true,
                  crown_fallback_image_path: nil,
-                 homepage_url: '/',
-                 menu_button_label: 'Show or hide navigation menu',
+                 homepage_url: config.default_header_homepage_url,
+                 menu_button_label: config.default_header_menu_button_label,
                  navigation_classes: [],
-                 navigation_label: 'Navigation menu',
-                 service_name: nil,
-                 service_url: '/',
+                 navigation_label: config.default_header_navigation_label,
+                 service_name: config.default_header_service_name,
+                 service_url: config.default_header_service_url,
                  container_classes: nil)
 
     @logotype                  = logotype

data/app/components/govuk_component/notification_banner_component.rb

@@ -4,7 +4,17 @@ class GovukComponent::NotificationBannerComponent < GovukComponent::Base
   renders_one :title_html
   renders_many :headings, "Heading"
 
-  def initialize(title_text: nil, text: nil, role: nil, success: false, title_heading_level: 2, title_id: "govuk-notification-banner-title", disable_auto_focus: nil, classes: [], html_attributes: {})
+  def initialize(
+    title_text: nil,
+    text: nil,
+    role: nil,
+    success: config.default_notification_title_success,
+    title_heading_level: config.default_notification_title_heading_level,
+    title_id: config.default_notification_banner_title_id,
+    disable_auto_focus: config.default_notification_disable_auto_focus,
+    classes: [],
+    html_attributes: {}
+  )
     @title_text          = title_text
     @title_id            = title_id
     @text                = text

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

@@ -2,20 +2,19 @@ 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: {})
+  def initialize(href:, suffix:, 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
+      tag.a(href: href, class: %w(govuk-link govuk-pagination__link), rel: suffix) do
         safe_join([body, divider, label_content])
       end
     end

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

@@ -1,12 +1,11 @@
 class GovukComponent::PaginationComponent::NextPage < GovukComponent::PaginationComponent::AdjacentPage
-  def initialize(href:, text:, label_text: nil, visually_hidden_text: nil, block_mode: true, classes: [], html_attributes: {})
+  def initialize(href:, text:, label_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
     )
@@ -20,10 +19,6 @@ class GovukComponent::PaginationComponent::NextPage < GovukComponent::Pagination
 
 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")

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

@@ -1,12 +1,11 @@
 class GovukComponent::PaginationComponent::PreviousPage < GovukComponent::PaginationComponent::AdjacentPage
-  def initialize(href:, text:, label_text: nil, visually_hidden_text: nil, block_mode: true, classes: [], html_attributes: {})
+  def initialize(href:, text:, label_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
     )
@@ -14,10 +13,6 @@ class GovukComponent::PaginationComponent::PreviousPage < GovukComponent::Pagina
 
 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")

data/app/components/govuk_component/pagination_component.rb

@@ -4,8 +4,6 @@ class GovukComponent::PaginationComponent < GovukComponent::Base
   attr_reader :pagy,
               :next_text,
               :previous_text,
-              :visually_hidden_next_text,
-              :visually_hidden_previous_text,
               :page_items,
               :previous_content,
               :next_content,
@@ -16,36 +14,38 @@ class GovukComponent::PaginationComponent < GovukComponent::Base
 
   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
+  renders_one :next_page, ->(href:, text: default_adjacent_text(:next), label_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
+  renders_one :previous_page, ->(href:, text: default_adjacent_text(:prev), label_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: {})
+  def initialize(pagy: nil,
+                 next_text: nil,
+                 previous_text: nil,
+                 block_mode: false,
+                 landmark_label: config.default_pagination_landmark_label,
+                 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
 
@@ -94,7 +94,6 @@ private
     kwargs = {
       href: pagy_url_for(pagy, pagy.prev),
       text: @previous_text,
-      visually_hidden_text: visually_hidden_previous_text,
     }
 
     previous_page(**kwargs.compact)
@@ -106,7 +105,6 @@ private
     kwargs = {
       href: pagy_url_for(pagy, pagy.next),
       text: @next_text,
-      visually_hidden_text: visually_hidden_next_text,
     }
 
     next_page(**kwargs.compact)
@@ -116,11 +114,16 @@ private
     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_adjacent_text(side)
+    visible, hidden = *case side
+                       when :next
+                         config.default_pagination_next_text
+                       when :prev
+                         config.default_pagination_previous_text
+                       end
+
+    return visible if hidden.blank?
 
-  def default_previous_text
-    safe_join(["Previous", tag.span(class: "govuk-visually-hidden") { " page" }])
+    (visible + tag.span(" #{hidden}", class: "govuk-visually-hidden")).html_safe
   end
 end

data/app/components/govuk_component/phase_banner_component.rb

@@ -1,7 +1,12 @@
 class GovukComponent::PhaseBannerComponent < GovukComponent::Base
   attr_reader :text, :phase_tag
 
-  def initialize(tag: nil, text: nil, classes: [], html_attributes: {})
+  def initialize(
+    tag: { text: config.default_phase_banner_tag },
+    text: config.default_phase_banner_text,
+    classes: [],
+    html_attributes: {}
+  )
     @phase_tag = tag
     @text      = text
 

data/app/components/govuk_component/section_break_component.rb

@@ -1,7 +1,12 @@
 class GovukComponent::SectionBreakComponent < GovukComponent::Base
   SIZES = %w(m l xl).freeze
 
-  def initialize(visible: false, size: nil, classes: [], html_attributes: {})
+  def initialize(
+    visible: config.default_section_break_visible,
+    size: config.default_section_break_size,
+    classes: [],
+    html_attributes: {}
+  )
     @visible = visible
     @size    = size
 

data/app/components/govuk_component/start_button_component.rb

@@ -8,7 +8,7 @@ class GovukComponent::StartButtonComponent < GovukComponent::Base
 
   attr_reader :text, :href, :as_button
 
-  def initialize(text:, href:, as_button: false, classes: [], html_attributes: {})
+  def initialize(text:, href:, as_button: config.default_start_button_as_button, classes: [], html_attributes: {})
     @text = text
     @href = href
     @as_button = as_button

data/app/components/govuk_component/summary_list_component/action_component.rb

@@ -1,7 +1,13 @@
 class GovukComponent::SummaryListComponent::ActionComponent < GovukComponent::Base
+  class VisuallyHiddenDefaultNilClass < NilClass; end
+
   attr_reader :href, :text, :visually_hidden_text, :attributes, :classes
 
-  def initialize(href: nil, text: 'Change', visually_hidden_text: nil, classes: [], html_attributes: {})
+  def initialize(href: nil, text: 'Change', visually_hidden_text: VisuallyHiddenDefaultNilClass, classes: [], html_attributes: {})
+    if config.require_summary_list_action_visually_hidden_text && visually_hidden_text == VisuallyHiddenDefaultNilClass
+      fail(ArgumentError, "missing keyword: visually_hidden_text")
+    end
+
     super(classes: classes, html_attributes: html_attributes)
 
     @href                 = href

data/app/components/govuk_component/summary_list_component.rb

@@ -11,7 +11,7 @@ module GovukComponent
       )
     end
 
-    def initialize(rows: nil, actions: true, borders: true, classes: [], html_attributes: {})
+    def initialize(rows: nil, actions: true, borders: config.default_summary_list_borders, classes: [], html_attributes: {})
       @borders             = borders
       @show_actions_column = actions
 

data/app/components/govuk_component/tag_component.rb

@@ -3,7 +3,7 @@ class GovukComponent::TagComponent < GovukComponent::Base
 
   COLOURS = %w(grey green turquoise blue red purple pink orange yellow).freeze
 
-  def initialize(text: nil, colour: nil, classes: [], html_attributes: {})
+  def initialize(text: nil, colour: config.default_tag_colour, classes: [], html_attributes: {})
     @text   = text
     @colour = colour
 

data/app/components/govuk_component/warning_text_component.rb

@@ -1,10 +1,9 @@
 class GovukComponent::WarningTextComponent < GovukComponent::Base
-  attr_reader :text, :icon_fallback_text
+  attr_reader :text, :icon, :icon_fallback_text
 
-  ICON = '!'.freeze
-
-  def initialize(text: nil, icon_fallback_text: 'Warning', classes: [], html_attributes: {})
+  def initialize(text: nil, icon_fallback_text: config.default_warning_text_icon_fallback_text, icon: config.default_warning_text_icon, classes: [], html_attributes: {})
     @text = text
+    @icon = icon
     @icon_fallback_text = icon_fallback_text
 
     super(classes: classes, html_attributes: html_attributes)
@@ -12,14 +11,14 @@ class GovukComponent::WarningTextComponent < GovukComponent::Base
 
   def call
     tag.div(**html_attributes) do
-      safe_join([icon, warning_text])
+      safe_join([icon_element, warning_text])
     end
   end
 
 private
 
-  def icon
-    tag.span(ICON, class: 'govuk-warning-text__icon', aria: { hidden: true })
+  def icon_element
+    tag.span(icon, class: 'govuk-warning-text__icon', aria: { hidden: true })
   end
 
   def warning_text

data/app/helpers/govuk_link_helper.rb

@@ -56,11 +56,7 @@ module GovukLinkHelper
     html_options = build_html_options(extra_options, style: :button)
 
     if block_given?
-      if Rails.version >= "7.0.0" && name.is_a?(Hash)
-        button_to(name.merge(html_options), &block)
-      else
-        button_to(name, html_options, &block)
-      end
+      button_to(options, html_options, &block)
     else
       button_to(name, options, html_options)
     end

data/lib/govuk/components/engine.rb

@@ -1,7 +1,106 @@
 require "rails/engine"
+require "active_support/configurable"
 
 module Govuk
   module Components
+    include ActiveSupport::Configurable
+
+    class << self
+      # Configure the form builder in the usual manner. All of the
+      # keys in {DEFAULTS} can be configured as per the example below
+      #
+      # @example
+      #   Govuk::Components.configure do |conf|
+      #     conf.do_some_things = 'yes'
+      #   end
+      def configure
+        yield(config)
+      end
+
+      # Resets each of the configurable values to its default
+      #
+      # @note This method is only really intended for use to clean up
+      #   during testing
+      def reset!
+        configure do |c|
+          DEFAULTS.each { |k, v| c.send("#{k}=", v) }
+        end
+      end
+    end
+
+    # @!group Defaults
+    #
+    # Default components configuration
+    #
+    # +:default_back_link_text+ Default text for the back link, defaults to +Back+
+    # +:default_breadcrumbs_collapse_on_mobile+ false
+    # +:default_breadcrumbs_hide_in_print+ false
+    # +:default_cookie_banner_aria_label+ "Cookie banner"
+    # +:default_cookie_banner_hide_in_print+ true
+    # +:default_header_navigation_label+ 'Navigation menu'
+    # +:default_header_menu_button_label+ 'Show or hide navigation menu'
+    # +:default_header_logotype+ 'GOV.UK'
+    # +:default_header_homepage_url+ '/'
+    # +:default_header_service_name+ nil
+    # +:default_header_service_url+ '/'
+    # +:default_footer_meta_text+ nil
+    # +:default_footer_copyright_text+ '© Crown copyright'
+    # +:default_footer_copyright_url+ "https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/"
+    # +:default_pagination_landmark_label+ "results"
+    # +:default_pagination_next_text+ Default 'next' text for pagination. An +Array+ where the first item is visible and the second visually hidden. Defaults to ["Next", "page"]
+    # +:default_pagination_previous_text+ Default 'previous' text for pagination. An +Array+ where the first item is visible and the second visually hidden. Defaults to ["Previous", "page"]
+    # +:default_phase_banner_tag+ nil
+    # +:default_phase_banner_text+ nil
+    # +:default_section_break_visible+ false
+    # +:default_section_break_size+ Size of the section break, possible values: +m+, +l+ and +xl+. Defaults to nil.
+    # +:default_tag_colour+ the default colour for tags, possible values: +grey+, +green+, +turquoise+, +blue+, +red+, +purple+, +pink+, +orange+, +yellow+. Defaults to +nil+
+    # +:default_start_button_as_button+ false
+    # +:default_summary_list_borders+ true
+    # +:default_notification_banner_title_id+ "govuk-notification-banner-title"
+    # +:default_notification_disable_auto_focus+ nil
+    # +:default_notification_title_heading_level+ 2
+    # +:default_notification_title_success+ false
+    # +:default_warning_text_icon_fallback_text+ "Warning"
+    # +:default_warning_text_icon+ "!"
+    #
+    # +:require_summary_list_action_visually_hidden_text+ when true forces visually hidden text to be set for every action. It can still be explicitly skipped by passing in +nil+. Defaults to +false+
+    DEFAULTS = {
+      default_back_link_text: 'Back',
+      default_breadcrumbs_collapse_on_mobile: false,
+      default_breadcrumbs_hide_in_print: false,
+      default_cookie_banner_aria_label: "Cookie banner",
+      default_cookie_banner_hide_in_print: true,
+      default_header_navigation_label: 'Navigation menu',
+      default_header_menu_button_label: 'Show or hide navigation menu',
+      default_header_logotype: 'GOV.UK',
+      default_header_homepage_url: '/',
+      default_header_service_name: nil,
+      default_header_service_url: '/',
+      default_footer_meta_text: nil,
+      default_footer_copyright_text: '© Crown copyright',
+      default_footer_copyright_url: "https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/",
+      default_pagination_landmark_label: "results",
+      default_pagination_next_text: %w(Next page),
+      default_pagination_previous_text: %w(Previous page),
+      default_phase_banner_tag: nil,
+      default_phase_banner_text: nil,
+      default_section_break_visible: false,
+      default_section_break_size: nil,
+      default_tag_colour: nil,
+      default_start_button_as_button: false,
+      default_summary_list_borders: true,
+      default_notification_banner_title_id: "govuk-notification-banner-title",
+      default_notification_disable_auto_focus: nil,
+      default_notification_title_heading_level: 2,
+      default_notification_title_success: false,
+      default_warning_text_icon_fallback_text: "Warning",
+      default_warning_text_icon: "!",
+
+      require_summary_list_action_visually_hidden_text: false,
+    }.freeze
+
+    DEFAULTS.each_key { |k| config_accessor(k) { DEFAULTS[k] } }
+
     class Engine < ::Rails::Engine
       isolate_namespace Govuk::Components
     end

data/lib/govuk/components/version.rb

@@ -1,5 +1,5 @@
 module Govuk
   module Components
-    VERSION = '3.1.4'.freeze
+    VERSION = '3.2.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk-components
 version: !ruby/object:Gem::Version
-  version: 3.1.4
+  version: 3.2.0
 platform: ruby
 authors:
 - DfE developers
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-07-11 00:00:00.000000000 Z
+date: 2022-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -92,14 +92,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.56.2
+        version: 2.69.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.56.2
+        version: 2.69.0
 - !ruby/object:Gem::Dependency
   name: deep_merge
   requirement: !ruby/object:Gem::Requirement
@@ -260,14 +260,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.29.0
+        version: 3.30.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.29.0
+        version: 3.30.0
 - !ruby/object:Gem::Dependency
   name: rubypants
   requirement: !ruby/object:Gem::Requirement
@@ -360,7 +360,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- MIT-LICENSE
 - README.md
 - Rakefile
 - app/components/govuk_component.rb

data/MIT-LICENSE

@@ -1,20 +0,0 @@
-Copyright 2020 Peter Yates
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.