govuk_publishing_components 16.6.0 → 16.7.0

data/node_modules/axe-core/lib/checks/forms/fieldset.js

@@ -0,0 +1,109 @@
+var failureCode,
+	self = this;
+
+function getUnrelatedElements(parent, name) {
+	return axe.utils.toArray(
+		parent.querySelectorAll(
+			'select,textarea,button,input:not([name="' +
+				name +
+				'"]):not([type="hidden"])'
+		)
+	);
+}
+
+function checkFieldset(group, name) {
+	var firstNode = group.firstElementChild;
+	if (!firstNode || firstNode.nodeName.toUpperCase() !== 'LEGEND') {
+		self.relatedNodes([group]);
+		failureCode = 'no-legend';
+		return false;
+	}
+	if (!axe.commons.text.accessibleText(firstNode)) {
+		self.relatedNodes([firstNode]);
+		failureCode = 'empty-legend';
+		return false;
+	}
+	var otherElements = getUnrelatedElements(group, name);
+	if (otherElements.length) {
+		self.relatedNodes(otherElements);
+		failureCode = 'mixed-inputs';
+		return false;
+	}
+	return true;
+}
+
+function checkARIAGroup(group, name) {
+	var hasLabelledByText = axe.commons.dom
+		.idrefs(group, 'aria-labelledby')
+		.some(function(element) {
+			return element && axe.commons.text.accessibleText(element);
+		});
+	var ariaLabel = group.getAttribute('aria-label');
+	if (
+		!hasLabelledByText &&
+		!(ariaLabel && axe.commons.text.sanitize(ariaLabel))
+	) {
+		self.relatedNodes(group);
+		failureCode = 'no-group-label';
+		return false;
+	}
+
+	var otherElements = getUnrelatedElements(group, name);
+	if (otherElements.length) {
+		self.relatedNodes(otherElements);
+		failureCode = 'group-mixed-inputs';
+		return false;
+	}
+	return true;
+}
+
+function spliceCurrentNode(nodes, current) {
+	return axe.utils.toArray(nodes).filter(function(candidate) {
+		return candidate !== current;
+	});
+}
+
+function runCheck(virtualNode) {
+	const name = axe.utils.escapeSelector(virtualNode.actualNode.name);
+	const root = axe.commons.dom.getRootNode(virtualNode.actualNode);
+	const matchingNodes = root.querySelectorAll(
+		'input[type="' +
+			axe.utils.escapeSelector(virtualNode.actualNode.type) +
+			'"][name="' +
+			name +
+			'"]'
+	);
+
+	if (matchingNodes.length < 2) {
+		return true;
+	}
+	const fieldset = axe.commons.dom.findUpVirtual(virtualNode, 'fieldset');
+	const group = axe.commons.dom.findUpVirtual(
+		virtualNode,
+		'[role="group"]' +
+			(virtualNode.actualNode.type === 'radio' ? ',[role="radiogroup"]' : '')
+	);
+
+	if (!group && !fieldset) {
+		failureCode = 'no-group';
+		self.relatedNodes(spliceCurrentNode(matchingNodes, virtualNode.actualNode));
+		return false;
+	} else if (fieldset) {
+		return checkFieldset(fieldset, name);
+	} else {
+		return checkARIAGroup(group, name);
+	}
+}
+
+var data = {
+	name: node.getAttribute('name'),
+	type: node.getAttribute('type')
+};
+
+var result = runCheck(virtualNode);
+if (!result) {
+	data.failureCode = failureCode;
+}
+this.data(data);
+
+return result;

data/node_modules/axe-core/lib/checks/forms/fieldset.json

