govuk_publishing_components 35.3.2 → 35.3.4

data/node_modules/govuk-frontend/govuk/components/select/fixtures.json

@@ -27,7 +27,7 @@
                 ]
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n\n\n  <select class=\"govuk-select\" id=\"select-1\" name=\"select-1\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n    \n  \n    \n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n  <select class=\"govuk-select\" id=\"select-1\" name=\"select-1\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n  </select>\n</div>"
         },
         {
             "name": "with no items",
@@ -40,7 +40,7 @@
                 "items": []
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Horse with no name\n  </label>\n\n\n  <select class=\"govuk-select\" id=\"select-1\" name=\"select-1\">\n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Horse with no name\n  </label>\n  <select class=\"govuk-select\" id=\"select-1\" name=\"select-1\">\n  </select>\n</div>"
         },
         {
             "name": "with selected value",
@@ -57,8 +57,7 @@
                     },
                     {
                         "value": 2,
-                        "text": "GOV.UK frontend option 2",
-                        "selected": true
+                        "text": "GOV.UK frontend option 2"
                     },
                     {
                         "value": 3,
@@ -66,10 +65,10 @@
                         "disabled": true
                     }
                 ],
-                "value": 3
+                "value": 2
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n\n\n  <select class=\"govuk-select\" id=\"select-1\" name=\"select-1\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n    \n  \n    \n      <option value=\"3\" selected disabled>GOV.UK frontend option 3</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n  <select class=\"govuk-select\" id=\"select-1\" name=\"select-1\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n  </select>\n</div>"
         },
         {
             "name": "with hint text and error message",
@@ -101,7 +100,7 @@
                 ]
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group govuk-form-group--error\">\n  <label class=\"govuk-label\" for=\"select-2\">\n    Label text goes here\n  </label>\n\n  \n  \n  <div id=\"select-2-hint\" class=\"govuk-hint\">\n    Hint text goes here\n  </div>\n\n\n  \n  \n  <p id=\"select-2-error\" class=\"govuk-error-message\">\n    <span class=\"govuk-visually-hidden\">Error:</span> Error message goes here\n  </p>\n\n  <select class=\"govuk-select govuk-select--error\" id=\"select-2\" name=\"select-2\" aria-describedby=\"select-2-hint select-2-error\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\">GOV.UK frontend option 2</option>\n    \n  \n    \n      <option value=\"3\">GOV.UK frontend option 3</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group govuk-form-group--error\">\n  <label class=\"govuk-label\" for=\"select-2\">\n    Label text goes here\n  </label>\n  <div id=\"select-2-hint\" class=\"govuk-hint\">\n    Hint text goes here\n  </div>\n  <p id=\"select-2-error\" class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Error message goes here\n  </p>\n  <select class=\"govuk-select govuk-select--error\" id=\"select-2\" name=\"select-2\" aria-describedby=\"select-2-hint select-2-error\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\">GOV.UK frontend option 2</option>\n      <option value=\"3\">GOV.UK frontend option 3</option>\n  </select>\n</div>"
         },
         {
             "name": "with label as page heading",
@@ -131,7 +130,7 @@
                 ]
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group\">\n  <h1 class=\"govuk-label-wrapper\">\n    <label class=\"govuk-label govuk-label--l\" for=\"select-3\">\n      Label text goes here\n    </label>\n    </h1>\n\n\n  <select class=\"govuk-select\" id=\"select-3\" name=\"select-3\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n    \n  \n    \n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  <h1 class=\"govuk-label-wrapper\"><label class=\"govuk-label govuk-label--l\" for=\"select-3\">\n      Label text goes here\n    </label>\n    </h1>\n  <select class=\"govuk-select\" id=\"select-3\" name=\"select-3\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n  </select>\n</div>"
         },
         {
             "name": "with full width override",
@@ -160,7 +159,7 @@
                 ]
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n\n\n  <select class=\"govuk-select govuk-!-width-full\" id=\"select-1\" name=\"select-1\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n    \n  \n    \n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n  <select class=\"govuk-select govuk-!-width-full\" id=\"select-1\" name=\"select-1\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n  </select>\n</div>"
         },
         {
             "name": "with optional form-group classes",
@@ -192,7 +191,7 @@
                 ]
             },
             "hidden": false,
