govuk_publishing_components 48.0.0 → 49.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36a9c949e5b0818fd9a88c6e3d391589f2856b2354b061526323ee0da268663b
-  data.tar.gz: 9e50cfbc67ab2a7ad2be57cc08de07d962555de601f760a1737f99100fb20608
+  metadata.gz: a20a02d184c76606028650720f22cae103d3ccce1f42ca2dbc595915c03b55d8
+  data.tar.gz: d6187aefe322704e5e2e1d1ec58efe5c6b99d933e038085167f84211974b633f
 SHA512:
-  metadata.gz: d43bd8d3c8c0f58404798658c83e7b5349776b123dd1f3be9f9b380a8124ee510fce6d36ffbc634f33cdd0f4c5f7a4be2002a6c1225869e5289ab9f1c9c65183
-  data.tar.gz: a26a44f9bc7ba5b824d9f145662675935cf329f8cb98cfd076f217b18b1e2a557aff6df08b8bc03dc3c84f1d0b90330eb26c211569a3d99d3836bb765b4e5fe2
+  metadata.gz: 5f49a37d3583d584d57c42be30daad593649ce8f7c60a217d7cebbb8f4cbc95ee768bedd93c9ced0b7003d2530675970212da802dabe9ec5bc173657df035d21
+  data.tar.gz: d3ea15671ae94e6f723c89af1cbc9420c501fd890569df435762254decc3ba31b9b725d5532448edc6291e3fcd145fb95e9a5328dc4ec42a1a24800f98faac66

data/app/models/govuk_publishing_components/component_wrapper_helper_options.rb

@@ -13,8 +13,13 @@ This component uses the component wrapper helper. It accepts the following optio
 - `lang` - accepts a language attribute value
 - `open` - accepts an open attribute value (true or false)
 - `hidden` - accepts an empty string, 'hidden', or 'until-found'
-- `tabindex` - accepts an integer. The integer can also be passed as a string.
-- `dir` - accepts 'rtl', 'ltr', or 'auto'.
+- `tabindex` - accepts an integer. The integer can also be passed as a string
+- `dir` - accepts 'rtl', 'ltr', or 'auto'
+- `type` - accepts any valid type attribute e.g. 'button', 'submit', 'text'
+- `rel` - accepts any valid rel attribute e.g. 'nofollow'
+- `target` - accepts a valid target attribute e.g. '_blank'
+- `title` - accepts any string
+- `draggable` - accepts a draggable attribute value (\"true\" or \"false\")
       "
     end
   end

data/app/views/govuk_publishing_components/components/_attachment.html.erb

@@ -6,12 +6,13 @@
   hide_opendocument_metadata ||= false
   hide_order_copy_link ||= false
   attributes = []
-  data_attributes ||= {}
+  url_data_attributes ||= {}
   details_ga4_attributes ||= {}
   shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns)
 
-  container_class_names = %w[gem-c-attachment]
-  container_class_names << shared_helper.get_margin_bottom if local_assigns.key?(:margin_bottom)
+  component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
+  component_helper.add_class("gem-c-attachment")
+  component_helper.add_data_attribute({ module: "ga4-link-tracker" })
   ga4_link = { 'event_name': 'navigation', 'type': 'attachment' }
 
   case attachment.type
@@ -55,16 +56,16 @@
     )
   end
 
-  data_attributes[:ga4_link] = ga4_link
+  url_data_attributes[:ga4_link] = ga4_link
 %>
-<%= tag.section class: class_names(container_class_names), data: { module: "ga4-link-tracker" } do %>
+<%= tag.section(**component_helper.all_attributes) do %>
   <%= tag.div class: "gem-c-attachment__thumbnail govuk-!-display-none-print" do %>
     <%= link_to attachment.url,
                 class: "govuk-link",
                 target: target,
                 tabindex: "-1",
                 "aria-hidden": true,
-                data: data_attributes do %>
+                data: url_data_attributes do %>
       <% if attachment.thumbnail_url.present? %>
         <% image_tag(attachment.thumbnail_url, alt: "", class: "gem-c-attachment__thumbnail-image gem-c-attachment__thumbnail-image--custom") %>
       <% elsif attachment.html? %>
@@ -88,7 +89,7 @@
       <%= link_to attachment.title, attachment.url,
       class: "govuk-link gem-c-attachment__link",
       target: target,
