idsk_frontend_toolkit 7.4.2

data/app/assets/javascripts/govuk/modules.js

@@ -0,0 +1,61 @@
+;(function (global) {
+  'use strict'
+
+  var $ = global.jQuery
+  var GOVUK = global.GOVUK || {}
+  GOVUK.Modules = GOVUK.Modules || {}
+
+  GOVUK.modules = {
+    find: function (container) {
+      container = container || $('body')
+
+      var modules
+      var moduleSelector = '[data-module]'
+
+      modules = container.find(moduleSelector)
+
+      // Container could be a module too
+      if (container.is(moduleSelector)) {
+        modules = modules.add(container)
+      }
+
+      return modules
+    },
+
+    start: function (container) {
+      var modules = this.find(container)
+
+      for (var i = 0, l = modules.length; i < l; i++) {
+        var module
+        var element = $(modules[i])
+        var type = camelCaseAndCapitalise(element.data('module'))
+        var started = element.data('module-started')
+
+        if (typeof GOVUK.Modules[type] === 'function' && !started) {
+          module = new GOVUK.Modules[type]()
+          module.start(element)
+          element.data('module-started', true)
+        }
+      }
+
+      // eg selectable-table to SelectableTable
+      function camelCaseAndCapitalise (string) {
+        return capitaliseFirstLetter(camelCase(string))
+      }
+
+      // http://stackoverflow.com/questions/6660977/convert-hyphens-to-camel-case-camelcase
+      function camelCase (string) {
+        return string.replace(/-([a-z])/g, function (g) {
+          return g.charAt(1).toUpperCase()
+        })
+      }
+
+      // http://stackoverflow.com/questions/1026069/capitalize-the-first-letter-of-string-in-javascript
+      function capitaliseFirstLetter (string) {
+        return string.charAt(0).toUpperCase() + string.slice(1)
+      }
+    }
+  }
+
+  global.GOVUK = GOVUK
+})(window)

data/app/assets/javascripts/govuk/primary-links.js

@@ -0,0 +1,57 @@
+;(function (global) {
+  'use strict'
+
+  var $ = global.jQuery
+  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.find('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 = $('<a href="#">' + this.toggleText() + '</a>')
+      this.$toggleLink.click($.proxy(this.toggleLinks, this))
+      this.$toggleLink.insertAfter(this.$el)
+    },
+    toggleLinks: function (e) {
+      e.preventDefault()
+      this.$toggleLink.remove()
+      this.showExtraLinks()
+    },
+    hideExtraLinks: function () {
+      this.$extraLinks.addClass('visuallyhidden')
+      $(window).trigger('govuk.pageSizeChanged')
+    },
+    showExtraLinks: function () {
+      this.$extraLinks.removeClass('visuallyhidden')
+      $(window).trigger('govuk.pageSizeChanged')
+    }
+  }
+
+  GOVUK.PrimaryList = PrimaryList
+
+  GOVUK.primaryLinks = {
+    init: function (selector) {
+      $(selector).parent().each(function (i, el) {
+        new GOVUK.PrimaryList(el, selector) // eslint-disable-line no-new
+      })
+    }
+  }
+
+  global.GOVUK = GOVUK
+})(window)

data/app/assets/javascripts/govuk/selection-buttons.js

