govuk_publishing_components 35.21.4 → 35.23.0

data/app/views/govuk_publishing_components/components/cross_service_header/_service_header.html.erb

@@ -0,0 +1,49 @@
+<% service_navigation_aria_label ||= "Service menu" %>
+
+<% if product_name %>
+<div class="gem-c-service-header" data-one-login-header-nav>
+  <div class="govuk-width-container">
+    <div class="gem-c-service-header__container">
+      <!-- The name of your service goes here -->
+      <h2 class="gem-c-service-header__heading"><%= product_name %></h2>
+      <% if service_navigation_items.any? %>
+        <div>
+          <button type="button" 
+            aria-controls="service-header__nav" 
+            data-open-class="gem-c-cross-service-header__button--open" 
+            aria-label="Show service navigation menu" 
+            data-label-for-show="Show service navigation menu" 
+            data-label-for-hide="Hide service navigation menu" 
+            data-text-for-show="Menu" 
+            data-text-for-hide="Close" 
+            aria-expanded="false" 
+            class="gem-c-cross-service-header__button gem-c-cross-service-header__button--gem-c-service-header js-x-header-toggle">
+            <span class="gem-c-service-header__button-content">Menu</span>
+          </button>
+          <!-- Important! Label your navigation appropriately! When there are multiple navigation landmarks on a page, additional labelling is required to provide support for screen reader users -->
+          <nav aria-label="<%= service_navigation_aria_label %>">
+            <ul class="gem-c-service-header__nav-list gem-c-service-header__nav" id="service-header__nav" data-open-class="gem-c-service-header__nav--open">
+              <% service_navigation_items.each_with_index do |item, index| %>
+                <%
+                  li_classes = %w(gem-c-service-header__nav-list-item)
+                  li_classes << "gem-c-service-header__nav-list-item--active" if item[:active]
+                  aria_current = item[:active] ? "page" : nil
+                %>
+                <%= tag.li class: li_classes do %>
+                  <%= link_to(
+                    item[:text],
+                    item[:href],
+                    class: 'gem-c-service-header__nav-list-item-link',
+                    data: item[:data],
+                    aria: { current: aria_current }
+                  ) %>
+                <% end %>
+              <% end %>
+            </ul>
+          </nav>
+        </div>
+      <% end %>
+    </div>
+  </div>
+</div>
+<% end %>

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

@@ -34,7 +34,7 @@ accessibility_criteria: |
 
   * be fully expanded
   * not be marked as expandable
-uses_component_wrapper_helper: true  
+uses_component_wrapper_helper: true
 shared_accessibility_criteria:
   - link
 examples:
@@ -182,11 +182,11 @@ examples:
                     <a class="govuk-link" href="#">Retiring your service</a>
                   </li>
               </ul>'
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Allows you to add GA4 tracking to an accordion. This will add a data module and data-attributes with JSONs to the accordion. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
+      Disables GA4 tracking on the accordion. Tracking is enabled by default. This adds a data module and data-attributes with JSONs to the accordion. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       items:
         - heading:
             text: Writing well for the web

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

@@ -192,10 +192,10 @@ examples:
             text: 2. Numbers not parsed
           - href: "#third-thing"
             text: 3. Numbers are just text
-  with_ga4_tracking:
-    description: Enables the GA4 link tracker on the list.
+  without_ga4_tracking:
+    description: Disables GA4 link tracking on the list. Tracking is enabled by default.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       contents:
         - href: "https://www.gov.uk"
           text: 1. First thing

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

@@ -32,13 +32,12 @@ examples:
       inverse: true
     context:
       dark_background: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Adds GA4 tracking to the step by step nav header component when it is rendered as a breadcrumb. See the 
