govuk_publishing_components 29.15.3 → 30.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1093c2ff6d40fae820a8b90e7a349d7e8dd78b10fca660453365343d7968749c
-  data.tar.gz: 3607d6e31004a9697a60a6c7075124b085b2c7a592c6f159e9540fa9ed7c0ad6
+  metadata.gz: 4aee02160c93679a75c8418c7b1f0da2ed3908a6016f4437f06dfa0091b61096
+  data.tar.gz: 629859a537593a4f5547cbfa45e866bde739b616ef0598f2428ea07bc0f0af26
 SHA512:
-  metadata.gz: 126afbff6dcbcab4a12c6551ab3546c2727841a9454df9a2eafae820bf8dcb483ad578b041e3250f085b3ba34534eabbb80727715f706391fdc2530d975da97a
-  data.tar.gz: ea8bdcc6c1f05fc3f469de5fe182ff304ea58e228ad9caf8c89ecf8f66cc8ad8c279a5ff4d5556f09fbed75f88cd5cbd5cc46c21afc2dd1249befcbe16af8dd6
+  metadata.gz: 043a2bed5b586217a53aea43f53b9a43219b6f8947aaa90776d00a86ebb1f78c410131085401a2b0802a450426d85be2e22f986447e9e99c4d2afee76f95cbbb
+  data.tar.gz: a52358d241fd9539a21fd7cb47c4d54fd2e402e0441758ec7348eb9b14c64444cfeaca9c54e03c34e8051c10bcac4c7c0f00999898f3586b5007f320ba9a5d86

data/app/assets/javascripts/govuk_publishing_components/analytics-ga4/{gtm-click-tracking.js → ga4-event-tracker.js}