@@ -0,0 +1,116 @@
+// NOTICE
+// IF you are using GOV.UK Elements 3.0,0 or above then you do not need to use
+// this script anymore as it uses a pure CSS solution.
+
+;(function (global) {
+  'use strict'
+
+  var $ = global.jQuery
+  var GOVUK = global.GOVUK || {}
+
+  var SelectionButtons = function (elmsOrSelector, opts) {
+    this.selectedClass = 'selected'
+    this.focusedClass = 'focused'
+    this.radioClass = 'selection-button-radio'
+    this.checkboxClass = 'selection-button-checkbox'
+    if (opts !== undefined) {
+      $.each(opts, function (optionName, optionObj) {
+        this[optionName] = optionObj
+      }.bind(this))
+    }
+    if (typeof elmsOrSelector === 'string') {
+      this.selector = elmsOrSelector
+      this.setInitialState($(this.selector))
+    } else if (elmsOrSelector !== undefined) {
+      this.$elms = elmsOrSelector
+      this.setInitialState(this.$elms)
+    }
+    this.addEvents()
+  }
+  SelectionButtons.prototype.addEvents = function () {
+    if (typeof this.$elms !== 'undefined') {
+      this.addElementLevelEvents()
+    } else {
+      this.addDocumentLevelEvents()
+    }
+  }
+  SelectionButtons.prototype.setInitialState = function ($elms) {
+    $elms.each(function (idx, elm) {
+      var $elm = $(elm)
+
+      var labelClass = $elm.attr('type') === 'radio' ? this.radioClass : this.checkboxClass
+      $elm.parent('label').addClass(labelClass)
+      if ($elm.is(':checked')) {
+        this.markSelected($elm)
+      }
+    }.bind(this))
+  }
+  SelectionButtons.prototype.markFocused = function ($elm, state) {
+    if (state === 'focused') {
+      $elm.parent('label').addClass(this.focusedClass)
+    } else {
+      $elm.parent('label').removeClass(this.focusedClass)
+    }
+  }
+  SelectionButtons.prototype.markSelected = function ($elm) {
+    var radioName
+
+    if ($elm.attr('type') === 'radio') {
+      radioName = $elm.attr('name')
+      $($elm[0].form).find('input[name="' + radioName + '"]')
+        .parent('label')
+        .removeClass(this.selectedClass)
+      $elm.parent('label').addClass(this.selectedClass)
+    } else { // checkbox
+      if ($elm.is(':checked')) {
+        $elm.parent('label').addClass(this.selectedClass)
+      } else {
+        $elm.parent('label').removeClass(this.selectedClass)
+      }
+    }
+  }
+  SelectionButtons.prototype.addElementLevelEvents = function () {
+    this.clickHandler = this.getClickHandler()
+    this.focusHandler = this.getFocusHandler({ 'level': 'element' })
+
+    this.$elms
+      .on('click', this.clickHandler)
+      .on('focus blur', this.focusHandler)
+  }
+  SelectionButtons.prototype.addDocumentLevelEvents = function () {
+    this.clickHandler = this.getClickHandler()
+    this.focusHandler = this.getFocusHandler({ 'level': 'document' })
+
+    $(document)
+      .on('click', this.selector, this.clickHandler)
+      .on('focus blur', this.selector, this.focusHandler)
+  }
+  SelectionButtons.prototype.getClickHandler = function () {
+    return function (e) {
+      this.markSelected($(e.target))
+    }.bind(this)
+  }
+  SelectionButtons.prototype.getFocusHandler = function (opts) {
+    var focusEvent = (opts.level === 'document') ? 'focusin' : 'focus'
+
+    return function (e) {
+      var state = (e.type === focusEvent) ? 'focused' : 'blurred'
+
+      this.markFocused($(e.target), state)
+    }.bind(this)
+  }
+  SelectionButtons.prototype.destroy = function () {
+    if (typeof this.selector !== 'undefined') {
+      $(document)
+        .off('click', this.selector, this.clickHandler)
+        .off('focus blur', this.selector, this.focusHandler)
+    } else {
+      this.$elms
+        .off('click', this.clickHandler)
+        .off('focus blur', this.focusHandler)
+    }
+  }
+
+  GOVUK.SelectionButtons = SelectionButtons
+  global.GOVUK = GOVUK
+})(window)

data/app/assets/javascripts/govuk/shim-links-with-button-role.js

@@ -0,0 +1,34 @@
+// javascript 'shim' to trigger the click event of element(s)
+// when the space key is pressed.
+//
+// Created since some Assistive Technologies (for example some Screenreaders)
+// Will tell a user to press space on a 'button', so this functionality needs to be shimmed
+// See https://github.com/alphagov/govuk_elements/pull/272#issuecomment-233028270
+//
+// Usage instructions:
+// GOVUK.shimLinksWithButtonRole.init();
+;(function (global) {
+  'use strict'
+
+  var $ = global.jQuery
+  var GOVUK = global.GOVUK || {}
+
+  GOVUK.shimLinksWithButtonRole = {
+
+    init: function init () {
+      // listen to 'document' for keydown event on the any elements that should be buttons.
+      $(document).on('keydown', '[role="button"]', function (event) {
+        // if the keyCode (which) is 32 it's a space, let's simulate a click.
+        if (event.which === 32) {
+          event.preventDefault()
+          // trigger the target's click event
+          event.target.click()
+        }
+      })
+    }
+
+  }
+
+  // hand back to global
+  global.GOVUK = GOVUK
+})(window)

data/app/assets/javascripts/govuk/show-hide-content.js