+      Disables GA4 tracking. Tracking is enabled by default. This includes GA4 tracking on the step by step nav header component when it is rendered as a breadcrumb. See the
       [ga4-link-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
-      Note: tracking on regular breadcrumbs is enabled by default and does not require activating.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "A content item"
         links:

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

@@ -69,10 +69,10 @@ examples:
           ordered_related_items:
             - title: "Find an apprenticeship"
               base_path: "/apply-apprenticeship"
-  with_ga4_tracking:
-    description: Adds Google Analytics 4 tracking to the Related Navigation component, if it is visible.
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the component. Tracking is enabled by default.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "A content item"
         links:

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

@@ -103,10 +103,10 @@ examples:
               title: "Russian invasion of Ukraine: UK government response"
               base_path: "/government/topical-events/russian-invasion-of-ukraine-uk-government-response"
               locale: "en"
-  with_ga4_tracking_on_related_navigation:
-    description: Adds Google Analytics 4 tracking to components within the sidebar. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
+  without_ga4_tracking_on_related_navigation:
+    description: Disables GA4 tracking on components within the sidebar. Tracking is enabled by default. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA have tracking.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "UK forces arrive to reinforce NATO’s eastern flank"
         content_id: "a342fd46-d801-4c1e-9d8f-f41fba6da563"
@@ -129,10 +129,10 @@ examples:
               title: "Russian invasion of Ukraine: UK government response"
               base_path: "/government/topical-events/russian-invasion-of-ukraine-uk-government-response"
               locale: "en"
-  with_ga4_tracking_on_step_by_step:
-    description: Adds Google Analytics 4 tracking to components within the sidebar. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
+  without_ga4_tracking_on_step_by_step:
+    description: Disables GA4 tracking on components within the sidebar. Tracking is enabled by default. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         title: "A content item"
         links:
@@ -157,10 +157,10 @@ examples:
                       - text: Arrange the funeral
                         href: "/after-a-death/arrange-the-funeral"
                     optional: false
-  with_ga4_tracking_on_part_of_step_by_step_heading(s):
-    description: Adds Google Analytics 4 tracking to the "Part of" step by step heading(s) in the sidebar. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
+  without_ga4_tracking_on_part_of_step_by_step_heading(s):
+    description: Disables GA4 tracking on the "Part of" step by step heading(s) in the sidebar. Tracking is enabled by default. Currently only the Related Navigation component, Step by Step navigation component and Ukraine CTA accept this option.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         links:
           part_of_step_navs:

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

@@ -49,8 +49,8 @@ examples:
         cookie_preferences:
           text: How we use cookies
           href: "/cookies"
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the "You have accepted cookies" section, and allows the pageview event that is sent when GA4 initialises to record the presence of the cookie acceptance message.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the "You have accepted cookies" section, and allows the pageview event that is sent when GA4 initialises to record the presence of the cookie acceptance message.
     data:
-      ga4_tracking: true
+      disable_ga4: true

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

@@ -0,0 +1,64 @@
+name: Cross service header
+description: | 
+  The One Login header contains two distinct navigation menus - one for GOV.UK One Login links and another for internal service navigation.
+body: |
+  The header contains two links:
+
+  * "GOV.UK One Login": this takes the user to their One Login ‘home’ area, where they can manage their credentials and see and access the services they've used - you don't need to update the url this points to
+  * "Sign out": you'll need to adapt this link so that it signs the user out of your service and signs them out of One Login - how you do this will depend on how you've implemented sign out functionality in your service
+shared_accessibility_criteria:
+  - link
+accessibility_criteria:
+accessibility_excluded_rules:
+  - landmark-banner-is-top-level
+  - duplicate-id-aria
+  - landmark-no-duplicate-banner
+  - landmark-unique
+examples:
+  default:
+    description:
+    data:
+      show_account_layout: true
+      show_cross_service_header: true
+      product_name: GOV.UK email subscriptions
+      one_login_navigation_items:
+        one_login_home:
+          href: "#"
+        one_login_sign_out:
+          text: Sign out
+  with_data_attributes:
+    data:
+      show_account_layout: true
+      show_cross_service_header: true
+      product_name: GOV.UK email subscriptions
+      one_login_navigation_items:
+        one_login_home:
+          href: "#"
+          data:
+            module: explicit-cross-domain-links
+        one_login_sign_out:
+          text: Sign out
+          data:
+            module: explicit-cross-domain-links
+  with_service_navigation_links:
+    description: The header has space to optionally add links to different parts of your service, just as the current 'service header' component from the Design System does. Follow the same patterns for internal service navigation links as you do with the [Design System service header](https://design-system.service.gov.uk/components/header/).
+    data:
+      show_account_layout: true
+      show_cross_service_header: true
+      product_name: GOV.UK email subscriptions
+      one_login_navigation_items:
+        one_login_home:
+          href: "#"
+          data:
+            module: explicit-cross-domain-links
+        one_login_sign_out:
+          text: Sign out
+          data:
+            module: explicit-cross-domain-links
+      service_navigation_items:
+        - text: Example link 1
+          href: "#"
+        - text: Example link 2
+          href: "#"
+        - text: Example link 3
+          href: "#"

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

@@ -19,14 +19,14 @@ examples:
       national_applicability:
         england:
           applicable: true
-  applies_to_two_nations:  
+  applies_to_two_nations:
     data:
       national_applicability:
         england:
           applicable: true
         wales:
           applicable: true
-  applies_to_three_nations:  
+  applies_to_three_nations:
     data:
       national_applicability:
         england:
@@ -89,9 +89,9 @@ examples:
       national_applicability:
         england:
           applicable: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
     data:
       national_applicability:
         england:

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

@@ -45,13 +45,13 @@ examples:
       short_description: "1491 to 1547"
       link: "https://www.gov.uk/"
       homepage: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
     data:
       campaign_class: "notable-death"
       heading: "His Royal Highness Henry VIII"
       short_description: "1491 to 1547"
       link: "https://www.gov.uk/"
       homepage: true
-      ga4_tracking: true
+      disable_ga4: true

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

@@ -6,9 +6,9 @@ body: |
   that would be useful to them. This component would be used to add this personalised content and would
   indicate to the user that this is not normally part of the page, but has been added for them specifically.
 
-  The dismiss link works without Javascript by pointing to the current URL with the "hide-intervention" 
-  query string parameter set to "true". It's progressively enhanced and sets a cookie to remember that 
-  the user has dismissed the banner before. The cookie requires a "name" parameter, the value of which 
+  The dismiss link works without Javascript by pointing to the current URL with the "hide-intervention"
+  query string parameter set to "true". It's progressively enhanced and sets a cookie to remember that
+  the user has dismissed the banner before. The cookie requires a "name" parameter, the value of which
   is stored in the cookie to distinguish which campaign banner the user has dismissed.
 
 accessibility_criteria: |
@@ -33,8 +33,8 @@ examples:
       suggestion_link_url: /travel-abroad
 
   with_dismiss_link:
-    description: | 
-      Name is required in order to set a cookie. The name value should be distinct to the campaign for the banner, 
+    description: |
+      Name is required in order to set a cookie. The name value should be distinct to the campaign for the banner,
       so that other banners using this component are not hidden by accident.
     data:
       suggestion_text: You should renew your permit every 6 months.
@@ -89,11 +89,11 @@ examples:
         track-label: hide the intervention
       dismiss_link_data_attributes:
         track-category: example
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, event tracking on the 'Hide' link, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, event tracking on the 'Hide' link, and allows pageviews to record the presence of the banner on page load.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       suggestion_text: Based on your browsing you might be interested in
       suggestion_link_text: "Travel abroad: step by step"
       suggestion_link_url: /travel-abroad

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

@@ -386,10 +386,10 @@ examples:
       first_published: 14 June 2014
       last_updated: 10 September 2015
       margin_bottom: 2
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables the GA4 link tracker on the 'See all updates' link.
+      Disables the GA4 link tracker on the 'See all updates' link. Tracking is enabled by default.
     data:
       last_updated: 10 September 2015
       see_updates_link: true
-      ga4_tracking: true
+      disable_ga4: true

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

@@ -32,11 +32,11 @@ examples:
       app_name: Skittles Maker
       phase: beta
       inverse: true
-  with_ga4_tracking:
+  without_ga4_tracking:
     description: |
-      Enables GA4 tracking on the banner. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
+      Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, and allows pageviews to record the presence of the banner on page load.
     data:
       app_name: Skittles Maker
       phase: beta
       inverse: true
-      ga4_tracking: true
+      disable_ga4: true

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

@@ -64,10 +64,10 @@ examples:
         url: next-page
         title: Next
         label: 'Driver CPC part 1 test: theory'
-  with_ga4_tracking:
-    description: Enables the GA4 link tracker on the links.
+  without_ga4_tracking:
+    description: Disables the GA4 link tracker on the links. Tracking is enabled by default.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       previous_page:
         url: previous-page
         title: Previous

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

@@ -306,10 +306,10 @@ examples:
               title: "Student loans: terms and conditions 2017 to 2018 (PDF, 136KB)"
             - title: The Student Room repaying your student loan
               url: https://www.thestudentroom.co.uk/content.php?r=5967-Repaying-your-student-loan
-  with_ga4_tracking:
-    description: Adds Google Analytics 4 tracking to the component, using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md).
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the banner. Tracking is enabled by default and uses the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md).
     data:
