govuk_publishing_components 29.9.0 → 29.12.0

data/app/models/govuk_publishing_components/audit_comparer.rb

@@ -2,26 +2,58 @@ module GovukPublishingComponents
   class AuditComparer
     attr_reader :applications_data, :gem_data
 
-    def initialize(gem_data, results, simple)
+    def initialize(gem_data, results)
       if gem_data[:gem_found]
+        @applications_using_static = %w[
+          collections
+          email-alert-frontend
+          feedback
+          finder-frontend
+          frontend
+          government-frontend
+          info-frontend
+          licence-finder
+          service-manual-frontend
+          smart-answers
+          whitehall
+        ]
+
+        @static_data = find_static(results)
         @gem_data = gem_data
-        @applications_data = sort_results(results, simple)
+        @applications_data = sort_results(results)
         @gem_data[:components_by_application] = get_components_by_application || []
       end
     end
 
   private
 
+    # find static to check for global includes, reduce false warnings
+    def find_static(results)
+      results.each do |result|
+        if result[:name] == "static" && result[:application_found] == true
+          return clean_static(result)
+        end
+      end
+
+      false
+    end
+
+    # turn static data into an object so locations can be easily referenced
+    # should give object of form { "templates" => [], "stylesheets" => [] }
+    def clean_static(data)
+      Hash[data[:components_found].map { |d| [d[:location], d[:components]] }]
+    end
+
     def prettify_key(key)
       key.to_s.gsub("_", " ").capitalize
     end
 
-    def sort_results(results, simple)
-      @simple = simple
+    def sort_results(results)
       data = []
 
       results.each do |result|
         if result[:application_found]
+          application_uses_static = @applications_using_static.include?(result[:name])
           templates = result[:components_found].find { |c| c[:location] == "templates" }
           stylesheets = result[:components_found].find { |c| c[:location] == "stylesheets" }
           print_stylesheets = result[:components_found].find { |c| c[:location] == "print_stylesheets" }
@@ -39,37 +71,36 @@ module GovukPublishingComponents
           warnings << warn_about_missing_assets(result[:components_found])
           warnings << warn_about_style_overrides(result[:gem_style_references])
           warnings << warn_about_jquery_references(result[:jquery_references])
+          warnings << check_for_assets_already_in_static(result[:components_found]) if @static_data && application_uses_static
           warnings = warnings.flatten
 
-          summary = []
-          unless @simple
-            summary = [
-              {
-                name: "Components in templates",
-                value: templates[:components].flatten.uniq.sort.join(", "),
-              },
-              {
-                name: "Components in stylesheets",
-                value: stylesheets[:components].join(", "),
-              },
-              {
-                name: "Components in print stylesheets",
-                value: print_stylesheets[:components].join(", "),
-              },
-              {
-                name: "Components in javascripts",
-                value: javascripts[:components].join(", "),
-              },
-              {
-                name: "Components in ruby",
-                value: ruby[:components].join(", "),
-              },
-            ]
-          end
+          summary = [
+            {
+              name: "Components in templates",
+              value: templates[:components].flatten.uniq.sort.join(", "),
+            },
+            {
+              name: "Components in stylesheets",
+              value: stylesheets[:components].join(", "),
+            },
+            {
+              name: "Components in print stylesheets",
+              value: print_stylesheets[:components].join(", "),
+            },
+            {
+              name: "Components in javascripts",
+              value: javascripts[:components].join(", "),
+            },
+            {
+              name: "Components in ruby",
+              value: ruby[:components].join(", "),
+            },
+          ]
 
           data << {
             name: result[:name],
             application_found: result[:application_found],
+            uses_static: application_uses_static,
             summary: summary,
             warnings: warnings,
             warning_count: warnings.length,
@@ -102,6 +133,7 @@ module GovukPublishingComponents
       }
     end
 
+    # given two groups of components, check the difference
     def find_missing_items(first_group, second_group)
       warnings = []
 
