feat(rule): aria-allowed-role

doc/rule-descriptions.md

@@ -3,6 +3,7 @@
 | accesskeys | Ensures every accesskey attribute value is unique | Serious | best-practice, cat.keyboard | true |
 | area-alt | Ensures <area> elements of image maps have alternate text | Critical | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a | true |
 | aria-allowed-attr | Ensures ARIA attributes are allowed for an element's role | Critical | cat.aria, wcag2a, wcag412 | true |
+| aria-allowed-role | Ensure role attribute has a value appropriate for the element | Minor | cat.aria, best-practice | true |
 | aria-dpub-role-fallback | Ensures unsupported DPUB roles are only used on elements with implicit fallback roles | Moderate | cat.aria, wcag2a, wcag131 | true |
 | aria-hidden-body | Ensures aria-hidden='true' is not present on the document body. | Critical | cat.aria, wcag2a, wcag412 | true |
 | aria-required-attr | Ensures elements with ARIA roles have all required ARIA attributes | Critical | cat.aria, wcag2a, wcag412 | true |

lib/checks/aria/aria-allowed-role.js

@@ -0,0 +1,14 @@
+/**
+ * Implements allowed roles defined at:
+ * https://www.w3.org/TR/html-aria/#docconformance
+ * https://www.w3.org/TR/SVG2/struct.html#implicit-aria-semantics
+ */
+const { allowImplicit = true, ignoredTags = [] } = options || {};
+const tagName = node.tagName.toLowerCase();
+
+// check if the element should be ignored, by an user setting
+if (ignoredTags && ignoredTags.includes(tagName)) {
+	return true;
+}
+
+return axe.commons.aria.isAriaAllowedRole(node, tagName, allowImplicit);

lib/checks/aria/aria-allowed-role.json

@@ -0,0 +1,15 @@
+{
+	"id": "aria-allowed-role",
+	"evaluate": "aria-allowed-role.js",
+	"options": {
+		"allowImplicit": true,
+		"ignoredTags": []
+	},
+	"metadata": {
+		"impact": "minor",
+		"messages": {
+			"pass": "ARIA role(s) is allowed for given element",
+			"fail": "Role(s) must be one of the allowed ARIA roles"
+		}
+	}
+}