-            "html": "<div class=\"govuk-form-group extra-class\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n\n\n  <select class=\"govuk-select govuk-!-width-full\" id=\"select-1\" name=\"select-1\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n    \n  \n    \n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group extra-class\">\n  <label class=\"govuk-label\" for=\"select-1\">\n    Label text goes here\n  </label>\n  <select class=\"govuk-select govuk-!-width-full\" id=\"select-1\" name=\"select-1\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\" selected>GOV.UK frontend option 2</option>\n      <option value=\"3\" disabled>GOV.UK frontend option 3</option>\n  </select>\n</div>"
         },
         {
             "name": "with describedBy",
@@ -212,7 +211,7 @@
                 "describedBy": "some-id"
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n\n  <select class=\"govuk-select\" id=\"with-describedby\" name=\"with-describedby\" aria-describedby=\"some-id\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\">GOV.UK frontend option 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <select class=\"govuk-select\" id=\"with-describedby\" name=\"with-describedby\" aria-describedby=\"some-id\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\">GOV.UK frontend option 2</option>\n  </select>\n</div>"
         },
         {
             "name": "attributes",
@@ -234,7 +233,7 @@
                 }
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n\n  <select class=\"govuk-select\" id=\"with-attributes\" name=\"with-attributes\" data-attribute=\"my data value\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\">GOV.UK frontend option 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <select class=\"govuk-select\" id=\"with-attributes\" name=\"with-attributes\" data-attribute=\"my data value\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\">GOV.UK frontend option 2</option>\n  </select>\n</div>"
         },
         {
             "name": "attributes on items",
@@ -262,7 +261,7 @@
                 ]
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n\n  <select class=\"govuk-select\" id=\"with-item-attributes\" name=\"with-item-attributes\">\n  \n    \n      <option value=\"1\" data-attribute=\"ABC\" data-second-attribute=\"DEF\">Option 1</option>\n    \n  \n    \n      <option value=\"2\" selected data-attribute=\"GHI\" data-second-attribute=\"JKL\">Option 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <select class=\"govuk-select\" id=\"with-item-attributes\" name=\"with-item-attributes\">\n      <option value=\"1\" data-attribute=\"ABC\" data-second-attribute=\"DEF\">Option 1</option>\n      <option value=\"2\" selected data-attribute=\"GHI\" data-second-attribute=\"JKL\">Option 2</option>\n  </select>\n</div>"
         },
         {
             "name": "with falsey values",
@@ -284,7 +283,7 @@
                 ]
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n\n  <select class=\"govuk-select\" id=\"with-falsey-values\" name=\"with-falsey-values\">\n  \n    \n      <option value=\"1\">Option 1</option>\n    \n  \n    \n  \n    \n  \n    \n  \n    \n      <option value=\"2\">Options 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <select class=\"govuk-select\" id=\"with-falsey-values\" name=\"with-falsey-values\">\n      <option value=\"1\">Option 1</option>\n      <option value=\"2\">Options 2</option>\n  </select>\n</div>"
         },
         {
             "name": "hint",
@@ -296,7 +295,7 @@
                 }
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n  \n  \n  <div id=\"select-with-hint-hint\" class=\"govuk-hint\">\n    Hint text goes here\n  </div>\n\n\n  <select class=\"govuk-select\" id=\"select-with-hint\" name=\"select-with-hint\" aria-describedby=\"select-with-hint-hint\">\n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <div id=\"select-with-hint-hint\" class=\"govuk-hint\">\n    Hint text goes here\n  </div>\n  <select class=\"govuk-select\" id=\"select-with-hint\" name=\"select-with-hint\" aria-describedby=\"select-with-hint-hint\">\n  </select>\n</div>"
         },
         {
             "name": "hint and describedBy",
@@ -319,7 +318,7 @@
                 ]
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n  \n  \n  <div id=\"select-with-hint-hint\" class=\"govuk-hint\">\n    Hint text goes here\n  </div>\n\n\n  <select class=\"govuk-select\" id=\"select-with-hint\" name=\"select-with-hint\" aria-describedby=\"some-id select-with-hint-hint\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\">GOV.UK frontend option 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <div id=\"select-with-hint-hint\" class=\"govuk-hint\">\n    Hint text goes here\n  </div>\n  <select class=\"govuk-select\" id=\"select-with-hint\" name=\"select-with-hint\" aria-describedby=\"some-id select-with-hint-hint\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\">GOV.UK frontend option 2</option>\n  </select>\n</div>"
         },
         {
             "name": "error",
@@ -341,7 +340,7 @@
                 ]
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group govuk-form-group--error\">\n  \n\n\n  \n  \n  <p id=\"select-with-error-error\" class=\"govuk-error-message\">\n    <span class=\"govuk-visually-hidden\">Error:</span> Error message\n  </p>\n\n  <select class=\"govuk-select govuk-select--error\" id=\"select-with-error\" name=\"select-with-error\" aria-describedby=\"select-with-error-error\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\">GOV.UK frontend option 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group govuk-form-group--error\">\n  \n  <p id=\"select-with-error-error\" class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Error message\n  </p>\n  <select class=\"govuk-select govuk-select--error\" id=\"select-with-error\" name=\"select-with-error\" aria-describedby=\"select-with-error-error\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\">GOV.UK frontend option 2</option>\n  </select>\n</div>"
         },
         {
             "name": "error and describedBy",
@@ -364,7 +363,7 @@
                 ]
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group govuk-form-group--error\">\n  \n\n\n  \n  \n  <p id=\"select-with-error-error\" class=\"govuk-error-message\">\n    <span class=\"govuk-visually-hidden\">Error:</span> Error message\n  </p>\n\n  <select class=\"govuk-select govuk-select--error\" id=\"select-with-error\" name=\"select-with-error\" aria-describedby=\"some-id select-with-error-error\">\n  \n    \n      <option value=\"1\">GOV.UK frontend option 1</option>\n    \n  \n    \n      <option value=\"2\">GOV.UK frontend option 2</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group govuk-form-group--error\">\n  \n  <p id=\"select-with-error-error\" class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Error message\n  </p>\n  <select class=\"govuk-select govuk-select--error\" id=\"select-with-error\" name=\"select-with-error\" aria-describedby=\"some-id select-with-error-error\">\n      <option value=\"1\">GOV.UK frontend option 1</option>\n      <option value=\"2\">GOV.UK frontend option 2</option>\n  </select>\n</div>"
         },
         {
             "name": "item selected overrides value",
@@ -389,7 +388,7 @@
                 "value": "green"
             },
             "hidden": true,