@@ -111,14 +143,20 @@ module GovukPublishingComponents
         second_group.each do |second|
           second_location = second[:location]
           second_location = "code" if %w[templates ruby].include?(second_location)
+          # subtract one group from the other, leaving only those not in both
           in_current = find_missing(second[:components].clone, first[:components].clone)
 
           next if second[:components].include?("all")
 
+          # now we have a list of 'missing' component assets, check the gem to see if that asset exists
           in_current.each do |component|
-            if @gem_data.include?("component_#{second_location}".to_sym) && @gem_data["component_#{second_location}".to_sym].include?(component)
-              warnings << create_warning(component, "Included in #{first_location} but not #{second_location}")
-            end
+            asset_in_gem = @gem_data.include?("component_#{second_location}".to_sym) && @gem_data["component_#{second_location}".to_sym].include?(component)
+            check_static = @static_data && second_location != "code"
+            asset_in_static = asset_already_in_static(second_location, component) if check_static
+            raise_warning = asset_in_gem && !asset_in_static
+
+            # this raises a warning if the asset exists and isn't included either in the application or static
+            warnings << create_warning(component, "Included in #{first_location} but not #{second_location}") if raise_warning
           end
         end
       end
@@ -126,6 +164,27 @@ module GovukPublishingComponents
       warnings
     end
 
+    def asset_already_in_static(location, component)
+      return true if @static_data[location].include?(component)
+
+      false
+    end
+
+    def check_for_assets_already_in_static(locations)
+      warnings = []
+
+      locations.each do |location|
+        next if location[:location] == "templates" || location[:location] == "ruby"
+
+        location[:components].each do |component|
+          raise_warning = asset_already_in_static(location[:location], component)
+          warnings << create_warning(component, "Included in #{location[:location]} but already included in static") if raise_warning
+        end
+      end
+
+      warnings
+    end
+
     def warn_about_missing_assets(components)
       warnings = []
 
@@ -186,8 +245,6 @@ module GovukPublishingComponents
     end
 
     def get_components_by_application
-      return [] if @simple
-
       results = []
       found_something = false
 

data/app/views/govuk_publishing_components/audit/_applications.html.erb

@@ -22,22 +22,33 @@
   %>
   <% application_items = @applications.map do |application| %>
     <%
-      summary = '<strong class="govuk-tag govuk-tag--red">Application not found</strong>'
+      if @other_applications
+        summary = '<strong class="govuk-tag govuk-tag--red">Application not found</strong>'
 
-      if application[:application_found]
-        summary = "Warnings: 0"
-        summary = "Warnings: <strong class=\"govuk-tag govuk-tag--red\">#{application[:warning_count]}</strong>" if application[:warning_count] > 0
+        if application[:application_found]
+          summary = "Warnings: 0"
+          summary = "Warnings: <strong class=\"govuk-tag govuk-tag--red\">#{application[:warning_count]}</strong>" if application[:warning_count] > 0
+        end
       end
     %>
 
     <% accordion_content = capture do %>
       <% if application[:application_found] %>
         <% github_link = 'https://github.com/alphagov/' + application[:name] + '/blob/main/' %>