@@ -0,0 +1,172 @@
+;(function (global) {
+  'use strict'
+
+  var $ = global.jQuery
+  var GOVUK = global.GOVUK || {}
+
+  function ShowHideContent () {
+    var self = this
+
+    // Radio and Checkbox selectors
+    var selectors = {
+      namespace: 'ShowHideContent',
+      radio: '[data-target] > input[type="radio"]',
+      checkbox: '[data-target] > input[type="checkbox"]'
+    }
+
+    // Escape name attribute for use in DOM selector
+    function escapeElementName (str) {
+      var result = str.replace('[', '\\[').replace(']', '\\]')
+      return result
+    }
+
+    // Adds ARIA attributes to control + associated content
+    function initToggledContent () {
+      var $control = $(this)
+      var $content = getToggledContent($control)
+
+      // Set aria-controls and defaults
+      if ($content.length) {
+        $control.attr('aria-controls', $content.attr('id'))
+        $control.attr('aria-expanded', 'false')
+        $content.attr('aria-hidden', 'true')
+      }
+    }
+
+    // Return toggled content for control
+    function getToggledContent ($control) {
+      var id = $control.attr('aria-controls')
+
+      // ARIA attributes aren't set before init
+      if (!id) {
+        id = $control.closest('[data-target]').data('target')
+      }
+
+      // Find show/hide content by id
+      return $('#' + id)
+    }
+
+    // Show toggled content for control
+    function showToggledContent ($control, $content) {
+      // Show content
+      if ($content.hasClass('js-hidden')) {
+        $content.removeClass('js-hidden')
+        $content.attr('aria-hidden', 'false')
+
+        // If the controlling input, update aria-expanded
+        if ($control.attr('aria-controls')) {
+          $control.attr('aria-expanded', 'true')
+        }
+      }
+    }
+
+    // Hide toggled content for control
+    function hideToggledContent ($control, $content) {
+      $content = $content || getToggledContent($control)
+
+      // Hide content
+      if (!$content.hasClass('js-hidden')) {
+        $content.addClass('js-hidden')
+        $content.attr('aria-hidden', 'true')
+
+        // If the controlling input, update aria-expanded
+        if ($control.attr('aria-controls')) {
+          $control.attr('aria-expanded', 'false')
+        }
+      }
+    }
+
+    // Handle radio show/hide
+    function handleRadioContent ($control, $content) {
+      // All radios in this group which control content
+      var selector = selectors.radio + '[name=' + escapeElementName($control.attr('name')) + '][aria-controls]'
+      var $form = $control.closest('form')
+      var $radios = $form.length ? $form.find(selector) : $(selector)
+
+      // Hide content for radios in group
+      $radios.each(function () {
+        hideToggledContent($(this))
+      })
+
+      // Select content for this control
+      if ($control.is('[aria-controls]')) {
+        showToggledContent($control, $content)
+      }
+    }
+
+    // Handle checkbox show/hide
+    function handleCheckboxContent ($control, $content) {
+      // Show checkbox content
+      if ($control.is(':checked')) {
+        showToggledContent($control, $content)
+      } else { // Hide checkbox content
+        hideToggledContent($control, $content)
+      }
+    }
+
+    // Set up event handlers etc
+    function init ($container, elementSelector, eventSelectors, handler) {
+      $container = $container || $(document.body)
+
+      // Handle control clicks
+      function deferred () {
+        var $control = $(this)
+        handler($control, getToggledContent($control))
+      }
+
+      // Prepare ARIA attributes
+      var $controls = $(elementSelector)
+      $controls.each(initToggledContent)
+
+      // Handle events
+      $.each(eventSelectors, function (idx, eventSelector) {
+        $container.on('click.' + selectors.namespace, eventSelector, deferred)
+      })
+
+      // Any already :checked on init?
+      if ($controls.is(':checked')) {
+        $controls.filter(':checked').each(deferred)
+      }
+    }
+
+    // Get event selectors for all radio groups
+    function getEventSelectorsForRadioGroups () {
+      var radioGroups = []
+
+      // Build an array of radio group selectors
+      return $(selectors.radio).map(function () {
+        var groupName = $(this).attr('name')
+
+        if ($.inArray(groupName, radioGroups) === -1) {
+          radioGroups.push(groupName)
+          return 'input[type="radio"][name="' + $(this).attr('name') + '"]'
+        }
+        return null
+      })
+    }
+
+    // Set up radio show/hide content for container
+    self.showHideRadioToggledContent = function ($container) {
+      init($container, selectors.radio, getEventSelectorsForRadioGroups(), handleRadioContent)
+    }
+
+    // Set up checkbox show/hide content for container
+    self.showHideCheckboxToggledContent = function ($container) {
+      init($container, selectors.checkbox, [selectors.checkbox], handleCheckboxContent)
+    }
+
+    // Remove event handlers
+    self.destroy = function ($container) {
+      $container = $container || $(document.body)
+      $container.off('.' + selectors.namespace)
+    }
+  }
+
+  ShowHideContent.prototype.init = function ($container) {
+    this.showHideRadioToggledContent($container)
+    this.showHideCheckboxToggledContent($container)
+  }
+
+  GOVUK.ShowHideContent = ShowHideContent
+  global.GOVUK = GOVUK
+})(window)