-      data: data_attributes %>
+      data: url_data_attributes %>
     <% end %>
 
     <% if attachment.reference.present? %>

data/app/views/govuk_publishing_components/components/_attachment_link.html.erb

@@ -3,7 +3,7 @@
 
   attachment = GovukPublishingComponents::Presenters::AttachmentHelper.new(attachment)
   target ||= nil
-  data_attributes ||= {}
+  url_data_attributes ||= {}
   attributes = []
   if attachment.content_type_name
     content = if attachment.content_type_abbr
@@ -30,11 +30,14 @@
       class: "gem-c-attachment-link__attribute",
     )
   end
+
+  component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
+  component_helper.add_class("gem-c-attachment-link")
 %>
-<%= tag.span(class: "gem-c-attachment-link") do %>
+<%= tag.span(**component_helper.all_attributes) do %>
   <%= link_to(attachment.title, attachment.url,
               class: "govuk-link",
               target: target,
-              data: data_attributes) -%>
+              data: url_data_attributes) -%>
   <%= raw("(#{attributes.join(', ')})") if attributes.any? -%>
 <% end %>

data/app/views/govuk_publishing_components/components/_big_number.html.erb

@@ -1,22 +1,21 @@
 <%
   add_gem_component_stylesheet("big-number")
 
-  shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns)
   big_number_helper = GovukPublishingComponents::Presenters::BigNumberHelper.new(local_assigns)
 
   number ||= false
   label ||= nil
   href ||= nil
-  data_attributes ||= nil
-  aria ||= nil
-  classes = ["gem-c-big-number"]
-  classes << shared_helper.get_margin_bottom
+  nested_data_attributes ||= nil
 
   value_classes = big_number_helper.value_classes
+
+  component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
+  component_helper.add_class("gem-c-big-number")
 %>
 <% if number %>
   <% big_number_value = capture do %>
-    <%= tag.span class: value_classes, data: href ? nil : data_attributes do %>
+    <%= tag.span class: value_classes, data: href ? nil : nested_data_attributes do %>
       <%
         # The below check is to account for small symbols awkwardly sitting above the baseline in our typeface and adjust them to sit at the baseline for the purpose of visual harmony
         # Currently the only small symbol used with big numbers are pluses so they are specifically applied in the below code
@@ -37,9 +36,9 @@
     <% end %>
   <% end %>
 
-  <%= tag.div class: classes, aria: aria do %>
+  <%= tag.div(**component_helper.all_attributes) do %>
     <% unless href.nil? %>
-      <%= link_to big_number_value, href, class: "govuk-link gem-c-big-number__link", data: data_attributes %>
+      <%= link_to big_number_value, href, class: "govuk-link gem-c-big-number__link", data: nested_data_attributes %>
     <% else %>
       <%= big_number_value %>
     <% end %>

data/app/views/govuk_publishing_components/components/_contents_list.html.erb

@@ -30,7 +30,6 @@
   component_helper.add_class("gem-c-contents-list--custom-title") if title
   component_helper.add_data_attribute({ module: "ga4-link-tracker" }) unless disable_ga4
   component_helper.add_aria_attribute({ label: t("components.contents_list.contents") }) unless local_assigns[:aria][:label]
-  component_helper.add_role("navigation")
 
   title_fallback = t("components.contents_list.contents", locale: I18n.locale, fallback: false, default: "en")
 %>

data/app/views/govuk_publishing_components/components/_cross_service_header.html.erb

@@ -7,7 +7,7 @@
   service_navigation_aria_label ||= "Service menu"
 %>
 
-<header class="gem-c-cross-service-header" role="banner" data-module="cross-service-header">
+<header class="gem-c-cross-service-header" data-module="cross-service-header">
   <%= render "govuk_publishing_components/components/cross_service_header/one_login_header", {
     one_login_navigation_items: one_login_navigation_items,
   } %>

data/app/views/govuk_publishing_components/components/_layout_footer.html.erb

@@ -11,7 +11,6 @@
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
   component_helper.add_class("gem-c-layout-footer govuk-footer")
   component_helper.add_class("gem-c-layout-footer--border") if with_border
-  component_helper.add_role("contentinfo")
   component_helper.add_data_attribute({ module: "ga4-link-tracker" })
 %>
 <%= tag.footer(**component_helper.all_attributes) do %>