-      ga4_tracking: true
+      disable_ga4: true
       content_item:
         links:
           ordered_related_items:
@@ -352,4 +352,3 @@ examples:
               base_path: /world/chile/news
             - title: China
               base_path: /world/China/news
- 

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

@@ -72,17 +72,13 @@ examples:
           ]
         }
       ]
-  with_google_analytics_4_tracking:
+  without_google_analytics_4_tracking:
     description: |
-      The ga4_tracking boolean allows you to add Google Analytics 4 (GA4) tracking to your component.
-      Setting this to true will add the `ga4-event-tracker` module to your component. The JavaScript will then add a `data-ga4-event` attribute and `data-ga4-expandable` attribute to the "Show all steps" button, and each clickable Step heading.
-      GA4 will then track these elements when they are expanded or collapsed.
-      `data-ga4-event` contains a JSON with event data relevant to our tracking. `data-ga4-expandable` enables the value of `aria-expanded` to be captured.
-      See the [ga4-event-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) docs for more information.
-      Links are also tracked with the [ga4-link-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md).
-      Therefore the `ga4-link-tracker` data module also exists on these step by step components. Any links will contain a data attribute of `ga4-link`, which contains the relevant tracking data as a JSON.
+      Disables GA4 tracking on the component. Tracking is enabled by default. This includes the [ga4-event-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) module as well as `data-ga4-event` and `data-ga4-expandable` attributes on the "Show all steps" button, and each clickable Step heading. `data-ga4-event` contains JSON with event data relevant to tracking. `data-ga4-expandable` enables the value of `aria-expanded` to be captured.
+
+      Links within steps are tracked with the [ga4-link-tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md). Links are given a data attribute of `ga4-link`, which contains the relevant tracking data as JSON.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       steps: [
         {
           title: "Do something",
@@ -128,7 +124,7 @@ examples:
       ]
   with_unique_tracking:
     description: |
-      In order to identify the step by step navigation the component is part of, we need to track a unique ID of the navigation in Google Analytics. This ID should be the same across all pages that are linked from and are part of that navigation. Its value is included in any tracking events, specifically in dimension96. It refers to the ID of the step nav page.
+      In order to identify the step by step navigation the component is part of, we need to track a unique ID of the navigation in Universal Analytics. This ID should be the same across all pages that are linked from and are part of that navigation. Its value is included in any tracking events, specifically in dimension96. It refers to the ID of the step nav page.
 
       This includes show/hide all, show/hide step and any link clicks.
     data:
@@ -531,7 +527,7 @@ examples:
 
           No change. Active step by step will be expanded.
 
-      4. Content item is part of multiple primary step by steps and a single secondary step by step 
+      4. Content item is part of multiple primary step by steps and a single secondary step by step
 
           No change. Show "Part of" step by steps list. Secondary step by step won't be shown.
 

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

@@ -51,9 +51,9 @@ examples:
       tracking_action: "customTrackingAction"
       tracking_label: "customTrackingLabel"
       tracking_dimension_enabled: false
-  with_ga4_tracking:
-    description: The ga4_tracking boolean allows you to add Google Analytics 4 (GA4) tracking to your component. Setting this to true will add the `ga4-link-tracker` module to your component. The JavaScript will then add a `data-ga4-link` attribute which contains a JSON object with data relevant to our tracking. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the header. Tracking is enabled by default. This includes the `ga4-link-tracker` module and `data-ga4-link` attributes. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       title: 'Learn to drive a motorbike: step by step'
       path: /learn-to-drive-a-motorbike

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

@@ -64,7 +64,7 @@ examples:
       ]
   always_display_as_a_list:
     description: |