@@ -0,0 +1,12 @@
+{
+	"id": "fieldset",
+	"evaluate": "fieldset.js",
+	"after": "fieldset-after.js",
+	"metadata": {
+		"impact": "critical",
+		"messages": {
+			"pass": "Element is contained in a fieldset",
+			"fail": "{{var code = it.data && it.data.failureCode;}}{{? code === 'no-legend'}}Fieldset does not have a legend as its first child{{?? code === 'empty-legend'}}Legend does not have text that is visible to screen readers{{?? code === 'mixed-inputs'}}Fieldset contains unrelated inputs{{?? code === 'no-group-label'}}ARIA group does not have aria-label or aria-labelledby{{?? code === 'group-mixed-inputs'}}ARIA group contains unrelated inputs{{??}}Element does not have a containing fieldset or ARIA group{{?}}"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/forms/group-labelledby-after.js

@@ -0,0 +1,16 @@
+var seen = {};
+
+// Filter out nodes that have the same type and name.
+// If you have two `<input type="radio" name="foo" />` elements
+// only the first one can pass / fail the rule.
+return results.filter(function(result) {
+	var data = result.data;
+	if (data) {
+		seen[data.type] = seen[data.type] || {};
+		if (!seen[data.type][data.name]) {
+			seen[data.type][data.name] = true;
+			return true;
+		}
+	}
+	return false;
+});

data/node_modules/axe-core/lib/checks/forms/group-labelledby.js

@@ -0,0 +1,66 @@
+const { dom, text } = axe.commons;
+
+const type = axe.utils.escapeSelector(node.type);
+const name = axe.utils.escapeSelector(node.name);
+const doc = dom.getRootNode(node);
+const data = {
+	name: node.name,
+	type: node.type
+};
+
+const matchingNodes = Array.from(
+	doc.querySelectorAll(`input[type="${type}"][name="${name}"]`)
+);
+// There is only one node with this name & type, so there's no need for a group
+if (matchingNodes.length <= 1) {
+	this.data(data);
+	return true;
+}
+
+let sharedLabels = dom.idrefs(node, 'aria-labelledby').filter(label => !!label); // Filter for "null" labels
+let uniqueLabels = sharedLabels.slice();
+
+// Figure out which labels are unique, which are shared by all items, or neither
+matchingNodes.forEach(groupItem => {
+	if (groupItem === node) {
+		return;
+	}
+	// Find new labels associated with current groupItem
+	const labels = dom
+		.idrefs(groupItem, 'aria-labelledby')
+		.filter(newLabel => newLabel);
+
+	sharedLabels = sharedLabels.filter(sharedLabel =>
+		labels.includes(sharedLabel)
+	);
+	uniqueLabels = uniqueLabels.filter(
+		uniqueLabel => !labels.includes(uniqueLabel)
+	);
+});
+
+const accessibleTextOptions = {
+	// Prevent following further aria-labelledby refs:
+	inLabelledByContext: true
+};
+
+// filter items with no accessible name, do this last for performance reasons
+uniqueLabels = uniqueLabels.filter(labelNode =>
+	text.accessibleText(labelNode, accessibleTextOptions)
+);
+sharedLabels = sharedLabels.filter(labelNode =>
+	text.accessibleText(labelNode, accessibleTextOptions)
+);
+
+if (uniqueLabels.length > 0 && sharedLabels.length > 0) {
+	this.data(data);
+	return true;
+}
+
+if (uniqueLabels.length > 0 && sharedLabels.length === 0) {
+	data.failureCode = 'no-shared-label';
+} else if (uniqueLabels.length === 0 && sharedLabels.length > 0) {
+	data.failureCode = 'no-unique-label';
+}
+
+this.data(data);
+return false;

data/node_modules/axe-core/lib/checks/forms/group-labelledby.json

@@ -0,0 +1,12 @@
+{
+	"id": "group-labelledby",
+	"evaluate": "group-labelledby.js",
+	"after": "group-labelledby-after.js",
+	"metadata": {
+		"impact": "critical",
+		"messages": {
+			"pass": "Elements with the name \"{{=it.data.name}}\" have both a shared label, and a unique label, referenced through aria-labelledby",
+			"fail": "{{var code = it.data && it.data.failureCode;}}Elements with the name \"{{=it.data.name}}\" do not all have {{? code === 'no-shared-label' }}a shared label{{?? code === 'no-unique-label' }}a unique label{{??}}both a shared label, and a unique label{{?}}, referenced through aria-labelledby"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/accesskeys-after.js

@@ -0,0 +1,19 @@
+var seen = {};
+return results
+	.filter(function(r) {
+		if (!r.data) {
+			return false;
+		}
+		var key = r.data.toUpperCase();
+		if (!seen[key]) {
+			seen[key] = r;
+			r.relatedNodes = [];
+			return true;
+		}
+		seen[key].relatedNodes.push(r.relatedNodes[0]);
+		return false;
+	})
+	.map(function(r) {
+		r.result = !!r.relatedNodes.length;
+		return r;
+	});

data/node_modules/axe-core/lib/checks/keyboard/accesskeys.js

@@ -0,0 +1,5 @@
+if (axe.commons.dom.isVisible(node, false)) {
+	this.data(node.getAttribute('accesskey'));
+	this.relatedNodes([node]);
+}
+return true;

data/node_modules/axe-core/lib/checks/keyboard/accesskeys.json

@@ -0,0 +1,12 @@
+{
+	"id": "accesskeys",
+	"evaluate": "accesskeys.js",
+	"after": "accesskeys-after.js",
+	"metadata": {
+		"impact": "serious",
+		"messages": {
+			"pass": "Accesskey attribute value is unique",
+			"fail": "Document has multiple elements with the same accesskey"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/focusable-disabled.js

@@ -0,0 +1,25 @@
+const elementsThatCanBeDisabled = [
+	'BUTTON',
+	'FIELDSET',
+	'INPUT',
+	'SELECT',
+	'TEXTAREA'
+];
+
+const tabbableElements = virtualNode.tabbableElements;
+
+if (!tabbableElements || !tabbableElements.length) {
+	return true;
+}
+
+const relatedNodes = tabbableElements.reduce((out, { actualNode: el }) => {
+	const nodeName = el.nodeName.toUpperCase();
+	// populate nodes that can be disabled
+	if (elementsThatCanBeDisabled.includes(nodeName)) {
+		out.push(el);
+	}
+	return out;
+}, []);
+this.relatedNodes(relatedNodes);
+
+return relatedNodes.length === 0;

data/node_modules/axe-core/lib/checks/keyboard/focusable-disabled.json

@@ -0,0 +1,11 @@
+{
+	"id": "focusable-disabled",
+	"evaluate": "focusable-disabled.js",
+	"metadata": {
+		"impact": "serious",
+		"messages": {
+			"pass": "No focusable elements contained within element",
+			"fail": "Focusable content should be disabled or be removed from the DOM"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/focusable-no-name.js

@@ -0,0 +1,6 @@
+var tabIndex = node.getAttribute('tabindex'),
+	inFocusOrder = axe.commons.dom.isFocusable(node) && tabIndex > -1;
+if (!inFocusOrder) {
+	return false;
+}
+return !axe.commons.text.accessibleTextVirtual(virtualNode);

data/node_modules/axe-core/lib/checks/keyboard/focusable-no-name.json

@@ -0,0 +1,11 @@
+{
+	"id": "focusable-no-name",
+	"evaluate": "focusable-no-name.js",
+	"metadata": {
+		"impact": "serious",
+		"messages": {
+			"pass": "Element is not in tab order or has accessible text",
+			"fail": "Element is in tab order and does not have accessible text"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/focusable-not-tabbable.js

@@ -0,0 +1,25 @@
+const elementsThatCanBeDisabled = [
+	'BUTTON',
+	'FIELDSET',
+	'INPUT',
+	'SELECT',
+	'TEXTAREA'
+];
+
+const tabbableElements = virtualNode.tabbableElements;
+
+if (!tabbableElements || !tabbableElements.length) {
+	return true;
+}
+
+const relatedNodes = tabbableElements.reduce((out, { actualNode: el }) => {
+	const nodeName = el.nodeName.toUpperCase();
+	// populate nodes that cannot be disabled
+	if (!elementsThatCanBeDisabled.includes(nodeName)) {
+		out.push(el);
+	}
+	return out;
+}, []);
+this.relatedNodes(relatedNodes);
+
+return relatedNodes.length === 0;

data/node_modules/axe-core/lib/checks/keyboard/focusable-not-tabbable.json

@@ -0,0 +1,11 @@
+{
+	"id": "focusable-not-tabbable",
+	"evaluate": "focusable-not-tabbable.js",
+	"metadata": {
+		"impact": "serious",
+		"messages": {
+			"pass": "No focusable elements contained within element",
+			"fail": "Focusable content should have tabindex='-1' or be removed from the DOM"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/landmark-is-top-level.js

@@ -0,0 +1,18 @@
+var landmarks = axe.commons.aria.getRolesByType('landmark');
+var parent = axe.commons.dom.getComposedParent(node);
+
+this.data({
+	role: node.getAttribute('role') || axe.commons.aria.implicitRole(node)
+});
+
+while (parent) {
+	var role = parent.getAttribute('role');
+	if (!role && parent.nodeName.toUpperCase() !== 'FORM') {
+		role = axe.commons.aria.implicitRole(parent);
+	}
+	if (role && landmarks.includes(role)) {
+		return false;
+	}
+	parent = axe.commons.dom.getComposedParent(parent);
+}
+return true;

data/node_modules/axe-core/lib/checks/keyboard/landmark-is-top-level.json

@@ -0,0 +1,11 @@
+{
+	"id": "landmark-is-top-level",
+	"evaluate": "landmark-is-top-level.js",
+	"metadata": {
+		"impact": "moderate",
+		"messages": {
+			"pass": "The {{=it.data.role }} landmark is at the top level.",
+			"fail": "The {{=it.data.role }} landmark is contained in another landmark."
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/page-has-elm-after.js

@@ -0,0 +1,11 @@
+const elmUsedAnywhere = results.some(
+	frameResult => frameResult.result === true
+);
+
+// If the element exists in any frame, set them all to true
+if (elmUsedAnywhere) {
+	results.forEach(result => {
+		result.result = true;
+	});
+}
+return results;

data/node_modules/axe-core/lib/checks/keyboard/page-has-elm.js

@@ -0,0 +1,9 @@
+if (!options || !options.selector || typeof options.selector !== 'string') {
+	throw new TypeError(
+		'visible-in-page requires options.selector to be a string'
+	);
+}
+
+const matchingElms = axe.utils.querySelectorAll(virtualNode, options.selector);
+this.relatedNodes(matchingElms.map(vNode => vNode.actualNode));
+return matchingElms.length > 0;

data/node_modules/axe-core/lib/checks/keyboard/page-has-heading-one.json

@@ -0,0 +1,15 @@
+{
+	"id": "page-has-heading-one",
+	"evaluate": "page-has-elm.js",
+	"after": "page-has-elm-after.js",
+	"options": {
+		"selector": "h1:not([role]), [role=\"heading\"][aria-level=\"1\"]"
+	},
+	"metadata": {
+		"impact": "moderate",
+		"messages": {
+			"pass": "Page has at least one level-one heading",
+			"fail": "Page must have a level-one heading"
+		}
+	}
+}

data/node_modules/axe-core/lib/checks/keyboard/page-has-main.json

@@ -0,0 +1,15 @@
+{
+	"id": "page-has-main",
+	"evaluate": "page-has-elm.js",
+	"after": "page-has-elm-after.js",
+	"options": {
+		"selector": "main:not([role]), [role='main']"
+	},
+	"metadata": {
+		"impact": "moderate",
+		"messages": {
+			"pass": "Document has at least one main landmark",
+			"fail": "Document does not have a main landmark"
+		}
+	}
+}