data/app/views/govuk_publishing_components/components/_layout_header.html.erb

@@ -15,7 +15,6 @@
   component_helper.add_class("gem-c-layout-header govuk-header")
   component_helper.add_class("gem-c-layout-header--#{environment}") if environment
   component_helper.add_class("gem-c-layout-header--no-bottom-border") if remove_bottom_border
-  component_helper.add_role("banner")
   component_helper.add_data_attribute({ module: "govuk-header" })
 
 %>

data/app/views/govuk_publishing_components/components/_layout_super_navigation_header.html.erb

@@ -65,7 +65,6 @@
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
   component_helper.add_class("gem-c-layout-super-navigation-header")
   component_helper.add_class("gem-c-layout-super-navigation-header--blue-background") if blue_background
-  component_helper.add_role("banner")
   component_helper.add_data_attribute({ module: "ga4-event-tracker ga4-link-tracker", ga4_expandable: "" })
 %>
 <%= tag.header(**component_helper.all_attributes) do %>

data/app/views/govuk_publishing_components/components/_modal_dialogue.html.erb

@@ -3,15 +3,19 @@
 
   id ||= "modal-dialogue-#{SecureRandom.hex(4)}"
   wide ||= false
-  data_attributes = {}
   aria_label ||= nil
   dialog_classes = ["gem-c-modal-dialogue__box"]
   dialog_classes << "gem-c-modal-dialogue__box--wide" if wide
+
+  component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
+  component_helper.add_class("gem-c-modal-dialogue")
+  component_helper.add_data_attribute({ module: "modal-dialogue" })
+  component_helper.set_id(id)
 %>
 
-<%= tag.div class: "gem-c-modal-dialogue", data: { module: "modal-dialogue" }, id: id do %>
+<%= tag.div(**component_helper.all_attributes) do %>
   <%= tag.div class: "gem-c-modal-dialogue__overlay" %>