-        <% application[:warnings].each do |warning| %>
-          <p class="govuk-body">
-            <strong class="govuk-tag">Warn</strong>
-            <strong><%= warning[:component] %></strong> - <%= warning[:message] %>
-          </p>
+
+        <% if @other_applications %>
+          <% if application[:uses_static] %>
+            <p class="govuk-body">This application uses <a href="https://github.com/alphagov/static" class="govuk-link">static</a>, which can contain assets for components used in more than one application. Warnings for missing component assets in this application that are already included in static have been suppressed.</p>
+          <% end %>
+
+          <% application[:warnings].each do |warning| %>
+            <p class="govuk-body">
+              <strong class="govuk-tag">Warn</strong>
+              <strong><%= warning[:component] %></strong> - <%= warning[:message] %>
+            </p>
+          <% end %>
+        <% else %>
+          <p class="govuk-body">More information about this application is available by viewing the component guide from a locally running instance of govuk_publishing_components.</p>
         <% end %>
 
         <%= render "govuk_publishing_components/components/heading", {

data/app/views/govuk_publishing_components/component_guide/index.html.erb

@@ -1,29 +1,11 @@
 <%= render 'govuk_publishing_components/components/title', title: GovukPublishingComponents::Config.component_guide_title, margin_top: 0 %>
 
-<% unless ENV["MAIN_COMPONENT_GUIDE"] %>
-  <p class="govuk-body">
-    <% if @index_audit_summary[:application_found] %>
-      Warnings:
-      <% if @index_audit_summary[:warning_count] > 0 %>
-        <strong class="govuk-tag govuk-tag--red"><%= @index_audit_summary[:warning_count] %></strong>
-      <% else %>
-        <%= @index_audit_summary[:warning_count] %>
-      <% end %>
-      <a href="/component-guide/audit" class="govuk-link">Warning details</a>
-    <% else %>
-      <strong class="govuk-tag govuk-tag--red">Application not found</strong>
-    <% end %>
-  </p>
-<% end %>
-
 <div class="component-markdown">
   <p>Components are packages of template, style, behaviour and documentation that live in your application.</p>
   <p>See the <a href="https://github.com/alphagov/govuk_publishing_components">govuk_publishing_components gem</a> for further details, or <a href="https://docs.publishing.service.gov.uk/manual/components.html#component-guides">a list of all component guides</a>.</p>
   <ul>
     <li>Read about how to <a href="https://github.com/alphagov/govuk_publishing_components/blob/main/docs/publishing-to-rubygems.md">release a new version of the gem</a></li>
-    <% if ENV["MAIN_COMPONENT_GUIDE"] %>
-      <li><a href="/component-guide/audit">View component audits</a></li>
-    <% end %>
+    <li><a href="/component-guide/audit">View component audits</a></li>
   </ul>
 </div>
 

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

@@ -27,6 +27,9 @@
   data_attributes[:track_show_all_clicks] = track_show_all_clicks
   data_attributes[:track_sections] = track_sections
 
+  data_attributes_show_all ||= nil
+  data_attributes[:show_all_attributes] = data_attributes_show_all if data_attributes_show_all
+
   translations.each do |key, translation|
     locales[key] = shared_helper.t_locale(translation)
     data_attributes[key] = t(translation)
@@ -47,8 +50,8 @@
   <%= tag.div(class: accordion_classes, id: id, data: data_attributes) do %>
     <% items.each_with_index do |item, i| %>
       <%
-        # The GOVUK Frontend JavaScript for this component 
-        # uses a loop starting at 1 for accessing heading ID values, 
+        # The GOVUK Frontend JavaScript for this component
+        # uses a loop starting at 1 for accessing heading ID values,
         # hence the increment below
         index = i + 1
 
@@ -65,11 +68,10 @@
             content_tag(
               shared_helper.get_heading_level,
               content_tag(
-                'span', 
-                item[:heading][:text], 
+                'span',
+                item[:heading][:text],
                 class: "govuk-accordion__section-button",
                 id: "#{id}-heading-#{index}"
-                
               ),
               class: "govuk-accordion__section-heading",
               id: item[:heading][:id],

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

@@ -83,9 +83,7 @@
       <% end %>
     <% end %>
 
-    <% if attachment.display_accessible_format_request_form_link? %>
-      <%= link_to "Request an accessible format of this document", "/contact/govuk/request-accessible-format?content_id=#{attachment.owning_document_content_id}&attachment_id=#{attachment.attachment_id}", class: "govuk-link" %>
-    <% elsif attachment.alternative_format_contact_email %>
+    <% if attachment.alternative_format_contact_email %>
       <%= tag.p t("components.attachment.request_format_text"), class: "gem-c-attachment__metadata" %>
       <%= render "govuk_publishing_components/components/details", {
         title: t("components.attachment.request_format_cta")

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

@@ -17,7 +17,7 @@
 
     <%= render "govuk_publishing_components/components/textarea", { id: id, character_count: true }.merge(textarea.symbolize_keys) %>
 
-    <div id="<%= id %>-info" class="govuk-hint govuk-character-count__message" aria-live="polite">
+    <div id="<%= id %>-info" class="govuk-hint govuk-character-count__message">
       <%= t("components.character_count.body", number: maxlength || maxwords, type: maxwords ? t("components.character_count.type.words") : t("components.character_count.type.characters")) %>
     </div>
   <% end %>

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

@@ -29,7 +29,6 @@
     aria_described_by << describedby if describedby
     aria_described_by = aria_described_by.join(" ")
   end
-
 %>
 
 <%= content_tag :div, class: form_group_css_classes do %>

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

@@ -1,7 +1,10 @@
-<% description ||= nil %>
-<% data_attributes ||= {} %>
+<%
+  id ||= nil
+  description ||= nil
+  data_attributes ||= {}
+%>
 
-<%= tag.div class: "gem-c-error-alert", data: { module: "initial-focus" }.merge(data_attributes), role: "alert", tabindex: "-1" do %>
+<%= tag.div id: id, class: "gem-c-error-alert", data: { module: "initial-focus" }.merge(data_attributes), role: "alert", tabindex: "-1" do %>
   <% if description.present? %>
     <%= tag.h2 message, class: "gem-c-error-summary__title" %>
     <%= tag.div description, class: "gem-c-error-summary__body" %>

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

@@ -62,9 +62,7 @@
   if type == "number"
     type = "text"
     inputmode = "numeric"
-    pattern = "[0-9]*"
   end
-
 %>
 
 <%= content_tag :div, class: form_group_css_classes do %>

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

@@ -6,9 +6,9 @@
   classes << "gem-c-layout-footer--border" if with_border
 %>
 <%= tag.footer class: classes, role: "contentinfo" do %>
-  <div class="govuk-width-container" data-module="gem-track-click">
+  <div class="govuk-width-container">
     <% if navigation.any? %>
-      <div class="govuk-footer__navigation">
+      <div class="govuk-footer__navigation" data-module="gem-track-click" data-track-links-only>
         <% navigation.each do |item| %>
           <% if item[:items] %>
             <%
@@ -60,7 +60,7 @@
       <div class="govuk-footer__meta-item govuk-footer__meta-item--grow">
         <% if meta.any? %>
           <h2 class="govuk-visually-hidden"><%= t("components.layout_footer.support_links") %></h2>
-          <ul class="govuk-footer__inline-list govuk-!-display-none-print">
+          <ul class="govuk-footer__inline-list govuk-!-display-none-print" data-module="gem-track-click" data-track-links-only>
             <% meta[:items].each do |item| %>
               <li class="govuk-footer__inline-list-item">
                 <%
@@ -78,11 +78,29 @@
             d="M421.5 142.8V.1l-50.7 32.3v161.1h112.4v-50.7zm-122.3-9.6A47.12 47.12 0 0 1 221 97.8c0-26 21.1-47.1 47.1-47.1 16.7 0 31.4 8.7 39.7 21.8l42.7-27.2A97.63 97.63 0 0 0 268.1 0c-36.5 0-68.3 20.1-85.1 49.7A98 98 0 0 0 97.8 0C43.9 0 0 43.9 0 97.8s43.9 97.8 97.8 97.8c36.5 0 68.3-20.1 85.1-49.7a97.76 97.76 0 0 0 149.6 25.4l19.4 22.2h3v-87.8h-80l24.3 27.5zM97.8 145c-26 0-47.1-21.1-47.1-47.1s21.1-47.1 47.1-47.1 47.2 21 47.2 47S123.8 145 97.8 145"
           />
         </svg>
-        <span class="govuk-footer__licence-description">
+        <% # this is to avoid having hardcoded data attributes in locale files %>
+        <span
+          class="govuk-footer__licence-description"
+          data-module="gem-track-click"
+          data-track-action="copyrightLink"
+          data-track-category="footerClicked"
+          data-track-label="https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"
+          data-track-options='{"dimension29": "Open Government Licence v3.0"}'
+          data-track-links-only
+        >
           <%= t("components.layout_footer.licence_html") %>
         </span>
       </div>
-      <div class="govuk-footer__meta-item">
+      <% # this is to avoid having hardcoded data attributes in locale files %>
+      <div
+        class="govuk-footer__meta-item"
+        data-module="gem-track-click"
+        data-track-action="copyrightLink"
+        data-track-category="footerClicked"
+        data-track-label="https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/"
+        data-track-options='{"dimension29": "© Crown copyright"}'
+        data-track-links-only
+      >
         <%= t("components.layout_footer.copyright_html") %>
       </div>
     </div>

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

@@ -15,12 +15,11 @@
   hide_navigation_menu_text = t("components.layout_super_navigation_header.menu_toggle_label.hide", :label => "navigation")
   show_navigation_menu_text = t("components.layout_super_navigation_header.menu_toggle_label.show", :label => "navigation")
 %>
-<header role="banner" class="gem-c-layout-super-navigation-header">
+<header role="banner" class="gem-c-layout-super-navigation-header" data-module="gem-track-click" data-track-links-only>
   <div class="gem-c-layout-super-navigation-header__container govuk-width-container govuk-clearfix">
     <div class="gem-c-layout-super-navigation-header__header-logo">
       <a
         class="govuk-header__link govuk-header__link--homepage"
-        data-module="gem-track-click"
         data-track-action="logoLink"
         data-track-category="headerClicked"
         data-track-label="<%= logo_link %>"
@@ -100,7 +99,6 @@
               <%= link_to link[:label], link[:href], {
                 class: "gem-c-layout-super-navigation-header__navigation-item-link",
                 data: {
-                  module: "gem-track-click",
                   track_action: "#{tracking_label}Link",
                   track_category: "headerClicked",
                   track_label: link[:href],
@@ -141,9 +139,9 @@
                   <div class="govuk-grid-row">
                     <div class="govuk-grid-column-one-third-from-desktop">
                       <% if link[:description].present? %>
-                        <p class="govuk-body-l gem-c-layout-super-navigation-header__menu-description">
+                        <h3 class="govuk-body-l gem-c-layout-super-navigation-header__menu-description">
                           <%= link[:description] %>
-                        </p>
+                        </h3>
                       <% end %>
                     </div>
                     <div class="govuk-grid-column-two-thirds-from-desktop">
@@ -159,7 +157,6 @@
                                 <%= link_to item[:label], item[:href], {
                                   class: link_classes,
                                   data: {
-                                    module: "gem-track-click",
                                     track_action: "#{tracking_label}Link",
                                     track_category: "headerClicked",
                                     track_label: item[:href],
@@ -183,7 +180,6 @@
                                   "gem-c-layout-super-navigation-header__navigation-second-footer-link",
                                 ],
                                 data: {
-                                  module: "gem-track-click",
                                   track_action: "#{tracking_label}Link",
                                   track_category: "headerClicked",
                                   track_label: item[:href],
@@ -312,7 +308,6 @@
                         "gem-c-layout-super-navigation-header__popular-link",
                       ],
                       data: {
-                        module: "gem-track-click",
                         track_action: "popularLink",
                         track_category: "headerClicked",
                         track_label: popular_link[:href],

data/app/views/govuk_publishing_components/components/contextual_sidebar/_ukraine_cta.html.erb

@@ -1,27 +1,26 @@
 <% shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns) %>
 <%
   title = t("components.related_navigation.ukraine.title")
-  link_text = t("components.related_navigation.ukraine.link_text")
-  link_path = t("components.related_navigation.ukraine.link_path")
   lang = shared_helper.t_locale("components.related_navigation.ukraine.title")
 %>
 
-<% data_attributes = {
-  "module": "gem-track-click",
-  "track-category": "relatedLinkClicked",
-  "track-action": "1.0 Invasion of Ukraine",
-  "track-label": link_path,
-  "track-dimension": link_text,
-  "track-dimension-index": "29",
-} %>
-
-<%= tag.div class: "gem-c-contextual-sidebar__cta" do %>
+<%= tag.div class: "gem-c-contextual-sidebar__cta gem-c-contextual-sidebar__cta--ukraine", data: { module: "gem-track-click" } do %>
   <%= tag.h2 title, class: "gem-c-contextual-sidebar__heading govuk-heading-s" %>
-  <%= tag.p class: "gem-c-contextual-sidebar__text govuk-body" do %>
-    <%= link_to link_text,
-      link_path,
-      class: "govuk-link",
-      data: data_attributes,
-      lang: lang %>
-  <% end %>
+  <%= tag.ul class: "gem-c-contextual-sidebar__list" do %>
+    <% t("components.related_navigation.ukraine.links").each do |link| %>
+      <%= tag.li class: "gem-c-contextual-sidebar__text govuk-body" do %>
+        <%= link_to link[:label],
+          link[:href],
+          class: "govuk-link",
+          data: {
+            "track-category": "relatedLinkClicked",
+            "track-action": "1.0 Invasion of Ukraine",
+            "track-label": link[:href],
+            "track-dimension": link[:label],
+            "track-dimension-index": "29",
+          },
+          lang: lang %>
+      <% end %>
+    <% end %>
+  <% end %>    
 <% end %>

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

@@ -189,10 +189,14 @@ examples:
 
       Each item can also have a `data_attributes` hash. These `data_attributes` are placed on the `button` that triggers the opening and closing - useful for differentiating between each section of the accordion.
 
+      Data attributes can also be added to the 'Show/hide all' link using the `data_attributes_show_all` option, primarily where custom tracking is required. These attributes are read from the accordion markup and then added to the link by JavaScript (which is how the link is created).
     data:
       data_attributes:
           gtm: gtm-accordion
           ga: ga-accordion
+      data_attributes_show_all:
+        gtm-event-name: example
+        gtm-attributes: "{ 'ui': { 'type': 'type value', 'section': 'section value' } }"
       items:
         - heading:
             text: Writing well for the web
@@ -277,13 +281,13 @@ examples:
             html: <p class="govuk-body">This is the content for How people read.</p>
   with_the_anchor_link_navigation:
     description: |
-      Some apps require custom `id`s per accordion section heading. Custom `id`s allow you to link section headings, sometimes across multiple pages. 
-      
+      Some apps require custom `id`s per accordion section heading. Custom `id`s allow you to link section headings, sometimes across multiple pages.
+
       For example on [guidance pages for Content Designers, referred to as "manuals",](https://www.gov.uk/guidance/how-to-publish-on-gov-uk/creating-and-updating-pages#associations) each manual includes multiple sets of accordions and will reference between specific sections to easily access content.
 
-      Using the same rules, custom `id`s automatically open accordions when users click within another accordion that links to either 
+      Using the same rules, custom `id`s automatically open accordions when users click within another accordion that links to either
 
-      * the `id` of an accordion section heading 
+      * the `id` of an accordion section heading
       * an `id` within the content of an accordion (this will also automatically navigate to and open accordions on page load)
 
       This feature will only be used if the `anchor_navigation` flag is passed as `true`. This mitigates performance risk from event listeners on a large number of links.
@@ -294,13 +298,13 @@ examples:
       items:
         - heading:
             text: Writing well for the web
-            id: writing-well-for-the-web
+            id: writing-well-for-the-web-1
           content:
-            html: <p class="govuk-body">This is content for accordion 1 of 2</p><p class="govuk-body">This content contains a <a href="#anchor-nav-test" class="govuk-link">link</a></p>
+            html: <p class="govuk-body">This is content for accordion 1 of 2</p><p class="govuk-body">This content contains a <a href="#anchor-nav-test-1" class="govuk-link">link</a></p>
         - heading:
             text: Writing well for specialists
           content:
-            html: <p class="govuk-body" id="anchor-nav-test">This is content for accordion 2 of 2</p>
+            html: <p class="govuk-body" id="anchor-nav-test-1">This is content for accordion 2 of 2</p>
         - heading:
             text: Know your audience
           content:
@@ -312,33 +316,38 @@ examples:
   with_track_show_all_clicks:
     description: |
       To switch on Google Analytics for the "Show all sections" button on click, pass `track_show_all_clicks: true` the values passed on open will be
-      `Event Action: accordionOpened` `Event Category: pageElementInteraction` `Event Label: Show all sections` 
+      `Event Action: accordionOpened` `Event Category: pageElementInteraction` `Event Label: Show all sections`
     data:
       track_show_all_clicks: true
       items:
         - heading:
             text: Writing well for the web
-            id: writing-well-for-the-web
+            id: writing-well-for-the-web-2
           content:
-            html: <p class="govuk-body">This is content for accordion 1 of 2</p><p class="govuk-body">This content contains a <a href="#anchor-nav-test" class="govuk-link">link</a></p>
+            html: <p class="govuk-body">This is content for accordion 1 of 2</p>
         - heading:
             text: Writing well for specialists
           content:
-            html: <p class="govuk-body" id="anchor-nav-test">This is content for accordion 2 of 2</p>
+            html: <p class="govuk-body">This is content for accordion 2 of 2</p>
   with_track_sections:
     description: |
       To switch on Google Analytics for each section, on click, pass `track_sections: true` the values passed on open will be
       `Event Action: accordionOpened` / `accordionClosed` `Event Category: pageElementInteraction` and the `Event Label` being the heading text.
-      
+
+      If `track_options` in an item is set, then it is possible to pass a custom dimension when the section is clicked.
+
       (`track_show_all_clicks: true` can be added to track the "Show all sections" button as well, if required)
     data:
       track_sections: true
       items:
         - heading:
             text: Writing well for the web
-            id: writing-well-for-the-web
+            id: writing-well-for-the-web-3
           content:
             html: <p class="govuk-body">This is content for accordion 1 of 2</p><p class="govuk-body">This content contains a <a href="#anchor-nav-test" class="govuk-link">link</a></p>
+          data_attributes:
+            track_options:
+              dimension114: 1
         - heading:
             text: Writing well for specialists
           content:

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

@@ -76,17 +76,6 @@ examples:
         content_type: application/pdf
         file_size: 20000
         alternative_format_contact_email: defra.helpline@defra.gsi.gov.uk
-  with_link_to_request_accessible_format_form:
-    data:
-      attachment:
-        title: "Department for Transport information asset register"
-        url: https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/747661/department-for-transport-information-asset-register.csv
-        filename: department-for-transport-information-asset-register.csv
-        content_type: application/pdf
-        file_size: 20000
-        owning_document_content_id: 456_abc
-        attachment_id: 123
-        alternative_format_contact_email: govuk_publishing_components@example.com
   with_data_attributes:
     data:
       attachment:

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

@@ -27,3 +27,7 @@ examples:
       description: A further description
       data_attributes:
         tracking: GTM-123AB
+  with_specified_id_attribute:
+    data:
+      id: test-id
+      message: Message to alert the user to a unsuccessful action goes here