diff --git a/doc/rule-descriptions.md b/doc/rule-descriptions.md
index 317534812f..422f43abb3 100644
--- a/doc/rule-descriptions.md
+++ b/doc/rule-descriptions.md
@@ -11,62 +11,62 @@
## WCAG 2.0 Level A & AA Rules
-| Rule ID | Description | Impact | Tags | Issue Type | ACT Rules |
-| :------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- | :----------------------------------------------------------------------------------------- | :------------------------- | :----------------------------------------------------------------------------------------------------- |
-| [area-alt](https://dequeuniversity.com/rules/axe/4.3/area-alt?application=RuleDescription) | Ensures <area> elements of image maps have alternate text | Critical | cat.text-alternatives, wcag2a, wcag111, wcag244, wcag412, section508, section508.22.a, ACT | failure, needs review | [c487ae](https://act-rules.github.io/rules/c487ae) |
-| [aria-allowed-attr](https://dequeuniversity.com/rules/axe/4.3/aria-allowed-attr?application=RuleDescription) | Ensures ARIA attributes are allowed for an element's role | Serious, Critical | cat.aria, wcag2a, wcag412 | failure, needs review | [5c01ea](https://act-rules.github.io/rules/5c01ea) |
-| [aria-command-name](https://dequeuniversity.com/rules/axe/4.3/aria-command-name?application=RuleDescription) | Ensures every ARIA button, link and menuitem has an accessible name | Serious | cat.aria, wcag2a, wcag412 | failure, needs review | [97a4e1](https://act-rules.github.io/rules/97a4e1) |
-| [aria-hidden-body](https://dequeuniversity.com/rules/axe/4.3/aria-hidden-body?application=RuleDescription) | Ensures aria-hidden='true' is not present on the document body. | Critical | cat.aria, wcag2a, wcag412 | failure | |
-| [aria-hidden-focus](https://dequeuniversity.com/rules/axe/4.3/aria-hidden-focus?application=RuleDescription) | Ensures aria-hidden elements do not contain focusable elements | Serious | cat.name-role-value, wcag2a, wcag412, wcag131 | failure, needs review | [6cfa84](https://act-rules.github.io/rules/6cfa84) |
-| [aria-input-field-name](https://dequeuniversity.com/rules/axe/4.3/aria-input-field-name?application=RuleDescription) | Ensures every ARIA input field has an accessible name | Moderate, Serious | cat.aria, wcag2a, wcag412, ACT | failure, needs review | [e086e5](https://act-rules.github.io/rules/e086e5) |
-| [aria-meter-name](https://dequeuniversity.com/rules/axe/4.3/aria-meter-name?application=RuleDescription) | Ensures every ARIA meter node has an accessible name | Serious | cat.aria, wcag2a, wcag111 | failure, needs review | |
-| [aria-progressbar-name](https://dequeuniversity.com/rules/axe/4.3/aria-progressbar-name?application=RuleDescription) | Ensures every ARIA progressbar node has an accessible name | Serious | cat.aria, wcag2a, wcag111 | failure, needs review | |
-| [aria-required-attr](https://dequeuniversity.com/rules/axe/4.3/aria-required-attr?application=RuleDescription) | Ensures elements with ARIA roles have all required ARIA attributes | Critical | cat.aria, wcag2a, wcag412 | failure | |
-| [aria-required-children](https://dequeuniversity.com/rules/axe/4.3/aria-required-children?application=RuleDescription) | Ensures elements with an ARIA role that require child roles contain them | Critical | cat.aria, wcag2a, wcag131 | failure, needs review | [ff89c9](https://act-rules.github.io/rules/ff89c9) |
-| [aria-required-parent](https://dequeuniversity.com/rules/axe/4.3/aria-required-parent?application=RuleDescription) | Ensures elements with an ARIA role that require parent roles are contained by them | Critical | cat.aria, wcag2a, wcag131 | failure | [bc4a75](https://act-rules.github.io/rules/bc4a75), [ff89c9](https://act-rules.github.io/rules/ff89c9) |
-| [aria-roledescription](https://dequeuniversity.com/rules/axe/4.3/aria-roledescription?application=RuleDescription) | Ensure aria-roledescription is only used on elements with an implicit or explicit role | Serious | cat.aria, wcag2a, wcag412 | failure, needs review | |
-| [aria-roles](https://dequeuniversity.com/rules/axe/4.3/aria-roles?application=RuleDescription) | Ensures all elements with a role attribute use a valid value | Serious, Critical | cat.aria, wcag2a, wcag412 | failure, needs review | |
-| [aria-toggle-field-name](https://dequeuniversity.com/rules/axe/4.3/aria-toggle-field-name?application=RuleDescription) | Ensures every ARIA toggle field has an accessible name | Moderate, Serious | cat.aria, wcag2a, wcag412, ACT | failure, needs review | |
-| [aria-tooltip-name](https://dequeuniversity.com/rules/axe/4.3/aria-tooltip-name?application=RuleDescription) | Ensures every ARIA tooltip node has an accessible name | Serious | cat.aria, wcag2a, wcag412 | failure, needs review | |
-| [aria-valid-attr-value](https://dequeuniversity.com/rules/axe/4.3/aria-valid-attr-value?application=RuleDescription) | Ensures all ARIA attributes have valid values | Serious, Critical | cat.aria, wcag2a, wcag412 | failure, needs review | [5c01ea](https://act-rules.github.io/rules/5c01ea), [c487ae](https://act-rules.github.io/rules/c487ae) |
-| [aria-valid-attr](https://dequeuniversity.com/rules/axe/4.3/aria-valid-attr?application=RuleDescription) | Ensures attributes that begin with aria- are valid ARIA attributes | Critical | cat.aria, wcag2a, wcag412 | failure | |
-| [audio-caption](https://dequeuniversity.com/rules/axe/4.3/audio-caption?application=RuleDescription) | Ensures <audio> elements have captions | Critical | cat.time-and-media, wcag2a, wcag121, section508, section508.22.a | needs review | [c3232f](https://act-rules.github.io/rules/c3232f), [e7aa44](https://act-rules.github.io/rules/e7aa44) |
-| [blink](https://dequeuniversity.com/rules/axe/4.3/blink?application=RuleDescription) | Ensures <blink> elements are not used | Serious | cat.time-and-media, wcag2a, wcag222, section508, section508.22.j | failure | |
-| [button-name](https://dequeuniversity.com/rules/axe/4.3/button-name?application=RuleDescription) | Ensures buttons have discernible text | Critical | cat.name-role-value, wcag2a, wcag412, section508, section508.22.a, ACT | failure, needs review | [97a4e1](https://act-rules.github.io/rules/97a4e1), [m6b1q3](https://act-rules.github.io/rules/m6b1q3) |
-| [bypass](https://dequeuniversity.com/rules/axe/4.3/bypass?application=RuleDescription) | Ensures each page has at least one mechanism for a user to bypass navigation and jump straight to the content | Serious | cat.keyboard, wcag2a, wcag241, section508, section508.22.o | needs review | |
-| [color-contrast](https://dequeuniversity.com/rules/axe/4.3/color-contrast?application=RuleDescription) | Ensures the contrast between foreground and background colors meets WCAG 2 AA contrast ratio thresholds | Serious | cat.color, wcag2aa, wcag143 | failure, needs review | |
-| [definition-list](https://dequeuniversity.com/rules/axe/4.3/definition-list?application=RuleDescription) | Ensures <dl> elements are structured correctly | Serious | cat.structure, wcag2a, wcag131 | failure | |
-| [dlitem](https://dequeuniversity.com/rules/axe/4.3/dlitem?application=RuleDescription) | Ensures <dt> and <dd> elements are contained by a <dl> | Serious | cat.structure, wcag2a, wcag131 | failure | |
-| [document-title](https://dequeuniversity.com/rules/axe/4.3/document-title?application=RuleDescription) | Ensures each HTML document contains a non-empty <title> element | Serious | cat.text-alternatives, wcag2a, wcag242, ACT | failure | [2779a5](https://act-rules.github.io/rules/2779a5) |
-| [duplicate-id-active](https://dequeuniversity.com/rules/axe/4.3/duplicate-id-active?application=RuleDescription) | Ensures every id attribute value of active elements is unique | Serious | cat.parsing, wcag2a, wcag411 | failure | |
-| [duplicate-id-aria](https://dequeuniversity.com/rules/axe/4.3/duplicate-id-aria?application=RuleDescription) | Ensures every id attribute value used in ARIA and in labels is unique | Critical | cat.parsing, wcag2a, wcag411 | failure | [3ea0c8](https://act-rules.github.io/rules/3ea0c8) |
-| [duplicate-id](https://dequeuniversity.com/rules/axe/4.3/duplicate-id?application=RuleDescription) | Ensures every id attribute value is unique | Minor | cat.parsing, wcag2a, wcag411 | failure | |
-| [form-field-multiple-labels](https://dequeuniversity.com/rules/axe/4.3/form-field-multiple-labels?application=RuleDescription) | Ensures form field does not have multiple label elements | Moderate | cat.forms, wcag2a, wcag332 | needs review | |
-| [frame-focusable-content](https://dequeuniversity.com/rules/axe/4.3/frame-focusable-content?application=RuleDescription) | Ensures <frame> and <iframe> elements with focusable content do not have tabindex=-1 | Serious | cat.keyboard, wcag2a, wcag211 | failure, needs review | |
-| [frame-title](https://dequeuniversity.com/rules/axe/4.3/frame-title?application=RuleDescription) | Ensures <iframe> and <frame> elements have an accessible name | Serious | cat.text-alternatives, wcag2a, wcag241, wcag412, section508, section508.22.i | failure, needs review | |
-| [html-has-lang](https://dequeuniversity.com/rules/axe/4.3/html-has-lang?application=RuleDescription) | Ensures every HTML document has a lang attribute | Serious | cat.language, wcag2a, wcag311, ACT | failure | [b5c3f8](https://act-rules.github.io/rules/b5c3f8) |
-| [html-lang-valid](https://dequeuniversity.com/rules/axe/4.3/html-lang-valid?application=RuleDescription) | Ensures the lang attribute of the <html> element has a valid value | Serious | cat.language, wcag2a, wcag311, ACT | failure | [bf051a](https://act-rules.github.io/rules/bf051a) |
-| [html-xml-lang-mismatch](https://dequeuniversity.com/rules/axe/4.3/html-xml-lang-mismatch?application=RuleDescription) | Ensure that HTML elements with both valid lang and xml:lang attributes agree on the base language of the page | Moderate | cat.language, wcag2a, wcag311, ACT | failure | [5b7ae0](https://act-rules.github.io/rules/5b7ae0) |
-| [image-alt](https://dequeuniversity.com/rules/axe/4.3/image-alt?application=RuleDescription) | Ensures <img> elements have alternate text or a role of none or presentation | Critical | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [23a2a8](https://act-rules.github.io/rules/23a2a8) |
-| [input-button-name](https://dequeuniversity.com/rules/axe/4.3/input-button-name?application=RuleDescription) | Ensures input buttons have discernible text | Critical | cat.name-role-value, wcag2a, wcag412, section508, section508.22.a | failure, needs review | |
-| [input-image-alt](https://dequeuniversity.com/rules/axe/4.3/input-image-alt?application=RuleDescription) | Ensures <input type="image"> elements have alternate text | Critical | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [59796f](https://act-rules.github.io/rules/59796f) |
-| [label](https://dequeuniversity.com/rules/axe/4.3/label?application=RuleDescription) | Ensures every form element has a label | Minor, Critical | cat.forms, wcag2a, wcag412, wcag131, section508, section508.22.n, ACT | failure, needs review | [e086e5](https://act-rules.github.io/rules/e086e5), [307n5z](https://act-rules.github.io/rules/307n5z) |
-| [link-name](https://dequeuniversity.com/rules/axe/4.3/link-name?application=RuleDescription) | Ensures links have discernible text | Serious | cat.name-role-value, wcag2a, wcag412, wcag244, section508, section508.22.a, ACT | failure, needs review | [c487ae](https://act-rules.github.io/rules/c487ae) |
-| [list](https://dequeuniversity.com/rules/axe/4.3/list?application=RuleDescription) | Ensures that lists are structured correctly | Serious | cat.structure, wcag2a, wcag131 | failure | |
-| [listitem](https://dequeuniversity.com/rules/axe/4.3/listitem?application=RuleDescription) | Ensures <li> elements are used semantically | Serious | cat.structure, wcag2a, wcag131 | failure | |
-| [marquee](https://dequeuniversity.com/rules/axe/4.3/marquee?application=RuleDescription) | Ensures <marquee> elements are not used | Serious | cat.parsing, wcag2a, wcag222 | failure | |
-| [meta-refresh](https://dequeuniversity.com/rules/axe/4.3/meta-refresh?application=RuleDescription) | Ensures <meta http-equiv="refresh"> is not used | Critical | cat.time-and-media, wcag2a, wcag221, wcag224, wcag325 | failure | |
-| [nested-interactive](https://dequeuniversity.com/rules/axe/4.3/nested-interactive?application=RuleDescription) | Ensures interactive controls are not nested as they are not always announced by screen readers or can cause focus problems for assistive technologies | Serious | cat.keyboard, wcag2a, wcag412 | failure, needs review | [307n5z](https://act-rules.github.io/rules/307n5z) |
-| [object-alt](https://dequeuniversity.com/rules/axe/4.3/object-alt?application=RuleDescription) | Ensures <object> elements have alternate text | Serious | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a | failure, needs review | [8fc3b6](https://act-rules.github.io/rules/8fc3b6) |
-| [role-img-alt](https://dequeuniversity.com/rules/axe/4.3/role-img-alt?application=RuleDescription) | Ensures [role='img'] elements have alternate text | Serious | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [23a2a8](https://act-rules.github.io/rules/23a2a8) |
-| [scrollable-region-focusable](https://dequeuniversity.com/rules/axe/4.3/scrollable-region-focusable?application=RuleDescription) | Ensure elements that have scrollable content are accessible by keyboard | Moderate | cat.keyboard, wcag2a, wcag211 | failure | [0ssw9k](https://act-rules.github.io/rules/0ssw9k) |
-| [select-name](https://dequeuniversity.com/rules/axe/4.3/select-name?application=RuleDescription) | Ensures select element has an accessible name | Minor, Critical | cat.forms, wcag2a, wcag412, wcag131, section508, section508.22.n, ACT | failure, needs review | [e086e5](https://act-rules.github.io/rules/e086e5) |
-| [server-side-image-map](https://dequeuniversity.com/rules/axe/4.3/server-side-image-map?application=RuleDescription) | Ensures that server-side image maps are not used | Minor | cat.text-alternatives, wcag2a, wcag211, section508, section508.22.f | needs review | |
-| [svg-img-alt](https://dequeuniversity.com/rules/axe/4.3/svg-img-alt?application=RuleDescription) | Ensures <svg> elements with an img, graphics-document or graphics-symbol role have an accessible text | Serious | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [7d6734](https://act-rules.github.io/rules/7d6734) |
-| [td-headers-attr](https://dequeuniversity.com/rules/axe/4.3/td-headers-attr?application=RuleDescription) | Ensure that each cell in a table that uses the headers attribute refers only to other cells in that table | Serious | cat.tables, wcag2a, wcag131, section508, section508.22.g | failure, needs review | [a25f45](https://act-rules.github.io/rules/a25f45) |
-| [th-has-data-cells](https://dequeuniversity.com/rules/axe/4.3/th-has-data-cells?application=RuleDescription) | Ensure that <th> elements and elements with role=columnheader/rowheader have data cells they describe | Serious | cat.tables, wcag2a, wcag131, section508, section508.22.g | failure, needs review | [d0f69e](https://act-rules.github.io/rules/d0f69e) |
-| [valid-lang](https://dequeuniversity.com/rules/axe/4.3/valid-lang?application=RuleDescription) | Ensures lang attributes have valid values | Serious | cat.language, wcag2aa, wcag312 | failure | |
-| [video-caption](https://dequeuniversity.com/rules/axe/4.3/video-caption?application=RuleDescription) | Ensures <video> elements have captions | Critical | cat.text-alternatives, wcag2a, wcag122, section508, section508.22.a | needs review | [eac66b](https://act-rules.github.io/rules/eac66b) |
+| Rule ID | Description | Impact | Tags | Issue Type | ACT Rules |
+| :------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- | :----------------------------------------------------------------------------------------- | :------------------------- | :----------------------------------------------------------------------------------------------------- |
+| [area-alt](https://dequeuniversity.com/rules/axe/4.3/area-alt?application=RuleDescription) | Ensures <area> elements of image maps have alternate text | Critical | cat.text-alternatives, wcag2a, wcag111, wcag244, wcag412, section508, section508.22.a, ACT | failure, needs review | [c487ae](https://act-rules.github.io/rules/c487ae) |
+| [aria-allowed-attr](https://dequeuniversity.com/rules/axe/4.3/aria-allowed-attr?application=RuleDescription) | Ensures ARIA attributes are allowed for an element's role | Serious, Critical | cat.aria, wcag2a, wcag412 | failure, needs review | [5c01ea](https://act-rules.github.io/rules/5c01ea) |
+| [aria-command-name](https://dequeuniversity.com/rules/axe/4.3/aria-command-name?application=RuleDescription) | Ensures every ARIA button, link and menuitem has an accessible name | Serious | cat.aria, wcag2a, wcag412 | failure, needs review | [97a4e1](https://act-rules.github.io/rules/97a4e1) |
+| [aria-hidden-body](https://dequeuniversity.com/rules/axe/4.3/aria-hidden-body?application=RuleDescription) | Ensures aria-hidden='true' is not present on the document body. | Critical | cat.aria, wcag2a, wcag412 | failure | |
+| [aria-hidden-focus](https://dequeuniversity.com/rules/axe/4.3/aria-hidden-focus?application=RuleDescription) | Ensures aria-hidden elements do not contain focusable elements | Serious | cat.name-role-value, wcag2a, wcag412, wcag131 | failure, needs review | [6cfa84](https://act-rules.github.io/rules/6cfa84) |
+| [aria-input-field-name](https://dequeuniversity.com/rules/axe/4.3/aria-input-field-name?application=RuleDescription) | Ensures every ARIA input field has an accessible name | Moderate, Serious | cat.aria, wcag2a, wcag412, ACT | failure, needs review | [e086e5](https://act-rules.github.io/rules/e086e5) |
+| [aria-meter-name](https://dequeuniversity.com/rules/axe/4.3/aria-meter-name?application=RuleDescription) | Ensures every ARIA meter node has an accessible name | Serious | cat.aria, wcag2a, wcag111 | failure, needs review | |
+| [aria-progressbar-name](https://dequeuniversity.com/rules/axe/4.3/aria-progressbar-name?application=RuleDescription) | Ensures every ARIA progressbar node has an accessible name | Serious | cat.aria, wcag2a, wcag111 | failure, needs review | |
+| [aria-required-attr](https://dequeuniversity.com/rules/axe/4.3/aria-required-attr?application=RuleDescription) | Ensures elements with ARIA roles have all required ARIA attributes | Critical | cat.aria, wcag2a, wcag412 | failure | |
+| [aria-required-children](https://dequeuniversity.com/rules/axe/4.3/aria-required-children?application=RuleDescription) | Ensures elements with an ARIA role that require child roles contain them | Critical | cat.aria, wcag2a, wcag131 | failure, needs review | [ff89c9](https://act-rules.github.io/rules/ff89c9) |
+| [aria-required-parent](https://dequeuniversity.com/rules/axe/4.3/aria-required-parent?application=RuleDescription) | Ensures elements with an ARIA role that require parent roles are contained by them | Critical | cat.aria, wcag2a, wcag131 | failure | [bc4a75](https://act-rules.github.io/rules/bc4a75), [ff89c9](https://act-rules.github.io/rules/ff89c9) |
+| [aria-roledescription](https://dequeuniversity.com/rules/axe/4.3/aria-roledescription?application=RuleDescription) | Ensure aria-roledescription is only used on elements with an implicit or explicit role | Serious | cat.aria, wcag2a, wcag412 | failure, needs review | |
+| [aria-roles](https://dequeuniversity.com/rules/axe/4.3/aria-roles?application=RuleDescription) | Ensures all elements with a role attribute use a valid value | Minor, Serious, Critical | cat.aria, wcag2a, wcag412 | failure, needs review | |
+| [aria-toggle-field-name](https://dequeuniversity.com/rules/axe/4.3/aria-toggle-field-name?application=RuleDescription) | Ensures every ARIA toggle field has an accessible name | Moderate, Serious | cat.aria, wcag2a, wcag412, ACT | failure, needs review | |
+| [aria-tooltip-name](https://dequeuniversity.com/rules/axe/4.3/aria-tooltip-name?application=RuleDescription) | Ensures every ARIA tooltip node has an accessible name | Serious | cat.aria, wcag2a, wcag412 | failure, needs review | |
+| [aria-valid-attr-value](https://dequeuniversity.com/rules/axe/4.3/aria-valid-attr-value?application=RuleDescription) | Ensures all ARIA attributes have valid values | Serious, Critical | cat.aria, wcag2a, wcag412 | failure, needs review | [5c01ea](https://act-rules.github.io/rules/5c01ea), [c487ae](https://act-rules.github.io/rules/c487ae) |
+| [aria-valid-attr](https://dequeuniversity.com/rules/axe/4.3/aria-valid-attr?application=RuleDescription) | Ensures attributes that begin with aria- are valid ARIA attributes | Critical | cat.aria, wcag2a, wcag412 | failure | |
+| [audio-caption](https://dequeuniversity.com/rules/axe/4.3/audio-caption?application=RuleDescription) | Ensures <audio> elements have captions | Critical | cat.time-and-media, wcag2a, wcag121, section508, section508.22.a | needs review | [c3232f](https://act-rules.github.io/rules/c3232f), [e7aa44](https://act-rules.github.io/rules/e7aa44) |
+| [blink](https://dequeuniversity.com/rules/axe/4.3/blink?application=RuleDescription) | Ensures <blink> elements are not used | Serious | cat.time-and-media, wcag2a, wcag222, section508, section508.22.j | failure | |
+| [button-name](https://dequeuniversity.com/rules/axe/4.3/button-name?application=RuleDescription) | Ensures buttons have discernible text | Critical | cat.name-role-value, wcag2a, wcag412, section508, section508.22.a, ACT | failure, needs review | [97a4e1](https://act-rules.github.io/rules/97a4e1), [m6b1q3](https://act-rules.github.io/rules/m6b1q3) |
+| [bypass](https://dequeuniversity.com/rules/axe/4.3/bypass?application=RuleDescription) | Ensures each page has at least one mechanism for a user to bypass navigation and jump straight to the content | Serious | cat.keyboard, wcag2a, wcag241, section508, section508.22.o | needs review | |
+| [color-contrast](https://dequeuniversity.com/rules/axe/4.3/color-contrast?application=RuleDescription) | Ensures the contrast between foreground and background colors meets WCAG 2 AA contrast ratio thresholds | Serious | cat.color, wcag2aa, wcag143 | failure, needs review | |
+| [definition-list](https://dequeuniversity.com/rules/axe/4.3/definition-list?application=RuleDescription) | Ensures <dl> elements are structured correctly | Serious | cat.structure, wcag2a, wcag131 | failure | |
+| [dlitem](https://dequeuniversity.com/rules/axe/4.3/dlitem?application=RuleDescription) | Ensures <dt> and <dd> elements are contained by a <dl> | Serious | cat.structure, wcag2a, wcag131 | failure | |
+| [document-title](https://dequeuniversity.com/rules/axe/4.3/document-title?application=RuleDescription) | Ensures each HTML document contains a non-empty <title> element | Serious | cat.text-alternatives, wcag2a, wcag242, ACT | failure | [2779a5](https://act-rules.github.io/rules/2779a5) |
+| [duplicate-id-active](https://dequeuniversity.com/rules/axe/4.3/duplicate-id-active?application=RuleDescription) | Ensures every id attribute value of active elements is unique | Serious | cat.parsing, wcag2a, wcag411 | failure | |
+| [duplicate-id-aria](https://dequeuniversity.com/rules/axe/4.3/duplicate-id-aria?application=RuleDescription) | Ensures every id attribute value used in ARIA and in labels is unique | Critical | cat.parsing, wcag2a, wcag411 | failure | [3ea0c8](https://act-rules.github.io/rules/3ea0c8) |
+| [duplicate-id](https://dequeuniversity.com/rules/axe/4.3/duplicate-id?application=RuleDescription) | Ensures every id attribute value is unique | Minor | cat.parsing, wcag2a, wcag411 | failure | |
+| [form-field-multiple-labels](https://dequeuniversity.com/rules/axe/4.3/form-field-multiple-labels?application=RuleDescription) | Ensures form field does not have multiple label elements | Moderate | cat.forms, wcag2a, wcag332 | needs review | |
+| [frame-focusable-content](https://dequeuniversity.com/rules/axe/4.3/frame-focusable-content?application=RuleDescription) | Ensures <frame> and <iframe> elements with focusable content do not have tabindex=-1 | Serious | cat.keyboard, wcag2a, wcag211 | failure, needs review | |
+| [frame-title](https://dequeuniversity.com/rules/axe/4.3/frame-title?application=RuleDescription) | Ensures <iframe> and <frame> elements have an accessible name | Serious | cat.text-alternatives, wcag2a, wcag241, wcag412, section508, section508.22.i | failure, needs review | |
+| [html-has-lang](https://dequeuniversity.com/rules/axe/4.3/html-has-lang?application=RuleDescription) | Ensures every HTML document has a lang attribute | Serious | cat.language, wcag2a, wcag311, ACT | failure | [b5c3f8](https://act-rules.github.io/rules/b5c3f8) |
+| [html-lang-valid](https://dequeuniversity.com/rules/axe/4.3/html-lang-valid?application=RuleDescription) | Ensures the lang attribute of the <html> element has a valid value | Serious | cat.language, wcag2a, wcag311, ACT | failure | [bf051a](https://act-rules.github.io/rules/bf051a) |
+| [html-xml-lang-mismatch](https://dequeuniversity.com/rules/axe/4.3/html-xml-lang-mismatch?application=RuleDescription) | Ensure that HTML elements with both valid lang and xml:lang attributes agree on the base language of the page | Moderate | cat.language, wcag2a, wcag311, ACT | failure | [5b7ae0](https://act-rules.github.io/rules/5b7ae0) |
+| [image-alt](https://dequeuniversity.com/rules/axe/4.3/image-alt?application=RuleDescription) | Ensures <img> elements have alternate text or a role of none or presentation | Critical | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [23a2a8](https://act-rules.github.io/rules/23a2a8) |
+| [input-button-name](https://dequeuniversity.com/rules/axe/4.3/input-button-name?application=RuleDescription) | Ensures input buttons have discernible text | Critical | cat.name-role-value, wcag2a, wcag412, section508, section508.22.a | failure, needs review | |
+| [input-image-alt](https://dequeuniversity.com/rules/axe/4.3/input-image-alt?application=RuleDescription) | Ensures <input type="image"> elements have alternate text | Critical | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [59796f](https://act-rules.github.io/rules/59796f) |
+| [label](https://dequeuniversity.com/rules/axe/4.3/label?application=RuleDescription) | Ensures every form element has a label | Minor, Critical | cat.forms, wcag2a, wcag412, wcag131, section508, section508.22.n, ACT | failure, needs review | [e086e5](https://act-rules.github.io/rules/e086e5), [307n5z](https://act-rules.github.io/rules/307n5z) |
+| [link-name](https://dequeuniversity.com/rules/axe/4.3/link-name?application=RuleDescription) | Ensures links have discernible text | Serious | cat.name-role-value, wcag2a, wcag412, wcag244, section508, section508.22.a, ACT | failure, needs review | [c487ae](https://act-rules.github.io/rules/c487ae) |
+| [list](https://dequeuniversity.com/rules/axe/4.3/list?application=RuleDescription) | Ensures that lists are structured correctly | Serious | cat.structure, wcag2a, wcag131 | failure | |
+| [listitem](https://dequeuniversity.com/rules/axe/4.3/listitem?application=RuleDescription) | Ensures <li> elements are used semantically | Serious | cat.structure, wcag2a, wcag131 | failure | |
+| [marquee](https://dequeuniversity.com/rules/axe/4.3/marquee?application=RuleDescription) | Ensures <marquee> elements are not used | Serious | cat.parsing, wcag2a, wcag222 | failure | |
+| [meta-refresh](https://dequeuniversity.com/rules/axe/4.3/meta-refresh?application=RuleDescription) | Ensures <meta http-equiv="refresh"> is not used | Critical | cat.time-and-media, wcag2a, wcag221, wcag224, wcag325 | failure | |
+| [nested-interactive](https://dequeuniversity.com/rules/axe/4.3/nested-interactive?application=RuleDescription) | Ensures interactive controls are not nested as they are not always announced by screen readers or can cause focus problems for assistive technologies | Serious | cat.keyboard, wcag2a, wcag412 | failure, needs review | [307n5z](https://act-rules.github.io/rules/307n5z) |
+| [object-alt](https://dequeuniversity.com/rules/axe/4.3/object-alt?application=RuleDescription) | Ensures <object> elements have alternate text | Serious | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a | failure, needs review | [8fc3b6](https://act-rules.github.io/rules/8fc3b6) |
+| [role-img-alt](https://dequeuniversity.com/rules/axe/4.3/role-img-alt?application=RuleDescription) | Ensures [role='img'] elements have alternate text | Serious | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [23a2a8](https://act-rules.github.io/rules/23a2a8) |
+| [scrollable-region-focusable](https://dequeuniversity.com/rules/axe/4.3/scrollable-region-focusable?application=RuleDescription) | Ensure elements that have scrollable content are accessible by keyboard | Moderate | cat.keyboard, wcag2a, wcag211 | failure | [0ssw9k](https://act-rules.github.io/rules/0ssw9k) |
+| [select-name](https://dequeuniversity.com/rules/axe/4.3/select-name?application=RuleDescription) | Ensures select element has an accessible name | Minor, Critical | cat.forms, wcag2a, wcag412, wcag131, section508, section508.22.n, ACT | failure, needs review | [e086e5](https://act-rules.github.io/rules/e086e5) |
+| [server-side-image-map](https://dequeuniversity.com/rules/axe/4.3/server-side-image-map?application=RuleDescription) | Ensures that server-side image maps are not used | Minor | cat.text-alternatives, wcag2a, wcag211, section508, section508.22.f | needs review | |
+| [svg-img-alt](https://dequeuniversity.com/rules/axe/4.3/svg-img-alt?application=RuleDescription) | Ensures <svg> elements with an img, graphics-document or graphics-symbol role have an accessible text | Serious | cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a, ACT | failure, needs review | [7d6734](https://act-rules.github.io/rules/7d6734) |
+| [td-headers-attr](https://dequeuniversity.com/rules/axe/4.3/td-headers-attr?application=RuleDescription) | Ensure that each cell in a table that uses the headers attribute refers only to other cells in that table | Serious | cat.tables, wcag2a, wcag131, section508, section508.22.g | failure, needs review | [a25f45](https://act-rules.github.io/rules/a25f45) |
+| [th-has-data-cells](https://dequeuniversity.com/rules/axe/4.3/th-has-data-cells?application=RuleDescription) | Ensure that <th> elements and elements with role=columnheader/rowheader have data cells they describe | Serious | cat.tables, wcag2a, wcag131, section508, section508.22.g | failure, needs review | [d0f69e](https://act-rules.github.io/rules/d0f69e) |
+| [valid-lang](https://dequeuniversity.com/rules/axe/4.3/valid-lang?application=RuleDescription) | Ensures lang attributes have valid values | Serious | cat.language, wcag2aa, wcag312 | failure | |
+| [video-caption](https://dequeuniversity.com/rules/axe/4.3/video-caption?application=RuleDescription) | Ensures <video> elements have captions | Critical | cat.text-alternatives, wcag2a, wcag122, section508, section508.22.a | needs review | [eac66b](https://act-rules.github.io/rules/eac66b) |
## WCAG 2.1 Level A & AA Rules
diff --git a/lib/checks/aria/deprecatedrole-evaluate.js b/lib/checks/aria/deprecatedrole-evaluate.js
new file mode 100644
index 0000000000..149d501556
--- /dev/null
+++ b/lib/checks/aria/deprecatedrole-evaluate.js
@@ -0,0 +1,21 @@
+import standards from '../../standards';
+import { getRole } from '../../commons/aria';
+
+/**
+ * Check that an elements semantic role is deprecated.
+ *
+ * Deprecated roles are taken from the `ariaRoles` standards object from the roles `deprecated` property.
+ *
+ * @memberof checks
+ * @return {Boolean} True if the elements semantic role is deprecated. False otherwise.
+ */
+export default function deprecatedroleEvaluate(node, options, virtualNode) {
+ const role = getRole(virtualNode, { dpub: true, fallback: true });
+ const roleDefinition = standards.ariaRoles[role];
+ if (!roleDefinition?.deprecated) {
+ return false;
+ }
+
+ this.data(role);
+ return true;
+}
diff --git a/lib/checks/aria/deprecatedrole.json b/lib/checks/aria/deprecatedrole.json
new file mode 100644
index 0000000000..8c9aee4c9c
--- /dev/null
+++ b/lib/checks/aria/deprecatedrole.json
@@ -0,0 +1,11 @@
+{
+ "id": "deprecatedrole",
+ "evaluate": "deprecatedrole-evaluate",
+ "metadata": {
+ "impact": "minor",
+ "messages": {
+ "pass": "ARIA role is not deprecated",
+ "fail": "The role used is deprecated: ${data.values}"
+ }
+ }
+}
diff --git a/lib/core/base/metadata-function-map.js b/lib/core/base/metadata-function-map.js
index 362d57c362..608d93dacb 100644
--- a/lib/core/base/metadata-function-map.js
+++ b/lib/core/base/metadata-function-map.js
@@ -13,6 +13,7 @@ import ariaRoledescriptionEvaluate from '../../checks/aria/aria-roledescription-
import ariaUnsupportedAttrEvaluate from '../../checks/aria/aria-unsupported-attr-evaluate';
import ariaValidAttrEvaluate from '../../checks/aria/aria-valid-attr-evaluate';
import ariaValidAttrValueEvaluate from '../../checks/aria/aria-valid-attr-value-evaluate';
+import deprecatedroleEvaluate from '../../checks/aria/deprecatedrole-evaluate';
import fallbackroleEvaluate from '../../checks/aria/fallbackrole-evaluate';
import hasGlobalAriaAttributeEvaluate from '../../checks/aria/has-global-aria-attribute-evaluate';
import hasImplicitChromiumRoleMatches from '../../rules/has-implicit-chromium-role-matches';
@@ -191,6 +192,7 @@ const metadataFunctionMap = {
'aria-unsupported-attr-evaluate': ariaUnsupportedAttrEvaluate,
'aria-valid-attr-evaluate': ariaValidAttrEvaluate,
'aria-valid-attr-value-evaluate': ariaValidAttrValueEvaluate,
+ 'deprecatedrole-evaluate': deprecatedroleEvaluate,
'fallbackrole-evaluate': fallbackroleEvaluate,
'has-global-aria-attribute-evaluate': hasGlobalAriaAttributeEvaluate,
'has-implicit-chromium-role-matches': hasImplicitChromiumRoleMatches,
diff --git a/lib/rules/aria-roles.json b/lib/rules/aria-roles.json
index 82d7749dde..a8ac21dc4c 100644
--- a/lib/rules/aria-roles.json
+++ b/lib/rules/aria-roles.json
@@ -9,5 +9,11 @@
},
"all": [],
"any": [],
- "none": ["fallbackrole", "invalidrole", "abstractrole", "unsupportedrole"]
+ "none": [
+ "fallbackrole",
+ "invalidrole",
+ "abstractrole",
+ "unsupportedrole",
+ "deprecatedrole"
+ ]
}
diff --git a/lib/standards/dpub-roles.js b/lib/standards/dpub-roles.js
index 8354fb1823..820553cef0 100644
--- a/lib/standards/dpub-roles.js
+++ b/lib/standards/dpub-roles.js
@@ -28,18 +28,17 @@ const dpubRoles = {
},
'doc-biblioentry': {
type: 'listitem',
- requiredContext: ['doc-bibliography'],
allowedAttrs: [
'aria-expanded',
'aria-level',
'aria-posinset',
'aria-setsize'
],
- superclassRole: ['listitem']
+ superclassRole: ['listitem'],
+ deprecated: true
},
'doc-bibliography': {
type: 'landmark',
- requiredOwned: ['doc-biblioentry'],
allowedAttrs: ['aria-expanded'],
superclassRole: ['landmark']
},
@@ -86,7 +85,6 @@ const dpubRoles = {
},
'doc-endnote': {
type: 'listitem',
- requiredContext: ['doc-endnotes'],
allowedAttrs: [
'aria-expanded',
'aria-level',
@@ -97,9 +95,9 @@ const dpubRoles = {
},
'doc-endnotes': {
type: 'landmark',
- requiredOwned: ['doc-endnote'],
allowedAttrs: ['aria-expanded'],
- superclassRole: ['landmark']
+ superclassRole: ['landmark'],
+ deprecated: true
},
'doc-epigraph': {
type: 'section',
@@ -133,7 +131,6 @@ const dpubRoles = {
},
'doc-glossary': {
type: 'landmark',
- requiredOwned: ['definition', 'term'],
allowedAttrs: ['aria-expanded'],
superclassRole: ['landmark']
},
diff --git a/test/checks/aria/deprecatedrole.js b/test/checks/aria/deprecatedrole.js
new file mode 100644
index 0000000000..566594d2ca
--- /dev/null
+++ b/test/checks/aria/deprecatedrole.js
@@ -0,0 +1,93 @@
+describe('deprecatedrole', function() {
+ 'use strict';
+
+ var checkContext = axe.testUtils.MockCheckContext();
+ var checkSetup = axe.testUtils.checkSetup;
+ var checkEvaluate = axe.testUtils.getCheckEvaluate('deprecatedrole');
+ afterEach(function () {
+ checkContext.reset();
+ axe.reset();
+ })
+
+ it('returns true if applied to a deprecated role', function() {
+ axe.configure({
+ standards: {
+ ariaRoles: {
+ melon: {
+ type: 'widget',
+ deprecated: true
+ }
+ }
+ }
+ });
+ var params = checkSetup('Contents
');
+ assert.isTrue(checkEvaluate.apply(checkContext, params));
+ assert.deepEqual(checkContext._data, 'melon');
+ });
+
+ it('returns true if applied to a deprecated DPUB role', function() {
+ axe.configure({
+ standards: {
+ ariaRoles: {
+ 'doc-fizzbuzz': {
+ type: 'widget',
+ deprecated: true
+ }
+ }
+ }
+ });
+ var params = checkSetup('Contents
');
+ assert.isTrue(checkEvaluate.apply(checkContext, params));
+ assert.deepEqual(checkContext._data, 'doc-fizzbuzz');
+ });
+
+ it('returns false if applied to a non-deprecated role', function() {
+ var params = checkSetup('Contents
');
+ assert.isFalse(checkEvaluate.apply(checkContext, params));
+ assert.isNull(checkContext._data);
+
+ var params = checkSetup('');
+ assert.isFalse(checkEvaluate.apply(checkContext, params));
+ assert.isNull(checkContext._data);
+ });
+
+ it('returns false if applied to an invalid role', function() {
+ var params = checkSetup('');
+ assert.isFalse(checkEvaluate.apply(checkContext, params));
+ assert.isNull(checkContext._data);
+ });
+
+ describe('with fallback roles', function () {
+ it('returns true if the deprecated role is the first valid role', function () {
+ axe.configure({
+ standards: {
+ ariaRoles: {
+ melon: {
+ type: 'widget',
+ deprecated: true
+ }
+ }
+ }
+ });
+ var params = checkSetup('Contents
');
+ assert.isTrue(checkEvaluate.apply(checkContext, params));
+ assert.deepEqual(checkContext._data, 'melon');
+ })
+
+ it('returns false if the deprecated role is not the first valid role', function () {
+ axe.configure({
+ standards: {
+ ariaRoles: {
+ melon: {
+ type: 'widget',
+ deprecated: true
+ }
+ }
+ }
+ });
+ var params = checkSetup('Contents
');
+ assert.isFalse(checkEvaluate.apply(checkContext, params));
+ assert.isNull(checkContext._data);
+ });
+ });
+});
diff --git a/test/integration/rules/aria-required-children/aria-required-children.html b/test/integration/rules/aria-required-children/aria-required-children.html
index 0241ec6643..b411cd0d2c 100644
--- a/test/integration/rules/aria-required-children/aria-required-children.html
+++ b/test/integration/rules/aria-required-children/aria-required-children.html
@@ -23,9 +23,7 @@
-
-
-
+
+
+
\ No newline at end of file
diff --git a/test/integration/rules/aria-required-children/aria-required-children.json b/test/integration/rules/aria-required-children/aria-required-children.json
index 3e75156fb2..457c09595e 100644
--- a/test/integration/rules/aria-required-children/aria-required-children.json
+++ b/test/integration/rules/aria-required-children/aria-required-children.json
@@ -31,8 +31,6 @@
["#incomplete6"],
["#incomplete7"],
["#incomplete8"],
- ["#incomplete9"],
- ["#incomplete10"],
- ["#incomplete11"]
+ ["#incomplete9"]
]
}
diff --git a/test/integration/rules/aria-roles/aria-roles.html b/test/integration/rules/aria-roles/aria-roles.html
index 1e96194ace..8eaa284f95 100644
--- a/test/integration/rules/aria-roles/aria-roles.html
+++ b/test/integration/rules/aria-roles/aria-roles.html
@@ -72,7 +72,6 @@
ok
ok
ok
- ok
ok
ok
ok
@@ -83,7 +82,6 @@
ok
ok
ok
- ok
ok
ok
ok
@@ -134,6 +132,9 @@
fail
+
+ fail
+ fail
diff --git a/test/integration/rules/aria-roles/aria-roles.json b/test/integration/rules/aria-roles/aria-roles.json
index 1e744aa129..75257c110e 100644
--- a/test/integration/rules/aria-roles/aria-roles.json
+++ b/test/integration/rules/aria-roles/aria-roles.json
@@ -15,7 +15,9 @@
["#fail11"],
["#fail12"],
["#fail13"],
- ["#fail14"]
+ ["#fail14"],
+ ["#fail15"],
+ ["#fail16"]
],
"passes": [
["#pass1"],
@@ -91,7 +93,6 @@
["#pass72"],
["#pass73"],
["#pass74"],
- ["#pass75"],
["#pass76"],
["#pass77"],
["#pass78"],
@@ -102,7 +103,6 @@
["#pass83"],
["#pass84"],
["#pass85"],
- ["#pass86"],
["#pass87"],
["#pass88"],
["#pass89"],