@@ -5,16 +5,16 @@ window.GOVUK.Modules = window.GOVUK.Modules || {};
 (function (Modules) {
   'use strict'
 
-  function GtmClickTracking (module) {
+  function GA4EventTracker (module) {
     this.module = module
     this.trackingTrigger = 'data-ga4' // elements with this attribute get tracked
   }
 
-  GtmClickTracking.prototype.init = function () {
+  GA4EventTracker.prototype.init = function () {
     this.module.addEventListener('click', this.trackClick.bind(this), true) // useCapture must be true
   }
 
-  GtmClickTracking.prototype.trackClick = function (event) {
+  GA4EventTracker.prototype.trackClick = function (event) {
     if (window.dataLayer) {
       var target = this.findTrackingAttributes(event.target)
       if (target) {
@@ -33,7 +33,7 @@ window.GOVUK.Modules = window.GOVUK.Modules || {};
         // get attributes from the data attribute to send to GA
         // only allow it if it already exists in the schema
         for (var property in data) {
-          if (schema.event_data[property]) {
+          if (property in schema.event_data) {
             schema.event_data[property] = data[property]
           }
         }
@@ -58,12 +58,25 @@ window.GOVUK.Modules = window.GOVUK.Modules || {};
           var openAttribute = detailsElement.getAttribute('open')
           schema.event_data.action = (openAttribute == null) ? 'opened' : 'closed'
         }
+
+        /* If a tab was clicked, grab the href of the clicked tab (usually an anchor # link) */
+        var tabElement = event.target.closest('.gem-c-tabs')
+        if (tabElement) {
+          var aTag = event.target.closest('a')
+          if (aTag) {
+            var href = aTag.getAttribute('href')
+            if (href) {
+              schema.event_data.url = href
+            }
+          }
+        }
+
         window.dataLayer.push(schema)
       }
     }
   }
 
-  GtmClickTracking.prototype.findTrackingAttributes = function (clicked) {
+  GA4EventTracker.prototype.findTrackingAttributes = function (clicked) {
     if (clicked.hasAttribute('[' + this.trackingTrigger + ']')) {
       return clicked
     } else {
@@ -72,7 +85,7 @@ window.GOVUK.Modules = window.GOVUK.Modules || {};
   }
 
   // check if an attribute exists or contains the attribute
-  GtmClickTracking.prototype.getClosestAttribute = function (clicked, attribute) {
+  GA4EventTracker.prototype.getClosestAttribute = function (clicked, attribute) {
     var isAttributeOnElement = clicked.getAttribute(attribute)
     var containsAttribute = clicked.querySelector('[' + attribute + ']')
 
@@ -83,5 +96,5 @@ window.GOVUK.Modules = window.GOVUK.Modules || {};
     }
   }
 
-  Modules.GtmClickTracking = GtmClickTracking
+  Modules.GA4EventTracker = GA4EventTracker
 })(window.GOVUK.Modules)

data/app/assets/javascripts/govuk_publishing_components/analytics-ga4/ga4-link-tracker.js

@@ -0,0 +1,153 @@
+// = require govuk/vendor/polyfills/Element/prototype/closest.js
+
+;(function (global) {
+  'use strict'
+
+  var GOVUK = global.GOVUK || {}
+  GOVUK.analyticsGA4 = GOVUK.analyticsGA4 || {}
+
+  GOVUK.analyticsGA4.linkTracker = {
+    trackLinkClicks: function () {
+      if (window.dataLayer) {
+        this.internalLinksDomain = 'www.gov.uk/'
+        this.internalLinksDomainWithoutWww = 'gov.uk/'
+        this.handleClick = this.handleClick.bind(this)
+        this.handleMousedown = this.handleMousedown.bind(this)
+        document.querySelector('body').addEventListener('click', this.handleClick)
+        document.querySelector('body').addEventListener('contextmenu', this.handleClick)
+        document.querySelector('body').addEventListener('mousedown', this.handleMousedown)
+      }
+    },
+
+    stopTracking: function () {
+      document.querySelector('body').removeEventListener('click', this.handleClick)
+      document.querySelector('body').removeEventListener('contextmenu', this.handleClick)
+      document.querySelector('body').removeEventListener('mousedown', this.handleMousedown)
+    },
+
+    handleClick: function (event) {
+      var element = event.target
+
+      if (element.tagName !== 'A') {
+        element = element.closest('a')
+      }
+
+      if (!element) {
+        return
+      }
+
+      var clickData = {}
+      var href = element.getAttribute('href')
+
+      if (!href) {
+        return
+      }
+
+      if (this.isMailToLink(href)) {
+        clickData.type = 'email'
+        clickData.external = 'true'
+      } else if (this.isDownloadLink(href)) {
+        clickData.type = 'download'
+        clickData.external = 'false'
+      } else if (this.isExternalLink(href)) {
+        clickData.type = 'generic link'
+        clickData.external = 'true'
+      }
+
+      if (Object.keys(clickData).length > 0) {
+        clickData.event_name = 'navigation'
+        clickData.text = element.textContent.trim()
+        clickData.url = href
+        clickData.link_method = this.getClickType(event)
+
+        var schema = new window.GOVUK.analyticsGA4.Schemas().eventSchema()
+        schema.event = 'analytics'
+
+        // get attributes from the clickData object to send to GA
+        // only allow it if it already exists in the schema
+        for (var property in clickData) {
+          if (property in schema.event_data) {
+            schema.event_data[property] = clickData[property]
+          }
+        }
+
+        window.dataLayer.push(schema)
+      }
+    },
+
+    getClickType: function (event) {
+      switch (event.type) {
+        case 'click':
+          if (event.ctrlKey) {
+            return 'ctrl click'
+          } else if (event.metaKey) {
+            return 'command/win click'
+          } else {
+            return 'primary click'
+          }
+        case 'mousedown':
+          return 'middle click'
+        case 'contextmenu':
+          return 'secondary click'
+      }
+    },
+
+    handleMousedown: function (event) {
+      // 1 = middle mouse button
+      if (event.button === 1) {
+        this.handleClick(event)
+      }
+    },
+
+    isMailToLink: function (href) {
+      return href.substring(0, 7) === 'mailto:'
+    },
+
+    isDownloadLink: function (href) {
+      var assetsDomain = 'assets.publishing.service.gov.uk/'
+      var uploadsPath = '/government/uploads/'
+
+      if (this.hrefPointsToDomain(href, assetsDomain)) {
+        return true
+      }
+
+      var isInternalLink = this.hrefPointsToDomain(href, this.internalLinksDomain) || this.hrefPointsToDomain(href, this.internalLinksDomainWithoutWww)
+      if (isInternalLink && href.indexOf(uploadsPath) !== -1) {
+        return true
+      }
+
+      // Checks relative links to the uploadsPath
+      if (this.stringStartsWith(href, uploadsPath)) {
+        return true
+      }
+    },
+
+    isExternalLink: function (href) {
+      var isInternalLink = this.hrefPointsToDomain(href, this.internalLinksDomain) || this.hrefPointsToDomain(href, this.internalLinksDomainWithoutWww)
+      if (!isInternalLink && !this.hrefIsRelative(href)) {
+        return true
+      }
+    },
+
+    hrefPointsToDomain: function (href, domain) {
+      var httpDomain = 'http://' + domain
+      var httpsDomain = 'https://' + domain
+      var schemaRelativeDomain = '//' + domain
+      return this.stringStartsWith(href, domain) ||
+      this.stringStartsWith(href, httpDomain) ||
+      this.stringStartsWith(href, httpsDomain) ||
+      this.stringStartsWith(href, schemaRelativeDomain)
+    },
+
+    stringStartsWith: function (string, stringToFind) {
+      return string.substring(0, stringToFind.length) === stringToFind
+    },
+
+    hrefIsRelative: function (href) {
+      // Checks that a link is relative, but is not a protocol relative url
+      return href[0] === '/' && href[1] !== '/'
+    }
+  }
+
+  global.GOVUK = GOVUK
+})(window)

data/app/assets/javascripts/govuk_publishing_components/analytics-ga4/{gtm-page-views.js → ga4-page-views.js}

@@ -2,9 +2,11 @@
   'use strict'
 
   var GOVUK = global.GOVUK || {}
+  GOVUK.analyticsGA4 = GOVUK.analyticsGA4 || {}
 
-  GOVUK.Gtm = {
+  GOVUK.analyticsGA4.pageViewTracker = {
     PIIRemover: new GOVUK.analyticsGA4.PIIRemover(), // imported in analytics-ga4.js
+    nullValue: null,
 
     sendPageView: function () {
       if (window.dataLayer) {
@@ -32,9 +34,9 @@
             language: this.getLanguage(),
             history: this.getHistory(),
             withdrawn: this.getWithDrawn(),
-            first_published_at: this.getMetaContent('first-published-at'),
-            updated_at: this.getMetaContent('updated-at'),
-            public_updated_at: this.getMetaContent('public-updated-at'),
+            first_published_at: this.stripTimeFrom(this.getMetaContent('first-published-at')),
+            updated_at: this.stripTimeFrom(this.getMetaContent('updated-at')),
+            public_updated_at: this.stripTimeFrom(this.getMetaContent('public-updated-at')),
             publishing_government: this.getMetaContent('publishing-government'),
             political_status: this.getMetaContent('political-status'),
             primary_publishing_organisation: this.getMetaContent('primary-publishing-organisation'),
@@ -73,13 +75,17 @@
       if (tag) {
         return tag.getAttribute('content')
       } else {
-        return 'n/a'
+        return this.nullValue
       }
     },
 
     getLanguage: function () {
-      var html = document.querySelector('html')
-      return html.getAttribute('lang') || 'n/a'
+      var content = document.getElementById('content')
+      if (content) {
+        return content.getAttribute('lang') || this.nullValue
+      } else {
+        return this.nullValue
+      }
     },
 
     getHistory: function () {
@@ -90,6 +96,16 @@
     getWithDrawn: function () {
       var withdrawn = this.getMetaContent('withdrawn')
       return (withdrawn === 'withdrawn') ? 'true' : 'false'
+    },
+
+    // return only the date from given timestamps of the form
+    // 2022-03-28T19:11:00.000+00:00
+    stripTimeFrom: function (value) {
+      if (value !== null) {
+        return value.split('T')[0]
+      } else {
+        return this.nullValue
+      }
     }
   }
 

data/app/assets/javascripts/govuk_publishing_components/analytics-ga4/{gtm-schemas.js → ga4-schemas.js}

@@ -4,7 +4,7 @@
   var GOVUK = global.GOVUK || {}
 
   var Schemas = function () {
-    this.null = 'n/a'
+    this.null = null
   }
 
   Schemas.prototype.eventSchema = function () {
@@ -20,7 +20,8 @@
         index_total: this.null,
         section: this.null,
         action: this.null,
-        external: this.null
+        external: this.null,
+        link_method: this.null
       }
     }
   }

data/app/assets/javascripts/govuk_publishing_components/analytics-ga4.js

@@ -1,7 +1,9 @@
 // The following modules are imported in a specific order
-//= require ./analytics-ga4/gtm-schemas
+//= require ./analytics-ga4/ga4-schemas
 //= require ./analytics-ga4/pii-remover
-//= require ./analytics-ga4/gtm-page-views
-//= require ./analytics-ga4/gtm-click-tracking
+//= require ./analytics-ga4/ga4-page-views
+//= require ./analytics-ga4/ga4-link-tracker
+//= require ./analytics-ga4/ga4-event-tracker
 
-window.GOVUK.Gtm.sendPageView() // this will need integrating with cookie consent before production
+window.GOVUK.analyticsGA4.pageViewTracker.sendPageView() // this will need integrating with cookie consent before production
+window.GOVUK.analyticsGA4.linkTracker.trackLinkClicks()

data/app/assets/stylesheets/govuk_publishing_components/_all_components.scss

@@ -31,6 +31,7 @@ $govuk-new-link-styles: true;
 @import "components/details";
 @import "components/devolved-nations";
 @import "components/document-list";
+@import "components/emergency-banner";
 @import "components/error-alert";
 @import "components/error-message";
 @import "components/error-summary";

data/app/assets/stylesheets/govuk_publishing_components/_all_components_print.scss

@@ -7,6 +7,7 @@
 @import "components/print/button";
 @import "components/print/cards";
 @import "components/print/contents-list";
+@import "components/print/emergency-banner";
 @import "components/print/govspeak-html-publication";
 @import "components/print/govspeak";
 @import "components/print/layout-super-navigation-header";

data/app/assets/stylesheets/govuk_publishing_components/components/_emergency-banner.scss

@@ -0,0 +1,76 @@
+.gem-c-emergency-banner {
+  @include govuk-font(19);
+  background-color: govuk-colour("mid-grey");
+  color: govuk-colour("white");
+  margin-top: 2px;
+  padding: govuk-spacing(3) 0;
+
+  @include govuk-media-query($from: tablet) {
+    padding: govuk-spacing(6) 0;
+  }
+}
+
+.gem-c-emergency-banner--homepage {
+  border-bottom: govuk-spacing(1) solid govuk-colour("white");
+  border-top: govuk-spacing(1) solid govuk-colour("white");
+  margin-bottom: govuk-spacing(-2);
+  margin-top: 0;
+  position: relative;
+  z-index: 10;
+}
+
+.gem-c-emergency-banner__heading {
+  @include govuk-font(24, $weight: bold);
+  margin: 0;
+}
+
+.gem-c-emergency-banner__heading--homepage {
+  @include govuk-font(48, $weight: bold);
+
+  @include govuk-media-query($from: tablet) {
+    margin-bottom: govuk-spacing(4);
+  }
+}
+
+.gem-c-emergency-banner__description {
+  @include govuk-font(19);
+  color: govuk-colour("white");
+  margin-top: 0;
+  margin-bottom: govuk-spacing(4);
+
+  &:last-child {
+    margin-bottom: 0;
+  }
+}
+
+.gem-c-emergency-banner__description--homepage {
+  margin: govuk-spacing(4) 0;
+}
+
+.gem-c-emergency-banner__link {
+  @include govuk-font(19);
+}
+
+.gem-c-emergency-banner__link:link,
+.gem-c-emergency-banner__link:visited {
+  color: govuk-colour("white");
+}
+
+.gem-c-emergency-banner__link:focus {
+  @include govuk-focused-text;
+}
+
+.gem-c-emergency-banner--notable-death {
+  background-color: govuk-colour("black");
+}
+
+.gem-c-emergency-banner--national-emergency {
+  // Not using govuk-colour("red") aka #d4351c as that's a slightly different red.
+  background-color: #b10e1e;
+}
+
+.gem-c-emergency-banner--local-emergency {
+  // Not using govuk-colour("turquoise") for background colour as
+  // the contrast was too low with white text
+  background-color: #00847d;
+}

data/app/assets/stylesheets/govuk_publishing_components/components/govspeak/_typography.scss

@@ -108,11 +108,3 @@
     @include govuk-link-style-inverse;
   }
 }
-
-// This helper class is for use by the primary links js module
-// We have this custom helper here with a single rule over using the design system helper class govuk-!-display-none
-// because jasmine tests don't like the "!" in the distributed helper class
-
-.primary-links--display-none {
-  display: none;
-}

data/app/assets/stylesheets/govuk_publishing_components/components/print/_emergency-banner.scss

@@ -0,0 +1,3 @@
+.gem-c-emergency-banner {
+  display: none;
+}

data/app/models/govuk_publishing_components/audit_applications.rb

@@ -150,7 +150,7 @@ module GovukPublishingComponents
     end
 
     def clean_file_path(file)
-      file[/(?<=#{Regexp.escape(@path.to_s)}\/)[\/a-zA-Z_-]+.[a-zA-Z.]+/]
+      file[/(?<=#{Regexp.escape(@path.to_s)}\/)[\/a-zA-Z_-]+.[a-zA-Z+.]+/]
     end
 
     def clean_file_name(name)

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

@@ -7,6 +7,10 @@
 
 <%= render 'govuk_publishing_components/components/title', title: @component_example.name, context: "#{@component_doc.name} example", margin_top: 0 %>
 
+<% code_example = capture do %>
+  <%= render partial: "govuk_publishing_components/component_guide/component_doc/call", locals: { component_doc: @component_doc, example: @component_example } %>
+<% end %>
+
 <div class="component-show">
   <div class="component-doc">
     <div class="component-markdown">
@@ -19,6 +23,6 @@
     <%= render partial: "govuk_publishing_components/component_guide/component_doc/preview", locals: { component_doc: @component_doc, example: @component_example } %>
 
     <h2 class="component-doc-h2">How to call this example</h2>
-    <%= render partial: "govuk_publishing_components/component_guide/component_doc/call", locals: { component_doc: @component_doc, example: @component_example } %>
+    <%= code_example %>
   </div>
 </div>

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

@@ -74,8 +74,11 @@
           <div class="component-markdown">
             <%= raw(example.html_description) %>
           </div>
+          <% code_example = capture do %>
+            <%= render "govuk_publishing_components/component_guide/component_doc/call", component_doc: @component_doc, example: example %>
+          <% end %>
           <%= render "govuk_publishing_components/component_guide/component_doc/preview", component_doc: @component_doc, example: example %>
-          <%= render "govuk_publishing_components/component_guide/component_doc/call", component_doc: @component_doc, example: example %>
+          <%= code_example %>
         </div>
       <% end %>
     </div>

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

@@ -22,7 +22,7 @@
   locales = {}
 
   data_attributes ||= {}
-  data_attributes[:module] = 'govuk-accordion gem-accordion'
+  ((data_attributes[:module] ||= "") << " " << "govuk-accordion gem-accordion").strip!
   data_attributes[:anchor_navigation] = anchor_navigation
   data_attributes[:track_show_all_clicks] = track_show_all_clicks
   data_attributes[:track_sections] = track_sections

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

@@ -0,0 +1,51 @@
+<%
+  heading ||= ""
+  short_description ||= nil
+  link ||= nil
+  link_text ||= "More information"
+  campaign_class ||= nil
+  homepage ||= false
+
+  emergency_banner_helper = GovukPublishingComponents::Presenters::EmergencyBannerHelper.new()
+
+  if !campaign_class
+    raise ArgumentError, "Need to specify an emergency_type"
+  end
+
+  if !emergency_banner_helper.is_a_valid_emergency_type?(campaign_class)
+    raise ArgumentError, "Emergency type #{campaign_class} is not in list of valid emergency types (#{emergency_banner_helper.emergency_types.join(', ')})"
+  end
+
+  banner_classes = %w[gem-c-emergency-banner]
+  banner_classes << "gem-c-emergency-banner--#{campaign_class}"
+  banner_classes << "gem-c-emergency-banner--homepage" if homepage
+
+  heading_classes = %w[gem-c-emergency-banner__heading]
+  heading_classes << "gem-c-emergency-banner__heading--homepage" if homepage
+
+  description_classes = %w[gem-c-emergency-banner__description]
+  description_classes << "gem-c-emergency-banner__description--homepage" if homepage
+
+%>
+
+<%= content_tag('div', class: banner_classes, "aria-label": "emergency banner", "role": "region", "data-nosnippet": true ) do %>
+  <div class="govuk-width-container">
+    <div class="govuk-grid-row">
+      <div class="govuk-grid-column-two-thirds">
+        <%= content_tag('h2', class: heading_classes) do %>
+          <%= heading %>
+        <% end %>
+        <% if short_description %>
+          <%= content_tag('p', class: description_classes) do %>
+            <%= short_description %>
+          <% end %>
+        <% end %>
+        <% if link %>
+          <a href="<%= link %>" class="gem-c-emergency-banner__link">
+            <%= link_text %>
+          </a>
+        <% end %>
+      </div>
+    </div>
+  </div>
+<% end %>

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

@@ -6,7 +6,7 @@
   margin_top ||= 3
   margin_bottom ||= 3
 
-  data_attributes[:module] = require_js ? "print-link" : "button"
+  ((data_attributes[:module] ||= "") << " " << (require_js ? "print-link" : "button")).strip!
 
   shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new({
     margin_top: margin_top,

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

@@ -185,18 +185,17 @@ examples:
     description: |
       Adds custom data attributes to each section of the accordion. Accepts a hash, so multiple attributes can be added.
 
-      The `data_attributes` hash is for the outermost element in the accordion.
+      The `data_attributes` option applies attributes to the outermost element in the accordion. Each item can also have a `data_attributes` hash, which are placed on the `button` that triggers the opening and closing - useful for differentiating between each section of the accordion.
 
-      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 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). More details on how this can be used with the GA4 event tracking can be found in the 'Advanced' section of the [event tracking documentation](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-gtm/ga4-event-tracker.md).
 
-      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). If `track_options` within `data_attributes_show_all` is set, then it is possible to pass a custom dimension when 'Show/Hide all' is clicked.
+      If `track_options` within `data_attributes_show_all` is set, then it is possible to pass a custom dimension when 'Show/Hide all' is clicked.
     data:
       data_attributes:
-          gtm: gtm-accordion
-          ga: ga-accordion
+        custom_data_attr: custom-data-attr-accordion
       data_attributes_show_all:
-        gtm-event-name: example
-        gtm-attributes: "{ 'ui': { 'type': 'type value', 'section': 'section value' } }"
+        custom_data_attr-event-name: example
+        custom_data_attr-attributes: "{ 'ui': { 'type': 'type value', 'section': 'section value' } }"
         tracking-options: "{ 'dimension114': 1 }"
       items:
         - heading:
@@ -204,25 +203,39 @@ examples:
           content:
             html: <p class="govuk-body">This is the content for Writing well for the web.</p>
           data_attributes:
-            gtm: gtm-accordion-item-1
+            custom_data_attr: custom-data-attr-accordion-item-1
         - heading:
             text: Writing well for specialists
           content:
             html: <p class="govuk-body">This is the content for Writing well for specialists.</p>
           data_attributes:
-            gtm: gtm-accordion-item-2
+            custom_data_attr: custom-data-attr-accordion-item-2
         - heading:
             text: Know your audience
           content:
             html: <p class="govuk-body">This is the content for Know your audience.</p>
           data_attributes:
-            gtm: gtm-accordion-item-3
+            custom_data_attr: custom-data-attr-accordion-item-3
         - heading:
             text: How people read
           content:
             html: <p class="govuk-body">This is the content for How people read.</p>
           data_attributes:
-            gtm: gtm-accordion-item-4
+            custom_data_attr: custom-data-attr-accordion-item-4
+  with_custom_data_module:
+    description: The component includes its own `data-module` but others can be passed in addition if required, for example to apply tracking to an element. This will be included along with the components own `data-module`.
+    data:
+      data_attributes:
+        module: gem-track-click
+      items:
+        - heading:
+            text: Writing well for the web
+          content:
+            html: <p class="govuk-body">This is the content for Writing well for the web.</p>
+        - heading:
+            text: Writing well for specialists
+          content:
+            html: <p class="govuk-body">This is the content for Writing well for specialists.</p>
   different_heading_level:
     description: This will alter the level of the heading, not the appearance of the heading.
     data:

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

@@ -0,0 +1,45 @@
+name: Emergency banner
+description: A site-wide banner used in the event of an emergency
+body: |
+  There are three types of events that would lead GOV.UK to add an emergency banner to the top of each page on the web site; a notable death, a national emergency or a local emergency.
+
+  See the [opsmanual](https://docs.publishing.service.gov.uk/manual/emergency-publishing.html#adding-emergency-publishing-banners) for information about what the Emergency Banner is and when it should be deployed.
+
+shared_accessibility_criteria:
+  - link
+
+examples:
+  default:
+    description: |
+      Death of a notable person
+    data:
+      campaign_class: "notable-death"
+      heading: "His Royal Highness Henry VIII"
+      short_description: "1491 to 1547"
+      link_text: "Override Link Text"
+      link: "https://www.gov.uk/"
+  national_emergency:
+    description: |
+      National emergency (level 1 or category 2)
+    data:
+      campaign_class: "national-emergency"
+      heading: "National emergency"
+      short_description: "This is a level 1 incident"
+      link: "https://www.gov.uk/"
+  local_emergency:
+    description: |
+      Localised large-scale emergency (level 2 or category 1)
+    data:
+      campaign_class: "local-emergency"
+      heading: "Local emergency"
+      short_description: "This is a level 2 incident"
+      link: "https://www.gov.uk/"
+  notable_death_homepage:
+    description: |
+      When presenting any type of emergency banner on homepage the styling is slightly different.
+    data:
+      campaign_class: "notable-death"
+      heading: "His Royal Highness Henry VIII"
+      short_description: "1491 to 1547"
+      link: "https://www.gov.uk/"
+      homepage: true

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

@@ -26,6 +26,11 @@ examples:
         track-category: "printButton"
         track-action: "clicked"
         track-label: "Print this page"
+  with_custom_data_module:
+    description: The component includes its own `data-module` but others can be passed in addition if required, for example to apply tracking to an element. This will be included along with the components own `data-module`.
+    data:
+      data_attributes:
+        module: "gem-track-click"
   with_custom_margins:
     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 having margin level `3` on top and bottom.
     data:

data/config/locales/hr.yml

@@ -16,7 +16,6 @@ hr:
       order_a_copy: Naručite kopiju
       page:
         few:
-        many:
         one: 1 stranica
         other: "%{count} stranice"
       reference: 'Referenca: %{reference}'

data/lib/govuk_publishing_components/presenters/emergency_banner_helper.rb

@@ -0,0 +1,17 @@
+module GovukPublishingComponents
+  module Presenters
+    class EmergencyBannerHelper
+      EMERGENCY_TYPES = %w[notable-death national-emergency local-emergency].freeze
+
+      def initialize; end
+
+      def emergency_types
+        EMERGENCY_TYPES
+      end
+
+      def is_a_valid_emergency_type?(type)
+        EMERGENCY_TYPES.include?(type)
+      end
+    end
+  end
+end

data/lib/govuk_publishing_components/version.rb

@@ -1,3 +1,3 @@
 module GovukPublishingComponents
-  VERSION = "29.15.3".freeze
+  VERSION = "30.2.0".freeze
 end

data/lib/govuk_publishing_components.rb

@@ -12,6 +12,7 @@ require "govuk_publishing_components/presenters/breadcrumb_selector"
 require "govuk_publishing_components/presenters/button_helper"
 require "govuk_publishing_components/presenters/contextual_navigation"
 require "govuk_publishing_components/presenters/devolved_nations_helper"
+require "govuk_publishing_components/presenters/emergency_banner_helper"
 require "govuk_publishing_components/presenters/related_navigation_helper"
 require "govuk_publishing_components/presenters/step_by_step_nav_helper"
 require "govuk_publishing_components/presenters/page_with_step_by_step_navigation"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_publishing_components
 version: !ruby/object:Gem::Version
-  version: 29.15.3
+  version: 30.2.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-27 00:00:00.000000000 Z
+date: 2022-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: govuk_app_config
@@ -436,9 +436,10 @@ files:
 - app/assets/javascripts/component_guide/vendor/matches-polyfill.min.js
 - app/assets/javascripts/govuk_publishing_components/all_components.js
 - app/assets/javascripts/govuk_publishing_components/analytics-ga4.js
-- app/assets/javascripts/govuk_publishing_components/analytics-ga4/gtm-click-tracking.js
-- app/assets/javascripts/govuk_publishing_components/analytics-ga4/gtm-page-views.js
-- app/assets/javascripts/govuk_publishing_components/analytics-ga4/gtm-schemas.js
+- app/assets/javascripts/govuk_publishing_components/analytics-ga4/ga4-event-tracker.js
+- app/assets/javascripts/govuk_publishing_components/analytics-ga4/ga4-link-tracker.js
+- app/assets/javascripts/govuk_publishing_components/analytics-ga4/ga4-page-views.js
+- app/assets/javascripts/govuk_publishing_components/analytics-ga4/ga4-schemas.js
 - app/assets/javascripts/govuk_publishing_components/analytics-ga4/pii-remover.js
 - app/assets/javascripts/govuk_publishing_components/analytics.js
 - app/assets/javascripts/govuk_publishing_components/analytics/analytics.js
@@ -495,7 +496,6 @@ files:
 - app/assets/javascripts/govuk_publishing_components/lib/govspeak/magna-charta.js
 - app/assets/javascripts/govuk_publishing_components/lib/govspeak/youtube-link-enhancement.js
 - app/assets/javascripts/govuk_publishing_components/lib/initial-focus.js
-- app/assets/javascripts/govuk_publishing_components/lib/primary-links.js
 - app/assets/javascripts/govuk_publishing_components/lib/toggle-input-class-on-focus.js
 - app/assets/javascripts/govuk_publishing_components/lib/toggle.js
 - app/assets/javascripts/govuk_publishing_components/lib/trigger-event.js
@@ -535,6 +535,7 @@ files:
 - app/assets/stylesheets/govuk_publishing_components/components/_details.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_devolved-nations.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_document-list.scss
+- app/assets/stylesheets/govuk_publishing_components/components/_emergency-banner.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_error-alert.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_error-message.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_error-summary.scss
@@ -623,6 +624,7 @@ files:
 - app/assets/stylesheets/govuk_publishing_components/components/print/_button.scss
 - app/assets/stylesheets/govuk_publishing_components/components/print/_cards.scss
 - app/assets/stylesheets/govuk_publishing_components/components/print/_contents-list.scss
+- app/assets/stylesheets/govuk_publishing_components/components/print/_emergency-banner.scss
 - app/assets/stylesheets/govuk_publishing_components/components/print/_govspeak-html-publication.scss
 - app/assets/stylesheets/govuk_publishing_components/components/print/_govspeak.scss
 - app/assets/stylesheets/govuk_publishing_components/components/print/_layout-super-navigation-header.scss
@@ -679,6 +681,7 @@ files:
 - app/views/govuk_publishing_components/components/_details.html.erb
 - app/views/govuk_publishing_components/components/_devolved_nations.html.erb
 - app/views/govuk_publishing_components/components/_document_list.html.erb
+- app/views/govuk_publishing_components/components/_emergency_banner.html.erb
 - app/views/govuk_publishing_components/components/_error_alert.html.erb
 - app/views/govuk_publishing_components/components/_error_message.html.erb
 - app/views/govuk_publishing_components/components/_error_summary.html.erb
@@ -761,6 +764,7 @@ files:
 - app/views/govuk_publishing_components/components/docs/details.yml
 - app/views/govuk_publishing_components/components/docs/devolved_nations.yml
 - app/views/govuk_publishing_components/components/docs/document_list.yml
+- app/views/govuk_publishing_components/components/docs/emergency_banner.yml
 - app/views/govuk_publishing_components/components/docs/error_alert.yml
 - app/views/govuk_publishing_components/components/docs/error_message.yml
 - app/views/govuk_publishing_components/components/docs/error_summary.yml
@@ -923,6 +927,7 @@ files:
 - lib/govuk_publishing_components/presenters/contextual_navigation.rb
 - lib/govuk_publishing_components/presenters/curated_taxonomy_sidebar_links.rb
 - lib/govuk_publishing_components/presenters/devolved_nations_helper.rb
+- lib/govuk_publishing_components/presenters/emergency_banner_helper.rb
 - lib/govuk_publishing_components/presenters/heading_helper.rb
 - lib/govuk_publishing_components/presenters/image_card_helper.rb
 - lib/govuk_publishing_components/presenters/intervention_helper.rb
@@ -1932,7 +1937,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.18
+rubygems_version: 3.3.20
 signing_key: 
 specification_version: 4
 summary: A gem to document components in GOV.UK frontend applications

data/app/assets/javascripts/govuk_publishing_components/lib/primary-links.js

@@ -1,74 +0,0 @@
-// migrated from govuk_frontend_toolkit
-;(function (global) {
-  'use strict'
-
-  var GOVUK = global.GOVUK || {}
-
-  // Only show the first {n} items in a list, documentation is in the README.md
-  var PrimaryList = function (el, selector) {
-    this.el = el
-    this.extraLinks = this.el.querySelectorAll('li:not(' + selector + ')')
-    // only hide more than one extra link
-    if (this.extraLinks.length > 1) {
-      this.addToggleLink()
-      this.hideExtraLinks()
-    }
-  }
-
-  PrimaryList.prototype = {
-    toggleText: function () {
-      if (this.extraLinks.length > 1) {
-        return '+' + this.extraLinks.length + ' others'
-      } else {
-        return '+' + this.extraLinks.length + ' other'
-      }
-    },
-    addToggleLink: function () {
-      this.toggleLink = document.createElement('a')
-      this.toggleLink.href = '#'
-      this.toggleLink.setAttribute('aria-expanded', 'false')
-      this.toggleLink.innerText = this.toggleText()
-
-      this.el.parentNode.insertBefore(this.toggleLink, this.el.nextSibling)
-      this.toggleLink.addEventListener('click', this.toggleLinks.bind(this))
-    },
-    toggleLinks: function (e) {
-      e.preventDefault()
-      this.toggleLink.remove()
-      this.showExtraLinks()
-    },
-    hideExtraLinks: function () {
-      for (var i = 0; i < this.extraLinks.length; i++) {
-        this.extraLinks[i].className = 'primary-links--display-none'
-      }
-    },
-    showExtraLinks: function () {
-      for (var i = 0; i < this.extraLinks.length; i++) {
-        this.extraLinks[i].className = ''
-      }
-    }
-  }
-
-  GOVUK.PrimaryList = PrimaryList
-
-  GOVUK.primaryLinks = {
-    init: function (selector) {
-      var allListItems = document.querySelectorAll(selector)
-      var AllLists = []
-
-      for (var i = 0; i < allListItems.length; i++) {
-        var parent = allListItems[i].parentNode
-
-        if (AllLists.indexOf(parent) < 0) {
-          AllLists.push(parent)
-        }
-      }
-
-      AllLists.forEach(function (el, i) {
-        new GOVUK.PrimaryList(el, selector) // eslint-disable-line no-new
-      })
-    }
-  }
-
-  global.GOVUK = GOVUK
-})(window)