-            "html": "<div class=\"govuk-form-group\">\n  \n\n\n  <select class=\"govuk-select\" id=\"colors\" name=\"colors\">\n  \n    \n      <option value=\"red\">Red</option>\n    \n  \n    \n      <option value=\"green\">Green</option>\n    \n  \n    \n      <option value=\"blue\">Blue</option>\n    \n  \n  </select>\n</div>"
+            "html": "<div class=\"govuk-form-group\">\n  \n  <select class=\"govuk-select\" id=\"colors\" name=\"colors\">\n      <option value=\"red\">Red</option>\n      <option value=\"green\">Green</option>\n      <option value=\"blue\">Blue</option>\n  </select>\n</div>"
         }
     ]
-}
+}

data/node_modules/govuk-frontend/govuk/components/select/macro-options.json

@@ -55,6 +55,12 @@
         "required": false,
         "description": "Value for the option which should be selected. Use this as an alternative to setting the `selected` option on each individual item."
     },
+    {
+        "name": "disabled",
+        "type": "boolean",
+        "required": false,
+        "description": "If `true`, select box will be disabled. Use the `disabled` option on each individual item to only disable certain options."
+    },
     {
         "name": "describedBy",
         "type": "string",
@@ -108,4 +114,4 @@
         "required": false,
         "description": "HTML attributes (for example data attributes) to add to the select."
     }
-]
+]

data/node_modules/govuk-frontend/govuk/components/select/template.njk

