govuk_publishing_components 29.9.0 → 29.10.0

data/node_modules/govuk-frontend/govuk/objects/_button-group.scss

@@ -29,19 +29,12 @@
     // margins, but unfortunately the support isn't there (yet) and @supports
     // doesn't play nicely with it
     // (https://github.com/w3c/csswg-drafts/issues/3559)
-    display: -webkit-box;
-    display: -webkit-flex;
     display: -ms-flexbox;
     display: flex;
-    -webkit-box-orient: vertical;
-    -webkit-box-direction: normal;
-    -webkit-flex-direction: column;
-        -ms-flex-direction: column;
-            flex-direction: column;
-    -webkit-box-align: center;
-    -webkit-align-items: center;
-        -ms-flex-align: center;
-            align-items: center;
+    -ms-flex-direction: column;
+        flex-direction: column;
+    -ms-flex-align: center;
+        align-items: center;
 
     // Give links within the button group the same font-size and line-height
     // as buttons.
@@ -71,22 +64,13 @@
       // Cancel out the column gap for the last item in each row
       margin-right: ($horizontal-gap * -1);
 
-      -webkit-box-orient: horizontal;
+      -ms-flex-direction: row;
 
-      -webkit-box-direction: normal;
-
-      -webkit-flex-direction: row;
-
-          -ms-flex-direction: row;
-
-              flex-direction: row;
-      -webkit-flex-wrap: wrap;
-          -ms-flex-wrap: wrap;
-              flex-wrap: wrap;
-      -webkit-box-align: baseline;
-      -webkit-align-items: baseline;
-          -ms-flex-align: baseline;
-              align-items: baseline;
+          flex-direction: row;
+      -ms-flex-wrap: wrap;
+          flex-wrap: wrap;
+      -ms-flex-align: baseline;
+          align-items: baseline;
 
       .govuk-button,
       .govuk-link {

data/node_modules/govuk-frontend/govuk/objects/_template.scss

@@ -11,7 +11,7 @@
     // Prevent automatic text sizing, as we already cater for small devices and
     // would like the browser to stay on 100% text zoom by default.
     -webkit-text-size-adjust: 100%;
-        -ms-text-size-adjust: 100%;
+       -moz-text-size-adjust: 100%;
             text-size-adjust: 100%;
 
     // Force the scrollbar to always display in IE, to prevent horizontal page

data/node_modules/govuk-frontend/govuk/objects/_width-container.scss

@@ -28,9 +28,7 @@
 
   // Respect 'display cutout' safe area (avoids notches and rounded corners)
   @supports (margin: unquote("max(calc(0px))")) {
-    $gutter-safe-area-right: -webkit-calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
     $gutter-safe-area-right: calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
-    $gutter-safe-area-left: -webkit-calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
     $gutter-safe-area-left: calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
 
     // Use max() to pick largest margin, default or with safe area
@@ -46,9 +44,7 @@
 
     // Respect 'display cutout' safe area (avoids notches and rounded corners)
     @supports (margin: unquote("max(calc(0px))")) {
-      $gutter-safe-area-right: -webkit-calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
       $gutter-safe-area-right: calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
-      $gutter-safe-area-left: -webkit-calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
       $gutter-safe-area-left: calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
 
       // Use max() to pick largest margin, default or with safe area

data/node_modules/govuk-frontend/govuk/tools/_exports.scss

@@ -22,7 +22,7 @@ $_govuk-imported-modules: () !default;
 
 @mixin govuk-exports($name) {
   // If the mixin is not in the list of modules already exported...
-  @if (index($_govuk-imported-modules, $name) == null) {
+  @if not index($_govuk-imported-modules, $name) {
     // ... then add it to the list
     $_govuk-imported-modules: append($_govuk-imported-modules, $name) !global;
     // ... and output the CSS for that module

data/node_modules/govuk-frontend/govuk/tools/_font-url.scss

@@ -17,7 +17,7 @@
     and $govuk-font-url-function
     and function-exists($govuk-font-url-function);
 
-  @if ($use-custom-function) {
+  @if $use-custom-function {
     @return call(get-function($govuk-font-url-function), $filename);
   } @else {
     @return url($govuk-fonts-path + $filename);

data/node_modules/govuk-frontend/govuk/tools/_image-url.scss

@@ -17,7 +17,7 @@
     and $govuk-image-url-function
     and function-exists($govuk-image-url-function);
 
-  @if ($use-custom-function) {
+  @if $use-custom-function {
     @return call(get-function($govuk-image-url-function), $filename);
   } @else {
     @return url($govuk-images-path + $filename);

data/node_modules/govuk-frontend/govuk/tools/_px-to-em.scss

@@ -10,10 +10,10 @@
 /// @access public
 
 @function govuk-em($value, $context-font-size) {
-  @if (unitless($value)) {
+  @if unitless($value) {
     $value: $value * 1px;
   }
-  @if (unitless($context-font-size)) {
+  @if unitless($context-font-size) {
     $context-font-size: $context-font-size * 1px;
   }
   @return $value / $context-font-size * 1em;

data/node_modules/govuk-frontend/govuk/tools/_px-to-rem.scss

@@ -12,7 +12,7 @@
 /// @access public
 
 @function govuk-px-to-rem($value) {
-  @if (unitless($value)) {
+  @if unitless($value) {
     $value: $value * 1px;
   }
 

data/node_modules/govuk-frontend/govuk-esm/all.mjs

@@ -0,0 +1,88 @@
+import { nodeListForEach } from './common'
+import Accordion from './components/accordion/accordion'
+import Button from './components/button/button'
+import Details from './components/details/details'
+import CharacterCount from './components/character-count/character-count'
+import Checkboxes from './components/checkboxes/checkboxes'
+import ErrorSummary from './components/error-summary/error-summary'
+import NotificationBanner from './components/notification-banner/notification-banner'
+import Header from './components/header/header'
+import Radios from './components/radios/radios'
+import SkipLink from './components/skip-link/skip-link'
+import Tabs from './components/tabs/tabs'
+
+function initAll (options) {
+  // Set the options to an empty object by default if no options are passed.
+  options = typeof options !== 'undefined' ? options : {}
+
+  // Allow the user to initialise GOV.UK Frontend in only certain sections of the page
+  // Defaults to the entire document if nothing is set.
+  var scope = typeof options.scope !== 'undefined' ? options.scope : document
+
+  var $buttons = scope.querySelectorAll('[data-module="govuk-button"]')
+  nodeListForEach($buttons, function ($button) {
+    new Button($button).init()
+  })
+
+  var $accordions = scope.querySelectorAll('[data-module="govuk-accordion"]')
+  nodeListForEach($accordions, function ($accordion) {
+    new Accordion($accordion).init()
+  })
+
+  var $details = scope.querySelectorAll('[data-module="govuk-details"]')
+  nodeListForEach($details, function ($detail) {
+    new Details($detail).init()
+  })
+
+  var $characterCounts = scope.querySelectorAll('[data-module="govuk-character-count"]')
+  nodeListForEach($characterCounts, function ($characterCount) {
+    new CharacterCount($characterCount).init()
+  })
+
+  var $checkboxes = scope.querySelectorAll('[data-module="govuk-checkboxes"]')
+  nodeListForEach($checkboxes, function ($checkbox) {
+    new Checkboxes($checkbox).init()
+  })
+
+  // Find first error summary module to enhance.
+  var $errorSummary = scope.querySelector('[data-module="govuk-error-summary"]')
+  new ErrorSummary($errorSummary).init()
+
+  // Find first header module to enhance.
+  var $toggleButton = scope.querySelector('[data-module="govuk-header"]')
+  new Header($toggleButton).init()
+
+  var $notificationBanners = scope.querySelectorAll('[data-module="govuk-notification-banner"]')
+  nodeListForEach($notificationBanners, function ($notificationBanner) {
+    new NotificationBanner($notificationBanner).init()
+  })
+
+  var $radios = scope.querySelectorAll('[data-module="govuk-radios"]')
+  nodeListForEach($radios, function ($radio) {
+    new Radios($radio).init()
+  })
+
+  // Find first skip link module to enhance.
+  var $skipLink = scope.querySelector('[data-module="govuk-skip-link"]')
+  new SkipLink($skipLink).init()
+
+  var $tabs = scope.querySelectorAll('[data-module="govuk-tabs"]')
+  nodeListForEach($tabs, function ($tabs) {
+    new Tabs($tabs).init()
+  })
+}
+
+export {
+  initAll,
+  Accordion,
+  Button,
+  Details,
+  CharacterCount,
+  Checkboxes,
+  ErrorSummary,
+  Header,
+  NotificationBanner,
+  Radios,
+  SkipLink,
+  Tabs
+}

data/node_modules/govuk-frontend/govuk-esm/common.mjs

@@ -0,0 +1,28 @@
+/**
+ * TODO: Ideally this would be a NodeList.prototype.forEach polyfill
+ * This seems to fail in IE8, requires more investigation.
+ * See: https://github.com/imagitama/nodelist-foreach-polyfill
+ */
+export function nodeListForEach (nodes, callback) {
+  if (window.NodeList.prototype.forEach) {
+    return nodes.forEach(callback)
+  }
+  for (var i = 0; i < nodes.length; i++) {
+    callback.call(window, nodes[i], i, nodes)
+  }
+}
+
+// Used to generate a unique string, allows multiple instances of the component without
+// Them conflicting with each other.
+// https://stackoverflow.com/a/8809472
+export function generateUniqueID () {
+  var d = new Date().getTime()
+  if (typeof window.performance !== 'undefined' && typeof window.performance.now === 'function') {
+    d += window.performance.now() // use high-precision timer if available
+  }
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+    var r = (d + Math.random() * 16) % 16 | 0
+    d = Math.floor(d / 16)
+    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16)
+  })
+}

data/node_modules/govuk-frontend/govuk-esm/components/accordion/accordion.mjs

@@ -0,0 +1,374 @@
+
+/*
+  Accordion
+
+  This allows a collection of sections to be collapsed by default,
+  showing only their headers. Sections can be expanded or collapsed
+  individually by clicking their headers. An "Show all sections" button is
+  also added to the top of the accordion, which switches to "Hide all sections"
+  when all the sections are expanded.
+
+  The state of each section is saved to the DOM via the `aria-expanded`
+  attribute, which also provides accessibility.
+
+  A Chevron icon has been added for extra affordance that this is an interactive element.
+
+*/
+
+import { nodeListForEach } from '../../common'
+import '../../vendor/polyfills/Function/prototype/bind'
+import '../../vendor/polyfills/Element/prototype/classList'
+
+function Accordion ($module) {
+  this.$module = $module
+  this.moduleId = $module.getAttribute('id')
+  this.$sections = $module.querySelectorAll('.govuk-accordion__section')
+  this.$showAllButton = ''
+  this.browserSupportsSessionStorage = helper.checkForSessionStorage()
+
+  this.controlsClass = 'govuk-accordion__controls'
+  this.showAllClass = 'govuk-accordion__show-all'
+  this.showAllTextClass = 'govuk-accordion__show-all-text'
+
+  this.sectionExpandedClass = 'govuk-accordion__section--expanded'
+  this.sectionButtonClass = 'govuk-accordion__section-button'
+  this.sectionHeaderClass = 'govuk-accordion__section-header'
+  this.sectionHeadingClass = 'govuk-accordion__section-heading'
+  this.sectionHeadingTextClass = 'govuk-accordion__section-heading-text'
+  this.sectionHeadingTextFocusClass = 'govuk-accordion__section-heading-text-focus'
+
+  this.sectionShowHideToggleClass = 'govuk-accordion__section-toggle'
+  this.sectionShowHideToggleFocusClass = 'govuk-accordion__section-toggle-focus'
+  this.sectionShowHideTextClass = 'govuk-accordion__section-toggle-text'
+  this.upChevronIconClass = 'govuk-accordion-nav__chevron'
+  this.downChevronIconClass = 'govuk-accordion-nav__chevron--down'
+
+  this.sectionSummaryClass = 'govuk-accordion__section-summary'
+  this.sectionSummaryFocusClass = 'govuk-accordion__section-summary-focus'
+}
+
+// Initialize component
+Accordion.prototype.init = function () {
+  // Check for module
+  if (!this.$module) {
+    return
+  }
+
+  this.initControls()
+  this.initSectionHeaders()
+
+  // See if "Show all sections" button text should be updated
+  var areAllSectionsOpen = this.checkIfAllSectionsOpen()
+  this.updateShowAllButton(areAllSectionsOpen)
+}
+
+// Initialise controls and set attributes
+Accordion.prototype.initControls = function () {
+  // Create "Show all" button and set attributes
+  this.$showAllButton = document.createElement('button')
+  this.$showAllButton.setAttribute('type', 'button')
+  this.$showAllButton.setAttribute('class', this.showAllClass)
+  this.$showAllButton.setAttribute('aria-expanded', 'false')
+
+  // Create icon, add to element
+  var $icon = document.createElement('span')
+  $icon.classList.add(this.upChevronIconClass)
+  this.$showAllButton.appendChild($icon)
+
+  // Create control wrapper and add controls to it
+  var $accordionControls = document.createElement('div')
+  $accordionControls.setAttribute('class', this.controlsClass)
+  $accordionControls.appendChild(this.$showAllButton)
+  this.$module.insertBefore($accordionControls, this.$module.firstChild)
+
+  // Build additional wrapper for Show all toggle text and place after icon
+  var $wrappershowAllText = document.createElement('span')
+  $wrappershowAllText.classList.add(this.showAllTextClass)
+  this.$showAllButton.appendChild($wrappershowAllText)
+
+  // Handle click events on the show/hide all button
+  this.$showAllButton.addEventListener('click', this.onShowOrHideAllToggle.bind(this))
+}
+
+// Initialise section headers
+Accordion.prototype.initSectionHeaders = function () {
+  // Loop through section headers
+  nodeListForEach(this.$sections, function ($section, i) {
+    // Set header attributes
+    var $header = $section.querySelector('.' + this.sectionHeaderClass)
+    this.constructHeaderMarkup($header, i)
+    this.setExpanded(this.isExpanded($section), $section)
+
+    // Handle events
+    $header.addEventListener('click', this.onSectionToggle.bind(this, $section))
+
+    // See if there is any state stored in sessionStorage and set the sections to
+    // open or closed.
+    this.setInitialState($section)
+  }.bind(this))
+}
+
+Accordion.prototype.constructHeaderMarkup = function ($headerWrapper, index) {
+  var $span = $headerWrapper.querySelector('.' + this.sectionButtonClass)
+  var $heading = $headerWrapper.querySelector('.' + this.sectionHeadingClass)
+  var $summary = $headerWrapper.querySelector('.' + this.sectionSummaryClass)
+
+  // Create a button element that will replace the '.govuk-accordion__section-button' span
+  var $button = document.createElement('button')
+  $button.setAttribute('type', 'button')
+  $button.setAttribute('aria-controls', this.moduleId + '-content-' + (index + 1))
+
+  // Copy all attributes (https://developer.mozilla.org/en-US/docs/Web/API/Element/attributes) from $span to $button
+  for (var i = 0; i < $span.attributes.length; i++) {
+    var attr = $span.attributes.item(i)
+    // Add all attributes but not ID as this is being added to
+    // the section heading ($headingText)
+    if (attr.nodeName !== 'id') {
+      $button.setAttribute(attr.nodeName, attr.nodeValue)
+    }
+  }
+
+  // Create container for heading text so it can be styled
+  var $headingText = document.createElement('span')
+  $headingText.classList.add(this.sectionHeadingTextClass)
+  // Copy the span ID to the heading text to allow it to be referenced by `aria-labelledby` on the
+  // hidden content area without "Show this section"
+  $headingText.id = $span.id
+
+  // Create an inner heading text container to limit the width of the focus state
+  var $headingTextFocus = document.createElement('span')
+  $headingTextFocus.classList.add(this.sectionHeadingTextFocusClass)
+  $headingText.appendChild($headingTextFocus)
+  // span could contain HTML elements (see https://www.w3.org/TR/2011/WD-html5-20110525/content-models.html#phrasing-content)
+  $headingTextFocus.innerHTML = $span.innerHTML
+
+  // Create container for show / hide icons and text.
+  var $showToggle = document.createElement('span')
+  $showToggle.classList.add(this.sectionShowHideToggleClass)
+  // Tell Google not to index the 'show' text as part of the heading
+  // For the snippet to work with JavaScript, it must be added before adding the page element to the
+  // page's DOM. See https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#data-nosnippet-attr
+  $showToggle.setAttribute('data-nosnippet', '')
+  // Create an inner container to limit the width of the focus state
+  var $showToggleFocus = document.createElement('span')
+  $showToggleFocus.classList.add(this.sectionShowHideToggleFocusClass)
+  $showToggle.appendChild($showToggleFocus)
+  // Create wrapper for the show / hide text. Append text after the show/hide icon
+  var $showToggleText = document.createElement('span')
+  var $icon = document.createElement('span')
+  $icon.classList.add(this.upChevronIconClass)
+  $showToggleFocus.appendChild($icon)
+  $showToggleText.classList.add(this.sectionShowHideTextClass)
+  $showToggleFocus.appendChild($showToggleText)
+
+  // Append elements to the button:
+  // 1. Heading text
+  // 2. Punctuation
+  // 3. (Optional: Summary line followed by punctuation)
+  // 4. Show / hide toggle
+  $button.appendChild($headingText)
+  $button.appendChild(this.getButtonPunctuationEl())
+
+  // If summary content exists add to DOM in correct order
+  if (typeof ($summary) !== 'undefined' && $summary !== null) {
+    // Create a new `span` element and copy the summary line content from the original `div` to the
+    // new `span`
+    // This is because the summary line text is now inside a button element, which can only contain
+    // phrasing content
+    var $summarySpan = document.createElement('span')
+    // Create an inner summary container to limit the width of the summary focus state
+    var $summarySpanFocus = document.createElement('span')
+    $summarySpanFocus.classList.add(this.sectionSummaryFocusClass)
+    $summarySpan.appendChild($summarySpanFocus)
+
+    // Get original attributes, and pass them to the replacement
+    for (var j = 0, l = $summary.attributes.length; j < l; ++j) {
+      var nodeName = $summary.attributes.item(j).nodeName
+      var nodeValue = $summary.attributes.item(j).nodeValue
+      $summarySpan.setAttribute(nodeName, nodeValue)
+    }
+
+    // Copy original contents of summary to the new summary span
+    $summarySpanFocus.innerHTML = $summary.innerHTML
+
+    // Replace the original summary `div` with the new summary `span`
+    $summary.parentNode.replaceChild($summarySpan, $summary)
+
+    $button.appendChild($summarySpan)
+    $button.appendChild(this.getButtonPunctuationEl())
+  }
+
+  $button.appendChild($showToggle)
+
+  $heading.removeChild($span)
+  $heading.appendChild($button)
+}
+
+// When section toggled, set and store state
+Accordion.prototype.onSectionToggle = function ($section) {
+  var expanded = this.isExpanded($section)
+  this.setExpanded(!expanded, $section)
+
+  // Store the state in sessionStorage when a change is triggered
+  this.storeState($section)
+}
+
+// When Open/Close All toggled, set and store state
+Accordion.prototype.onShowOrHideAllToggle = function () {
+  var $module = this
+  var $sections = this.$sections
+  var nowExpanded = !this.checkIfAllSectionsOpen()
+
+  nodeListForEach($sections, function ($section) {
+    $module.setExpanded(nowExpanded, $section)
+    // Store the state in sessionStorage when a change is triggered
+    $module.storeState($section)
+  })
+
+  $module.updateShowAllButton(nowExpanded)
+}
+
+// Set section attributes when opened/closed
+Accordion.prototype.setExpanded = function (expanded, $section) {
+  var $icon = $section.querySelector('.' + this.upChevronIconClass)
+  var $showHideText = $section.querySelector('.' + this.sectionShowHideTextClass)
+  var $button = $section.querySelector('.' + this.sectionButtonClass)
+  var $newButtonText = expanded ? 'Hide' : 'Show'
+
+  // Build additional copy of "this section" for assistive technology and place inside toggle link
+  var $visuallyHiddenText = document.createElement('span')
+  $visuallyHiddenText.classList.add('govuk-visually-hidden')
+  $visuallyHiddenText.innerHTML = ' this section'
+
+  $showHideText.innerHTML = $newButtonText
+  $showHideText.appendChild($visuallyHiddenText)
+  $button.setAttribute('aria-expanded', expanded)
+
+  // Swap icon, change class
+  if (expanded) {
+    $section.classList.add(this.sectionExpandedClass)
+    $icon.classList.remove(this.downChevronIconClass)
+  } else {
+    $section.classList.remove(this.sectionExpandedClass)
+    $icon.classList.add(this.downChevronIconClass)
+  }
+
+  // See if "Show all sections" button text should be updated
+  var areAllSectionsOpen = this.checkIfAllSectionsOpen()
+  this.updateShowAllButton(areAllSectionsOpen)
+}
+
+// Get state of section
+Accordion.prototype.isExpanded = function ($section) {
+  return $section.classList.contains(this.sectionExpandedClass)
+}
+
+// Check if all sections are open
+Accordion.prototype.checkIfAllSectionsOpen = function () {
+  // Get a count of all the Accordion sections
+  var sectionsCount = this.$sections.length
+  // Get a count of all Accordion sections that are expanded
+  var expandedSectionCount = this.$module.querySelectorAll('.' + this.sectionExpandedClass).length
+  var areAllSectionsOpen = sectionsCount === expandedSectionCount
+
+  return areAllSectionsOpen
+}
+
+// Update "Show all sections" button
+Accordion.prototype.updateShowAllButton = function (expanded) {
+  var $showAllIcon = this.$showAllButton.querySelector('.' + this.upChevronIconClass)
+  var $showAllText = this.$showAllButton.querySelector('.' + this.showAllTextClass)
+  var newButtonText = expanded ? 'Hide all sections' : 'Show all sections'
+  this.$showAllButton.setAttribute('aria-expanded', expanded)
+  $showAllText.innerHTML = newButtonText
+
+  // Swap icon, toggle class
+  if (expanded) {
+    $showAllIcon.classList.remove(this.downChevronIconClass)
+  } else {
+    $showAllIcon.classList.add(this.downChevronIconClass)
+  }
+}
+
+// Check for `window.sessionStorage`, and that it actually works.
+var helper = {
+  checkForSessionStorage: function () {
+    var testString = 'this is the test string'
+    var result
+    try {
+      window.sessionStorage.setItem(testString, testString)
+      result = window.sessionStorage.getItem(testString) === testString.toString()
+      window.sessionStorage.removeItem(testString)
+      return result
+    } catch (exception) {
+      if ((typeof console === 'undefined' || typeof console.log === 'undefined')) {
+        console.log('Notice: sessionStorage not available.')
+      }
+    }
+  }
+}
+
+// Set the state of the accordions in sessionStorage
+Accordion.prototype.storeState = function ($section) {
+  if (this.browserSupportsSessionStorage) {
+    // We need a unique way of identifying each content in the Accordion. Since
+    // an `#id` should be unique and an `id` is required for `aria-` attributes
+    // `id` can be safely used.
+    var $button = $section.querySelector('.' + this.sectionButtonClass)
+
+    if ($button) {
+      var contentId = $button.getAttribute('aria-controls')
+      var contentState = $button.getAttribute('aria-expanded')
+
+      if (typeof contentId === 'undefined' && (typeof console === 'undefined' || typeof console.log === 'undefined')) {
+        console.error(new Error('No aria controls present in accordion section heading.'))
+      }
+
+      if (typeof contentState === 'undefined' && (typeof console === 'undefined' || typeof console.log === 'undefined')) {
+        console.error(new Error('No aria expanded present in accordion section heading.'))
+      }
+
+      // Only set the state when both `contentId` and `contentState` are taken from the DOM.
+      if (contentId && contentState) {
+        window.sessionStorage.setItem(contentId, contentState)
+      }
+    }
+  }
+}
+
+// Read the state of the accordions from sessionStorage
+Accordion.prototype.setInitialState = function ($section) {
+  if (this.browserSupportsSessionStorage) {
+    var $button = $section.querySelector('.' + this.sectionButtonClass)
+
+    if ($button) {
+      var contentId = $button.getAttribute('aria-controls')
+      var contentState = contentId ? window.sessionStorage.getItem(contentId) : null
+
+      if (contentState !== null) {
+        this.setExpanded(contentState === 'true', $section)
+      }
+    }
+  }
+}
+
+/**
+* Create an element to improve semantics of the section button with punctuation
+* @return {object} DOM element
+*
+* Used to add pause (with a comma) for assistive technology.
+* Example: [heading]Section A ,[pause] Show this section.
+* https://accessibility.blog.gov.uk/2017/12/18/what-working-on-gov-uk-navigation-taught-us-about-accessibility/
+*
+* Adding punctuation to the button can also improve its general semantics by dividing its contents
+* into thematic chunks.
+* See https://github.com/alphagov/govuk-frontend/issues/2327#issuecomment-922957442
+*/
+Accordion.prototype.getButtonPunctuationEl = function () {
+  var $punctuationEl = document.createElement('span')
+  $punctuationEl.classList.add('govuk-visually-hidden', 'govuk-accordion__section-heading-divider')
+  $punctuationEl.innerHTML = ', '
+  return $punctuationEl
+}
+
+export default Accordion