data/app/assets/javascripts/govuk/stick-at-top-when-scrolling.js

@@ -0,0 +1,128 @@
+;(function (global) {
+  'use strict'
+
+  var $ = global.jQuery
+  var GOVUK = global.GOVUK || {}
+
+  // Stick elements to top of screen when you scroll past, documentation is in the README.md
+  var sticky = {
+    _hasScrolled: false,
+    _scrollTimeout: false,
+    _hasResized: false,
+    _resizeTimeout: false,
+
+    getWindowDimensions: function () {
+      return {
+        height: $(global).height(),
+        width: $(global).width()
+      }
+    },
+    getWindowPositions: function () {
+      return {
+        scrollTop: $(global).scrollTop()
+      }
+    },
+    getElementOffset: function ($el) {
+      return $el.offset()
+    },
+    init: function () {
+      var $els = $('.js-stick-at-top-when-scrolling')
+
+      if ($els.length > 0) {
+        sticky.$els = $els
+
+        if (sticky._scrollTimeout === false) {
+          $(global).scroll(sticky.onScroll)
+          sticky._scrollTimeout = global.setInterval(sticky.checkScroll, 50)
+        }
+
+        if (sticky._resizeTimeout === false) {
+          $(global).resize(sticky.onResize)
+          sticky._resizeTimeout = global.setInterval(sticky.checkResize, 50)
+        }
+      }
+      if (GOVUK.stopScrollingAtFooter) {
+        $els.each(function (i, el) {
+          var $img = $(el).find('img')
+          if ($img.length > 0) {
+            var image = new global.Image()
+            image.onload = function () {
+              GOVUK.stopScrollingAtFooter.addEl($(el), $(el).outerHeight())
+            }
+            image.src = $img.attr('src')
+          } else {
+            GOVUK.stopScrollingAtFooter.addEl($(el), $(el).outerHeight())
+          }
+        })
+      }
+    },
+    onScroll: function () {
+      sticky._hasScrolled = true
+    },
+    onResize: function () {
+      sticky._hasResized = true
+    },
+    checkScroll: function () {
+      if (sticky._hasScrolled === true) {
+        sticky._hasScrolled = false
+
+        var windowVerticalPosition = sticky.getWindowPositions().scrollTop
+
+        var windowDimensions = sticky.getWindowDimensions()
+
+        sticky.$els.each(function (i, el) {
+          var $el = $(el)
+          var scrolledFrom = $el.data('scrolled-from')
+
+          if (scrolledFrom && windowVerticalPosition < scrolledFrom) {
+            sticky.release($el)
+          } else if (windowDimensions.width > 768 && windowVerticalPosition >= sticky.getElementOffset($el).top) {
+            sticky.stick($el)
+          }
+        })
+      }
+    },
+    checkResize: function () {
+      if (sticky._hasResized === true) {
+        sticky._hasResized = false
+
+        var windowDimensions = sticky.getWindowDimensions()
+
+        sticky.$els.each(function (i, el) {
+          var $el = $(el)
+
+          var elResize = $el.hasClass('js-sticky-resize')
+          if (elResize) {
+            var $shim = $('.shim')
+            var $elParent = $el.parent('div')
+            var elParentWidth = $elParent.width()
+            $shim.css('width', elParentWidth)
+            $el.css('width', elParentWidth)
+          }
+
+          if (windowDimensions.width <= 768) {
+            sticky.release($el)
+          }
+        })
+      }
+    },
+    stick: function ($el) {
+      if (!$el.hasClass('content-fixed')) {
+        $el.data('scrolled-from', sticky.getElementOffset($el).top)
+        var height = Math.max($el.height(), 1)
+        var width = $el.width()
+        $el.before('<div class="shim" style="width: ' + width + 'px; height: ' + height + 'px">&nbsp;</div>')
+        $el.css('width', width + 'px').addClass('content-fixed')
+      }
+    },
+    release: function ($el) {
+      if ($el.hasClass('content-fixed')) {
+        $el.data('scrolled-from', false)
+        $el.removeClass('content-fixed').css('width', '')
+        $el.siblings('.shim').remove()
+      }
+    }
+  }
+  GOVUK.stickAtTopWhenScrolling = sticky
+  global.GOVUK = GOVUK
+})(window)