@@ -3,7 +3,7 @@
 {% from "../label/macro.njk" import govukLabel %}
 
 {#- a record of other elements that we need to associate with the input using
-   aria-describedby – for example hints or error messages -#}
+  aria-describedby – for example hints or error messages -#}
 {% set describedBy = params.describedBy if params.describedBy else "" %}
 <div class="govuk-form-group {%- if params.errorMessage %} govuk-form-group--error{% endif %} {%- if params.formGroup.classes %} {{ params.formGroup.classes }}{% endif %}">
   {{ govukLabel({
@@ -38,7 +38,10 @@
   }) | indent(2) | trim }}
 {% endif %}
   <select class="govuk-select
-    {%- if params.classes %} {{ params.classes }}{% endif %}{%- if params.errorMessage %} govuk-select--error{% endif %}" id="{{ params.id }}" name="{{ params.name }}" {%- if describedBy %} aria-describedby="{{ describedBy }}"{% endif %} {%- for attribute, value in params.attributes %} {{ attribute }}="{{ value }}"{% endfor %}>
+    {%- if params.classes %} {{ params.classes }}{% endif %}{%- if params.errorMessage %} govuk-select--error{% endif %}" id="{{ params.id }}" name="{{ params.name }}"
+    {%- if params.disabled %} disabled{% endif %}
+    {%- if describedBy %} aria-describedby="{{ describedBy }}"{% endif %}
+    {%- for attribute, value in params.attributes %} {{ attribute }}="{{ value }}"{% endfor %}>
   {% for item in params.items %}
     {% if item %}
       <option value="{{ item.value }}"

data/node_modules/govuk-frontend/govuk/components/skip-link/fixtures.json

@@ -83,4 +83,4 @@
             "html": "<a href=\"#content\" class=\"govuk-skip-link\" data-test=\"attribute\" aria-label=\"Skip to content\" data-module=\"govuk-skip-link\">Skip link</a>"
         }
     ]
-}
+}

data/node_modules/govuk-frontend/govuk/components/skip-link/macro-options.json

@@ -29,4 +29,4 @@
         "required": false,
         "description": "HTML attributes (for example data attributes) to add to the skip link."
     }
-]
+]

data/node_modules/govuk-frontend/govuk/components/skip-link/skip-link.js