-  <%= tag.dialog class: dialog_classes, data: data_attributes, aria: { modal: true, label: aria_label }, role: "dialog", tabindex: 0 do %>
+  <%= tag.dialog class: dialog_classes, aria: { modal: true, label: aria_label }, role: "dialog", tabindex: 0 do %>
     <%= tag.div class: "gem-c-modal-dialogue__header" do %>
       <%= render "govuk_publishing_components/components/govuk_logo/govuk_logo_crown_only", {
         classes: %w[gem-c-modal-dialogue__logotype-crown],

data/app/views/govuk_publishing_components/components/_previous_and_next_navigation.html.erb

@@ -4,7 +4,6 @@
 
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
   component_helper.add_class("govuk-pagination govuk-pagination--block")
-  component_helper.add_role("navigation")
   component_helper.add_aria_attribute({ label: t("components.previous_and_next_navigation.pagination") })
   component_helper.add_data_attribute({ module: "ga4-link-tracker" }) unless disable_ga4
 

data/app/views/govuk_publishing_components/components/_secondary_navigation.html.erb

@@ -8,7 +8,6 @@
   component_helper.add_aria_attribute({label: aria_label})
   component_helper.add_class('gem-c-secondary-navigation')
   component_helper.set_id(id)
-  component_helper.add_role("navigation")
 %>
 
 <% if items.any? %>

data/app/views/govuk_publishing_components/components/_translation_nav.html.erb

@@ -6,7 +6,6 @@
   translation_helper = GovukPublishingComponents::Presenters::TranslationNavHelper.new(local_assigns)
 
   component_helper = GovukPublishingComponents::Presenters::ComponentWrapperHelper.new(local_assigns)
-  component_helper.add_role("navigation")
   component_helper.add_class("gem-c-translation-nav govuk-!-display-none-print #{translation_helper.classes} #{brand_helper.brand_class}")
   component_helper.add_aria_attribute({ label: t("common.translations") })
 %>

data/app/views/govuk_publishing_components/components/docs/attachment.yml

@@ -17,6 +17,7 @@ shared_accessibility_criteria:
 accessibility_criteria: |
   The thumbnail image, and the link wrapping it, must not focusable or shown to
   screenreaders.
+uses_component_wrapper_helper: true
 examples:
   default:
     data:
@@ -89,7 +90,7 @@ examples:
       details_ga4_attributes: {
         index_section_count: 4
       }
-  with_data_attributes:
+  with_data_attributes_on_url:
     data:
       attachment:
         title: "Department for Transport information asset register"
@@ -97,7 +98,7 @@ examples:
         filename: department-for-transport-information-asset-register.csv
         content_type: application/pdf
         file_size: 20000
-      data_attributes:
+      url_data_attributes:
         gtm: "attachment-preview"
   with_margin_bottom:
     description: The component accepts a number for margin bottom from `0` to `9` (`0px` to `60px`) using the [GOV.UK Frontend spacing scale](https://design-system.service.gov.uk/styles/spacing/#the-responsive-spacing-scale). It defaults to no margin bottom.

data/app/views/govuk_publishing_components/components/docs/attachment_link.yml

@@ -14,6 +14,7 @@ accessibility_criteria: |
     Attachment links within paragraphs of text do not need to meet the 24 by 24 CSS pixels requirements.    
 shared_accessibility_criteria:
 - link
+uses_component_wrapper_helper: true
 examples:
   default:
     data:
@@ -58,10 +59,10 @@ examples:
         title: "Temporary snow ploughs: guidance note"
         url: https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/259634/temporary-snow-ploughs.pdf
       target: _blank
-  with_data_attributes:
+  with_data_attributes_on_url:
     data:
       attachment:
         title: "Temporary snow ploughs: guidance note"
         url: https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/259634/temporary-snow-ploughs.pdf
-      data_attributes:
+      url_data_attributes:
         gtm: "attachment-preview"

data/app/views/govuk_publishing_components/components/docs/big_number.yml

@@ -48,22 +48,26 @@ examples:
     data:
       number: 23
       href: "/government/organisations#ministerial_departments"
-  with_data_attributes:
+  with_nested_data_attributes:
     description: |
-      If a `href` attribute is present, `data_attributes` will apply to the `span` containing the number value (see below).
+      If a `href` attribute is present, `nested_data_attributes` will apply to the `a` containing the number value (see below). If a `href` is not present, it will apply to the `span` containing the number value.
+
+      For parent level data attributes, use `data_attributes` which comes from this component having the component wrapper.
 
       Note that the component does not include built in tracking. If this is required consider using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/trackers/ga4-link-tracker.md).
     data:
       number: 23
       label: Ministerial departments
       href: "/government/organisations#ministerial_departments"
-      data_attributes:
+      nested_data_attributes:
         department-count: true
-  with_data_attributes_but_no_link:
+  with_nested_data_attributes_but_no_link:
+    description: |
+      If a `href` is not present, the data attributes will be applied to the `span` containing the big number. For parent level data attributes, use `data_attributes` which comes from this component having the component wrapper.
     data:
       number: 23
       label: Ministerial departments
-      data_attributes:
+      nested_data_attributes:
         department-count: true
   with_aria_attributes:
     description: Aria attributes are applied to the whole component instance

data/app/views/govuk_publishing_components/components/docs/document_list.yml

@@ -246,8 +246,7 @@ examples:
           document_type: 'Statistical data set'
   with_equal_item_spacing:
     description: |
-      The new search UI has consistently equal spacing between items in the document list, instead
-      of the original larger bottom padding.
+      Use this option to add equal spacing between items in the document list.
     data:
       equal_item_spacing: true
       items:

data/app/views/govuk_publishing_components/components/docs/layout_footer.yml

@@ -20,17 +20,8 @@ accessibility_criteria: |
 
     Note: This decision has been made based on prior experience seeing removal of overuse of `<nav>` elements from www.GOV.UK, which made it confusing for users of assistive technologies to know what were the most important navigation aspects of GOV.UK.
     Should be challenged if user research indicates this is an issue.
-
-  - have a role of [`contentinfo`](https://www.w3.org/TR/wai-aria-1.1/#contentinfo) at the root of the component (`<footer>`)
-
-    Note: This decision has been made given that most uses of this role tend to be used directly on a `<footer>` element.
-    Assumption made is that is most predictable for users of assistive technologies.
-    The spec indicates that `contentinfo` is useful for "Examples of information included in this region of the page are copyrights and links to privacy statements.", which may indicate that it might be better placed around the 'meta' section of this component.
-    Should be challenged if user research indicates this is an issue.
 shared_accessibility_criteria:
   - link
-accessibility_excluded_rules:
-  - landmark-contentinfo-is-top-level # The footer element can not be top level in the examples
 examples:
   default:
     data: {}

data/app/views/govuk_publishing_components/components/docs/modal_dialogue.yml

@@ -24,6 +24,7 @@ accessibility_criteria: |
   - return focus to last focused element on close
 
 display_preview: false
+uses_component_wrapper_helper: true
 examples:
   default:
     embed: |
@@ -100,20 +101,3 @@ examples:
           <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed imperdiet fringilla dictum. Morbi at vehicula augue. Pellentesque varius orci et augue pellentesque, sed elementum massa posuere. Curabitur egestas consectetur arcu, in porta lorem sagittis eu. Nulla facilisi. Sed scelerisque ligula lectus. Nulla et ligula a eros laoreet lacinia nec et ipsum. Ut sagittis sapien est, ut blandit risus laoreet at. Vestibulum vitae erat sed dolor ultricies efficitur.</p>
           <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed imperdiet fringilla dictum. Morbi at vehicula augue. Pellentesque varius orci et augue pellentesque, sed elementum massa posuere. Curabitur egestas consectetur arcu, in porta lorem sagittis eu. Nulla facilisi. Sed scelerisque ligula lectus. Nulla et ligula a eros laoreet lacinia nec et ipsum. Ut sagittis sapien est, ut blandit risus laoreet at. Vestibulum vitae erat sed dolor ultricies efficitur.</p>
           <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed imperdiet fringilla dictum. Morbi at vehicula augue. Pellentesque varius orci et augue pellentesque, sed elementum massa posuere. Curabitur egestas consectetur arcu, in porta lorem sagittis eu. Nulla facilisi. Sed scelerisque ligula lectus. Nulla et ligula a eros laoreet lacinia nec et ipsum. Ut sagittis sapien est, ut blandit risus laoreet at. Vestibulum vitae erat sed dolor ultricies efficitur.</p>
-  with_data_attributes:
-    embed: |
-      <%= render "govuk_publishing_components/components/button", {
-        text: "Open modal with data attributes",
-        data_attributes: {
-          toggle: "modal",
-          target: "modal-with-data-attributes"
-        }
-      } %>
-      <%= component %>
-    data:
-      id: modal-with-data-attributes
-      data_attributes:
-        gtm: modal
-      block: |
-        <h1 class="govuk-heading-l">Modal title</h1>
-        <p class="govuk-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed imperdiet fringilla dictum. Morbi at vehicula augue. Pellentesque varius orci et augue pellentesque, sed elementum massa posuere. Curabitur egestas consectetur arcu, in porta lorem sagittis eu. Nulla facilisi. Sed scelerisque ligula lectus. Nulla et ligula a eros laoreet lacinia nec et ipsum. Ut sagittis sapien est, ut blandit risus laoreet at. Vestibulum vitae erat sed dolor ultricies efficitur.</p>

data/app/views/govuk_publishing_components/components/layout_for_public/_account-layout.html.erb

@@ -12,7 +12,7 @@
     <div class="govuk-grid-column-two-thirds">
       <div id="wrapper">
         <%= yield :before_content %>
-        <main role="main" id="content">
+        <main id="content">
           <%= yield %>
         </main>
       </div>

data/app/views/govuk_publishing_components/components/related_navigation/_section.html.erb

@@ -1,5 +1,4 @@
-<nav role="navigation"
-     class="gem-c-related-navigation__nav-section"
+<nav class="gem-c-related-navigation__nav-section"
      aria-labelledby="related-nav-<%= section_title %>-<%= random %>"
      data-module="gem-toggle">
 

data/lib/govuk_publishing_components/presenters/component_wrapper_helper.rb

@@ -15,6 +15,9 @@ module GovukPublishingComponents
         check_tabindex_is_valid(@options[:tabindex]) if @options.include?(:tabindex)
         check_dir_is_valid(@options[:dir]) if @options.include?(:dir)
         check_type_is_valid(@options[:type]) if @options.include?(:type)
+        check_draggable_is_valid(@options[:draggable]) if @options.include?(:draggable)
+        check_rel_is_valid(@options[:rel]) if @options.include?(:rel)
+        check_target_is_valid(@options[:target]) if @options.include?(:target)
         check_margin_bottom_is_valid(@options[:margin_bottom]) if @options.include?(:margin_bottom)
       end
 
@@ -35,6 +38,10 @@ module GovukPublishingComponents
         attributes[:tabindex] = @options[:tabindex] unless @options[:tabindex].blank?
         attributes[:dir] = @options[:dir] unless @options[:dir].blank?
         attributes[:type] = @options[:type] unless @options[:type].blank?
+        attributes[:draggable] = @options[:draggable] unless @options[:draggable].blank?
+        attributes[:rel] = @options[:rel] unless @options[:rel].blank?
+        attributes[:target] = @options[:target] unless @options[:target].blank?
+        attributes[:title] = @options[:title] unless @options[:title].blank?
 
         attributes
       end
@@ -94,6 +101,30 @@ module GovukPublishingComponents
         @options[:type] = type_attribute
       end
 
+      def set_draggable(draggable_attribute)
+        check_draggable_is_valid(draggable_attribute)
+        @options[:draggable] = draggable_attribute
+      end
+
+      def add_rel(rel_attribute)
+        check_rel_is_valid(rel_attribute)
+        extend_string(:rel, rel_attribute)
+      end
+
+      def set_rel(rel_attribute)
+        check_rel_is_valid(rel_attribute)
+        @options[:rel] = rel_attribute
+      end
+
+      def set_target(target_attribute)
+        check_target_is_valid(target_attribute)
+        @options[:target] = target_attribute
+      end
+
+      def set_title(title_attribute)
+        @options[:title] = title_attribute
+      end
+
       def set_margin_bottom(margin_bottom)
         check_margin_bottom_is_valid(margin_bottom)
         @options[:margin_bottom] = margin_bottom
@@ -191,7 +222,7 @@ module GovukPublishingComponents
       end
 
       def check_dir_is_valid(dir_attribute)
-        return if dir_attribute.nil?
+        return if dir_attribute.blank?
 
         options = %w[ltr rtl auto]
         unless options.include? dir_attribute
@@ -200,7 +231,7 @@ module GovukPublishingComponents
       end
 
       def check_type_is_valid(type_attribute)
-        return if type_attribute.nil?
+        return if type_attribute.blank?
 
         options = %w[button checkbox color date datetime-local email file hidden image month number password radio range reset search submit tel text time url week]
         unless options.include? type_attribute
@@ -208,6 +239,34 @@ module GovukPublishingComponents
         end
       end
 
+      def check_draggable_is_valid(draggable_attribute)
+        return if draggable_attribute.blank?
+
+        options = %w[true false]
+        unless options.include? draggable_attribute
+          raise(ArgumentError, "draggable attribute (#{draggable_attribute}) is not recognised")
+        end
+      end
+
+      def check_rel_is_valid(rel_attribute)
+        return if rel_attribute.blank?
+
+        options = %w[alternate author bookmark canonical dns-prefetch external expect help icon license manifest me modulepreload next nofollow noopener noreferrer opener pingback preconnect prefetch preload prerender prev privacy-policy search stylesheet tag terms-of-service]
+        rel_array = rel_attribute.split(" ")
+        unless rel_array.all? { |r| options.include? r }
+          raise(ArgumentError, "rel attribute (#{rel_attribute}) is not recognised")
+        end
+      end
+
+      def check_target_is_valid(target_attribute)
+        return if target_attribute.blank?
+
+        options = %w[_self _blank _parent _top _unfencedTop]
+        unless options.include? target_attribute
+          raise(ArgumentError, "target attribute (#{target_attribute}) is not recognised")
+        end
+      end
+
       def extend_string(option, string)
         ((@options[option] ||= "") << " #{string}").strip!
       end

data/lib/govuk_publishing_components/version.rb

@@ -1,3 +1,3 @@
 module GovukPublishingComponents
-  VERSION = "48.0.0".freeze
+  VERSION = "49.0.0".freeze
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: govuk_publishing_components
 version: !ruby/object:Gem::Version
-  version: 48.0.0
+  version: 49.0.0
 platform: ruby
 authors:
 - GOV.UK Dev
 bindir: bin
 cert_chain: []
-date: 2025-01-13 00:00:00.000000000 Z
+date: 2025-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: govuk_app_config