-      when this component is rendered alongside an expanded step by step, we want it to render as a heading. 
+      when this component is rendered alongside an expanded step by step, we want it to render as a heading.
       However, in some cases the component will not be followed by a step by step, for example [Book Driving Test](https://www.gov.uk/book-driving-test).
       In these cases, the heading is not followed by any content, so it should be rendered as a list instead.
     data:
@@ -76,10 +76,10 @@ examples:
           text: 'Learn to drive a motorbike: step by step'
         }
       ]
-  with_ga4_tracking:
-    description: The ga4_tracking boolean allows you to add Google Analytics 4 (GA4) tracking to your component. Setting this to true will add the `ga4-link-tracker` module to your component. The JavaScript will then add a `data-ga4-link` attribute which contains a JSON object with data relevant to our tracking. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
+  without_ga4_tracking:
+    description: Disables GA4 tracking on the component. Tracking is enabled by default. This includes the `ga4-link-tracker` module and `data-ga4-link` attributes. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       pretitle: 'Example pretitle'
       links: [
         {

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

@@ -95,10 +95,10 @@ examples:
             tracking: GTM-123AB
           content: |
             <p class="govuk-body-m">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam congue elementum commodo. Vestibulum elit turpis, efficitur quis posuere vitae, commodo vitae augue. Donec ut pharetra ligula. Phasellus ac mauris eu felis bibendum dapibus rutrum sed quam. Pellentesque posuere ante id consequat pretium.</p>
-  with_ga4_tracking_on_tabs:
-    description: Enables GA4 tracking by adding the event tracker and required data attributes to the tabs. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
+  without_ga4_tracking_on_tabs:
+    description: Disables GA4 tracking on tabs. Tracking is enabled by default. This includes the event tracker and required data attributes. See the [ga4-event-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-event-tracker.md) for more information.
     data:
-      ga4_tracking: true
+      disable_ga4: true
       tabs:
         - id: "tab-with-ga4-tracking-1"
           label: "First section"
@@ -110,8 +110,8 @@ examples:
           title: "Second section"
           content: |
             <p class="govuk-body-m">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam congue elementum commodo. Vestibulum elit turpis, efficitur quis posuere vitae, commodo vitae augue. Donec ut pharetra ligula. Phasellus ac mauris eu felis bibendum dapibus rutrum sed quam. Pellentesque posuere ante id consequat pretium.</p>
-  with_ga4_tracking_on_tabs_as_links:
-    description: Enables GA4 tracking by adding the link tracker and required data attributes to the tabs. See the [ga4-link-tracker documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
+  without_ga4_tracking_on_tabs_as_links:
+    description: Disables GA4 tracking on tabs as links. Tracking is enabled by default.
     data:
       as_links: true
       ga4_tracking: true

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

@@ -40,7 +40,7 @@
           index_section_count: "#{section_count}",
           index_total: "#{index_total}",
           section: ga4_heading_text,
-        } if ga4_tracking
+        } unless disable_ga4
         link_element = link_to(
           link[:text],
           link[:path],
@@ -69,13 +69,13 @@
     <% if links.length > section_link_limit %>
       <%
         classes = "gem-c-related-navigation__link toggle-wrap"
-        data_attributes_li = { module: "ga4-event-tracker" } if ga4_tracking
+        data_attributes_li = { module: "ga4-event-tracker" } unless disable_ga4
         data_attributes_link = {
           controls: "toggle_#{section_title}",
           expanded: "false",
           toggled_text: t("common.toggle_less")
         }
-        data_attributes_link[:ga4_event] = { "event_name": "select_content", "type": "related content" } if ga4_tracking
+        data_attributes_link[:ga4_event] = { "event_name": "select_content", "type": "related content" } unless disable_ga4
       %>
       <%= tag.li(class: classes, data: data_attributes_li) do %>
         <%= link_to("#", class: "gem-c-related-navigation__toggle", data: data_attributes_link) do %>

data/lib/govuk_publishing_components/app_helpers/asset_helper.rb

@@ -28,6 +28,7 @@ module GovukPublishingComponents
         govuk_publishing_components/components/_title.css
 
         govuk_publishing_components/components/_cookie-banner.css
+        govuk_publishing_components/components/_cross-service-header.css
         govuk_publishing_components/components/_feedback.css
         govuk_publishing_components/components/_layout-footer.css
         govuk_publishing_components/components/_layout-for-public.css

data/lib/govuk_publishing_components/presenters/breadcrumb_selector.rb

@@ -3,11 +3,11 @@ module GovukPublishingComponents
     class BreadcrumbSelector
       attr_reader :content_item, :request, :prioritise_taxon_breadcrumbs
 
-      def initialize(content_item, request, prioritise_taxon_breadcrumbs, ga4_tracking)
+      def initialize(content_item, request, prioritise_taxon_breadcrumbs, disable_ga4)
         @content_item = content_item
         @request = request
         @prioritise_taxon_breadcrumbs = prioritise_taxon_breadcrumbs
-        @ga4_tracking = ga4_tracking
+        @disable_ga4 = disable_ga4
       end
 
       def breadcrumbs
@@ -38,7 +38,7 @@ module GovukPublishingComponents
         elsif navigation.content_tagged_to_current_step_by_step?
           {
             step_by_step: true,
-            breadcrumbs: navigation.step_nav_helper.header(@ga4_tracking),
+            breadcrumbs: navigation.step_nav_helper.header(@disable_ga4),
           }
         elsif navigation.content_is_tagged_to_a_live_taxon? && prioritise_taxon_breadcrumbs
           {

data/lib/govuk_publishing_components/version.rb

@@ -1,3 +1,3 @@
 module GovukPublishingComponents
-  VERSION = "35.21.4".freeze
+  VERSION = "35.23.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_publishing_components
 version: !ruby/object:Gem::Version
-  version: 35.21.4
+  version: 35.23.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-13 00:00:00.000000000 Z
+date: 2023-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: govuk_app_config
@@ -487,6 +487,7 @@ files:
 - app/assets/javascripts/govuk_publishing_components/components/contextual-guidance.js
 - app/assets/javascripts/govuk_publishing_components/components/cookie-banner.js
 - app/assets/javascripts/govuk_publishing_components/components/copy-to-clipboard.js
+- app/assets/javascripts/govuk_publishing_components/components/cross-service-header.js
 - app/assets/javascripts/govuk_publishing_components/components/details.js
 - app/assets/javascripts/govuk_publishing_components/components/error-summary.js
 - app/assets/javascripts/govuk_publishing_components/components/feedback.js
@@ -553,6 +554,7 @@ files:
 - app/assets/stylesheets/govuk_publishing_components/components/_contextual-sidebar.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_cookie-banner.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_copy-to-clipboard.scss
+- app/assets/stylesheets/govuk_publishing_components/components/_cross-service-header.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_date-input.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_details.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_devolved-nations.scss
@@ -688,6 +690,7 @@ files:
 - app/views/govuk_publishing_components/components/_contextual_sidebar.html.erb
 - app/views/govuk_publishing_components/components/_cookie_banner.html.erb
 - app/views/govuk_publishing_components/components/_copy_to_clipboard.html.erb
+- app/views/govuk_publishing_components/components/_cross_service_header.html.erb
 - app/views/govuk_publishing_components/components/_date_input.html.erb
 - app/views/govuk_publishing_components/components/_details.html.erb
 - app/views/govuk_publishing_components/components/_devolved_nations.html.erb
@@ -755,6 +758,8 @@ files:
 - app/views/govuk_publishing_components/components/attachment/_thumbnail_html.html.erb
 - app/views/govuk_publishing_components/components/attachment/_thumbnail_spreadsheet.html.erb
 - app/views/govuk_publishing_components/components/contextual_sidebar/_ukraine_cta.html.erb
+- app/views/govuk_publishing_components/components/cross_service_header/_one_login_header.html.erb
+- app/views/govuk_publishing_components/components/cross_service_header/_service_header.html.erb
 - app/views/govuk_publishing_components/components/docs/accordion.yml
 - app/views/govuk_publishing_components/components/docs/action_link.yml
 - app/views/govuk_publishing_components/components/docs/attachment.yml
@@ -773,6 +778,7 @@ files:
 - app/views/govuk_publishing_components/components/docs/contextual_sidebar.yml
 - app/views/govuk_publishing_components/components/docs/cookie_banner.yml
 - app/views/govuk_publishing_components/components/docs/copy_to_clipboard.yml
+- app/views/govuk_publishing_components/components/docs/cross_service_header.yml
 - app/views/govuk_publishing_components/components/docs/date_input.yml
 - app/views/govuk_publishing_components/components/docs/details.yml
 - app/views/govuk_publishing_components/components/docs/devolved_nations.yml