@@ -4,7 +4,8 @@
 	(global.GOVUKFrontend = global.GOVUKFrontend || {}, global.GOVUKFrontend.SkipLink = factory());
 }(this, (function () { 'use strict';
 
-	(function(undefined) {
+	// @ts-nocheck
+	(function (undefined) {
 
 	// Detection from https://github.com/Financial-Times/polyfill-service/blob/master/packages/polyfill-library/polyfills/Object/defineProperty/detect.js
 	var detect = (
@@ -91,7 +92,8 @@
 	})
 	.call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
-	(function(undefined) {
+	// @ts-nocheck
+	(function (undefined) {
 
 	    // Detection from https://raw.githubusercontent.com/Financial-Times/polyfill-service/master/packages/polyfill-library/polyfills/DOMTokenList/detect.js
 	    var detect = (
@@ -356,7 +358,8 @@
 
 	}).call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
-	(function(undefined) {
+	// @ts-nocheck
+	(function (undefined) {
 
 	// Detection from https://github.com/Financial-Times/polyfill-service/blob/master/packages/polyfill-library/polyfills/Document/detect.js
 	var detect = ("Document" in this);
@@ -383,6 +386,8 @@
 	})
 	.call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
+	// @ts-nocheck
+
 	(function(undefined) {
 
 	// Detection from https://github.com/Financial-Times/polyfill-service/blob/master/packages/polyfill-library/polyfills/Element/detect.js
@@ -496,6 +501,8 @@
 	})
 	.call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
+	// @ts-nocheck
+
 	(function(undefined) {
 
 	    // Detection from https://raw.githubusercontent.com/Financial-Times/polyfill-service/8717a9e04ac7aff99b4980fbedead98036b0929a/packages/polyfill-library/polyfills/Element/prototype/classList/detect.js
@@ -586,7 +593,8 @@
 
 	}).call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
-	(function(undefined) {
+	// @ts-nocheck
+	(function (undefined) {
 
 	// Detection from https://github.com/Financial-Times/polyfill-service/blob/master/packages/polyfill-library/polyfills/Window/detect.js
 	var detect = ('Window' in this);
@@ -607,6 +615,8 @@
 	})
 	.call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
+	// @ts-nocheck
+
 	(function(undefined) {
 
 	// Detection from https://github.com/Financial-Times/polyfill-service/blob/master/packages/polyfill-library/polyfills/Event/detect.js
@@ -856,6 +866,8 @@
 	})
 	.call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
+	// @ts-nocheck
+
 	(function(undefined) {
 	  // Detection from https://github.com/Financial-Times/polyfill-service/blob/master/packages/polyfill-library/polyfills/Function/prototype/bind/detect.js
 	  var detect = 'bind' in Function.prototype;
@@ -1020,11 +1032,20 @@
 	 * Skip link component
 	 *
 	 * @class
-	 * @param {HTMLElement} $module - HTML element to use for skip link
+	 * @param {Element} $module - HTML element to use for skip link
 	 */
 	function SkipLink ($module) {
+	  if (!($module instanceof HTMLAnchorElement)) {
+	    return this
+	  }
+
+	  /** @deprecated Will be made private in v5.0 */
 	  this.$module = $module;
+
+	  /** @deprecated Will be made private in v5.0 */
 	  this.$linkedElement = null;
+
+	  /** @deprecated Will be made private in v5.0 */
 	  this.linkedElementListener = false;
 	}
 
@@ -1032,30 +1053,31 @@
 	 * Initialise component
 	 */
 	SkipLink.prototype.init = function () {
-	  // Check for module
+	  // Check that required elements are present
 	  if (!this.$module) {
 	    return
 	  }
 
 	  // Check for linked element
-	  this.$linkedElement = this.getLinkedElement();
-	  if (!this.$linkedElement) {
+	  var $linkedElement = this.getLinkedElement();
+	  if (!$linkedElement) {
 	    return
 	  }
 
+	  this.$linkedElement = $linkedElement;
 	  this.$module.addEventListener('click', this.focusLinkedElement.bind(this));
 	};
 
 	/**
 	 * Get linked element
 	 *
-	 * @returns {HTMLElement} $linkedElement - DOM element linked to from the skip link
+	 * @deprecated Will be made private in v5.0
+	 * @returns {HTMLElement | null} $linkedElement - DOM element linked to from the skip link
 	 */
 	SkipLink.prototype.getLinkedElement = function () {
 	  var linkedElementId = this.getFragmentFromUrl();
-
 	  if (!linkedElementId) {
-	    return false
+	    return null
 	  }
 
 	  return document.getElementById(linkedElementId)
@@ -1065,6 +1087,8 @@
 	 * Focus the linked element
 	 *
 	 * Set tabindex and helper CSS class. Set listener to remove them on blur.
+	 *
+	 * @deprecated Will be made private in v5.0
 	 */
 	SkipLink.prototype.focusLinkedElement = function () {
 	  var $linkedElement = this.$linkedElement;
@@ -1080,6 +1104,7 @@
 	      this.linkedElementListener = true;
 	    }
 	  }
+
 	  $linkedElement.focus();
 	};
 
@@ -1088,6 +1113,8 @@
 	 * focusable until it has received programmatic focus and a screen reader has announced it.
 	 *
 	 * Remove the CSS class that removes the native focus styles.
+	 *
+	 * @deprecated Will be made private in v5.0
 	 */
 	SkipLink.prototype.removeFocusProperties = function () {
 	  this.$linkedElement.removeAttribute('tabindex');
@@ -1100,12 +1127,13 @@
 	 * Extract the fragment (everything after the hash symbol) from a URL, but not including
 	 * the symbol.
 	 *
-	 * @returns {string} Fragment from URL, without the hash symbol
+	 * @deprecated Will be made private in v5.0
+	 * @returns {string | undefined} Fragment from URL, without the hash symbol
 	 */
 	SkipLink.prototype.getFragmentFromUrl = function () {
 	  // Bail if the anchor link doesn't have a hash
 	  if (!this.$module.hash) {
-	    return false
+	    return
 	  }
 
 	  return this.$module.hash.split('#').pop()