Skip to content

🦾 A HTML scanner that implements accessbility rules.

Notifications You must be signed in to change notification settings

koddsson/accessibility-scanner

Repository files navigation

accessbility-scanner

AXE Rules

WCAG 2.0 Level A & AA Rules

Implemented Id Url Description Impact Tags Issue type Act rules
area-alt https://dequeuniversity.com/rules/axe/4.4/area-alt?application=RuleDescription Ensures <area> elements of image maps have alternate text Critical cat.text-alternatives, wcag2a, wcag244, wcag412, section508, section508.22.a, ACT failure, needs review c487ae
aria-allowed-attr https://dequeuniversity.com/rules/axe/4.4/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
aria-command-name https://dequeuniversity.com/rules/axe/4.4/aria-command-name?application=RuleDescription Ensures every ARIA button, link and menuitem has an accessible name Serious cat.aria, wcag2a, wcag412, ACT failure, needs review 97a4e1
aria-hidden-body https://dequeuniversity.com/rules/axe/4.4/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.4/aria-hidden-focus?application=RuleDescription Ensures aria-hidden elements are not focusable nor contain focusable elements Serious cat.name-role-value, wcag2a, wcag412 failure, needs review 6cfa84
aria-input-field-name https://dequeuniversity.com/rules/axe/4.4/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
aria-meter-name https://dequeuniversity.com/rules/axe/4.4/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.4/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.4/aria-required-attr?application=RuleDescription Ensures elements with ARIA roles have all required ARIA attributes Critical cat.aria, wcag2a, wcag412 failure 4e8ab6
aria-required-children https://dequeuniversity.com/rules/axe/4.4/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 bc4a75
aria-required-parent https://dequeuniversity.com/rules/axe/4.4/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 ff89c9
aria-roledescription https://dequeuniversity.com/rules/axe/4.4/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.4/aria-roles?application=RuleDescription Ensures all elements with a role attribute use a valid value Minor, Serious, Critical cat.aria, wcag2a, wcag412 failure 674b10
aria-toggle-field-name https://dequeuniversity.com/rules/axe/4.4/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 e086e5
aria-tooltip-name https://dequeuniversity.com/rules/axe/4.4/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.4/aria-valid-attr-value?application=RuleDescription Ensures all ARIA attributes have valid values Serious, Critical cat.aria, wcag2a, wcag412 failure, needs review 6a7281
aria-valid-attr https://dequeuniversity.com/rules/axe/4.4/aria-valid-attr?application=RuleDescription Ensures attributes that begin with aria- are valid ARIA attributes Critical cat.aria, wcag2a, wcag412 failure 5f99a7
audio-caption https://dequeuniversity.com/rules/axe/4.4/audio-caption?application=RuleDescription Ensures <audio> elements have captions Critical cat.time-and-media, wcag2a, wcag121, section508, section508.22.a needs review 2eb176, afb423
blink https://dequeuniversity.com/rules/axe/4.4/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.4/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, m6b1q3
bypass https://dequeuniversity.com/rules/axe/4.4/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 cf77f2, 047fe0, b40fd1, 3e12e1, ye5d6e
color-contrast https://dequeuniversity.com/rules/axe/4.4/color-contrast?application=RuleDescription Ensures the contrast between foreground and background colors meets WCAG 2 AA contrast ratio thresholds Serious cat.color, wcag2aa, wcag143, ACT failure, needs review afw4f7
definition-list https://dequeuniversity.com/rules/axe/4.4/definition-list?application=RuleDescription Ensures <dl> elements are structured correctly Serious cat.structure, wcag2a, wcag131 failure
dlitem https://dequeuniversity.com/rules/axe/4.4/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.4/document-title?application=RuleDescription Ensures each HTML document contains a non-empty <title> element Serious cat.text-alternatives, wcag2a, wcag242, ACT failure 2779a5
duplicate-id-active https://dequeuniversity.com/rules/axe/4.4/duplicate-id-active?application=RuleDescription Ensures every id attribute value of active elements is unique Serious cat.parsing, wcag2a, wcag411 failure 3ea0c8
duplicate-id-aria https://dequeuniversity.com/rules/axe/4.4/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
duplicate-id https://dequeuniversity.com/rules/axe/4.4/duplicate-id?application=RuleDescription Ensures every id attribute value is unique Minor cat.parsing, wcag2a, wcag411 failure 3ea0c8
form-field-multiple-labels https://dequeuniversity.com/rules/axe/4.4/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.4/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 akn7bn
frame-title-unique https://dequeuniversity.com/rules/axe/4.4/frame-title-unique?application=RuleDescription Ensures <iframe> and <frame> elements contain a unique title attribute Serious cat.text-alternatives, wcag412, wcag2a needs review 4b1c6c
frame-title https://dequeuniversity.com/rules/axe/4.4/frame-title?application=RuleDescription Ensures <iframe> and <frame> elements have an accessible name Serious cat.text-alternatives, wcag2a, wcag412, section508, section508.22.i failure, needs review cae760
html-has-lang https://dequeuniversity.com/rules/axe/4.4/html-has-lang?application=RuleDescription Ensures every HTML document has a lang attribute Serious cat.language, wcag2a, wcag311, ACT failure b5c3f8
html-lang-valid https://dequeuniversity.com/rules/axe/4.4/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
html-xml-lang-mismatch https://dequeuniversity.com/rules/axe/4.4/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
image-alt https://dequeuniversity.com/rules/axe/4.4/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
input-button-name https://dequeuniversity.com/rules/axe/4.4/input-button-name?application=RuleDescription Ensures input buttons have discernible text Critical cat.name-role-value, wcag2a, wcag412, section508, section508.22.a, ACT failure, needs review 97a4e1
input-image-alt https://dequeuniversity.com/rules/axe/4.4/input-image-alt?application=RuleDescription Ensures <input type="image"> elements have alternate text Critical cat.text-alternatives, wcag2a, wcag111, wcag412, section508, section508.22.a, ACT failure, needs review 59796f
label https://dequeuniversity.com/rules/axe/4.4/label?application=RuleDescription Ensures every form element has a label Minor, Critical cat.forms, wcag2a, wcag412, section508, section508.22.n, ACT failure, needs review e086e5
link-name https://dequeuniversity.com/rules/axe/4.4/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
list https://dequeuniversity.com/rules/axe/4.4/list?application=RuleDescription Ensures that lists are structured correctly Serious cat.structure, wcag2a, wcag131 failure
listitem https://dequeuniversity.com/rules/axe/4.4/listitem?application=RuleDescription Ensures <li> elements are used semantically Serious cat.structure, wcag2a, wcag131 failure
marquee https://dequeuniversity.com/rules/axe/4.4/marquee?application=RuleDescription Ensures <marquee> elements are not used Serious cat.parsing, wcag2a, wcag222 failure
meta-refresh https://dequeuniversity.com/rules/axe/4.4/meta-refresh?application=RuleDescription Ensures <meta http-equiv="refresh"> is not used for delayed refresh Critical cat.time-and-media, wcag2a, wcag221 failure bc659a
nested-interactive https://dequeuniversity.com/rules/axe/4.4/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
no-autoplay-audio https://dequeuniversity.com/rules/axe/4.4/no-autoplay-audio?application=RuleDescription Ensures <video> or <audio> elements do not autoplay audio for more than 3 seconds without a control mechanism to stop or mute the audio Moderate cat.time-and-media, wcag2a, wcag142, ACT needs review 80f0bf
object-alt https://dequeuniversity.com/rules/axe/4.4/object-alt?application=RuleDescription Ensures <object> elements have alternate text Serious cat.text-alternatives, wcag2a, wcag111, section508, section508.22.a failure, needs review 8fc3b6
role-img-alt https://dequeuniversity.com/rules/axe/4.4/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
scrollable-region-focusable https://dequeuniversity.com/rules/axe/4.4/scrollable-region-focusable?application=RuleDescription Ensure elements that have scrollable content are accessible by keyboard Moderate cat.keyboard, wcag2a, wcag211 failure 0ssw9k
select-name https://dequeuniversity.com/rules/axe/4.4/select-name?application=RuleDescription Ensures select element has an accessible name Minor, Critical cat.forms, wcag2a, wcag412, section508, section508.22.n, ACT failure, needs review e086e5
server-side-image-map https://dequeuniversity.com/rules/axe/4.4/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.4/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
td-headers-attr https://dequeuniversity.com/rules/axe/4.4/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
th-has-data-cells https://dequeuniversity.com/rules/axe/4.4/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
valid-lang https://dequeuniversity.com/rules/axe/4.4/valid-lang?application=RuleDescription Ensures lang attributes have valid values Serious cat.language, wcag2aa, wcag312, ACT failure de46e4
video-caption https://dequeuniversity.com/rules/axe/4.4/video-caption?application=RuleDescription Ensures <video> elements have captions Critical cat.text-alternatives, wcag2a, wcag122, section508, section508.22.a needs review eac66b

WCAG 2.1 Level A & AA Rules

Implemented Id Url Description Impact Tags Issue type Act rules
autocomplete-valid https://dequeuniversity.com/rules/axe/4.4/autocomplete-valid?application=RuleDescription Ensure the autocomplete attribute is correct and suitable for the form field Serious cat.forms, wcag21aa, wcag135, ACT failure 73f2c2
avoid-inline-spacing https://dequeuniversity.com/rules/axe/4.4/avoid-inline-spacing?application=RuleDescription Ensure that text spacing set through style attributes can be adjusted with custom stylesheets Serious cat.structure, wcag21aa, wcag1412, ACT failure 24afc2, 9e45ec, 78fd32
target-size https://dequeuniversity.com/rules/axe/4.4/target-size?application=RuleDescription Ensure touch target have sufficient size and space Serious wcag22aa, sc258, cat.sensory-and-visual-cues failure

Best Practices Rules

Rules that do not necessarily conform to WCAG success criterion but are industry accepted practices that improve the user experience.

Implemented Id Url Description Impact Tags Issue type Act rules
accesskeys https://dequeuniversity.com/rules/axe/4.4/accesskeys?application=RuleDescription Ensures every accesskey attribute value is unique Serious cat.keyboard, best-practice failure
aria-allowed-role https://dequeuniversity.com/rules/axe/4.4/aria-allowed-role?application=RuleDescription Ensures role attribute has an appropriate value for the element Minor cat.aria, best-practice failure, needs review
aria-dialog-name https://dequeuniversity.com/rules/axe/4.4/aria-dialog-name?application=RuleDescription Ensures every ARIA dialog and alertdialog node has an accessible name Serious cat.aria, best-practice failure, needs review
aria-text https://dequeuniversity.com/rules/axe/4.4/aria-text?application=RuleDescription Ensures "role=text" is used on elements with no focusable descendants Serious cat.aria, best-practice failure, needs review
aria-treeitem-name https://dequeuniversity.com/rules/axe/4.4/aria-treeitem-name?application=RuleDescription Ensures every ARIA treeitem node has an accessible name Serious cat.aria, best-practice failure, needs review
empty-heading https://dequeuniversity.com/rules/axe/4.4/empty-heading?application=RuleDescription Ensures headings have discernible text Minor cat.name-role-value, best-practice failure, needs review ffd0e9
empty-table-header https://dequeuniversity.com/rules/axe/4.4/empty-table-header?application=RuleDescription Ensures table headers have discernible text Minor cat.name-role-value, best-practice failure, needs review
frame-tested https://dequeuniversity.com/rules/axe/4.4/frame-tested?application=RuleDescription Ensures <iframe> and <frame> elements contain the axe-core script Critical cat.structure, review-item, best-practice failure, needs review
heading-order https://dequeuniversity.com/rules/axe/4.4/heading-order?application=RuleDescription Ensures the order of headings is semantically correct Moderate cat.semantics, best-practice failure, needs review
image-redundant-alt https://dequeuniversity.com/rules/axe/4.4/image-redundant-alt?application=RuleDescription Ensure image alternative is not repeated as text Minor cat.text-alternatives, best-practice failure
label-title-only https://dequeuniversity.com/rules/axe/4.4/label-title-only?application=RuleDescription Ensures that every form element has a visible label and is not solely labeled using hidden labels, or the title or aria-describedby attributes Serious cat.forms, best-practice failure
landmark-banner-is-top-level https://dequeuniversity.com/rules/axe/4.4/landmark-banner-is-top-level?application=RuleDescription Ensures the banner landmark is at top level Moderate cat.semantics, best-practice failure
landmark-complementary-is-top-level https://dequeuniversity.com/rules/axe/4.4/landmark-complementary-is-top-level?application=RuleDescription Ensures the complementary landmark or aside is at top level Moderate cat.semantics, best-practice failure
landmark-contentinfo-is-top-level https://dequeuniversity.com/rules/axe/4.4/landmark-contentinfo-is-top-level?application=RuleDescription Ensures the contentinfo landmark is at top level Moderate cat.semantics, best-practice failure
landmark-main-is-top-level https://dequeuniversity.com/rules/axe/4.4/landmark-main-is-top-level?application=RuleDescription Ensures the main landmark is at top level Moderate cat.semantics, best-practice failure
landmark-no-duplicate-banner https://dequeuniversity.com/rules/axe/4.4/landmark-no-duplicate-banner?application=RuleDescription Ensures the document has at most one banner landmark Moderate cat.semantics, best-practice failure
landmark-no-duplicate-contentinfo https://dequeuniversity.com/rules/axe/4.4/landmark-no-duplicate-contentinfo?application=RuleDescription Ensures the document has at most one contentinfo landmark Moderate cat.semantics, best-practice failure
landmark-no-duplicate-main https://dequeuniversity.com/rules/axe/4.4/landmark-no-duplicate-main?application=RuleDescription Ensures the document has at most one main landmark Moderate cat.semantics, best-practice failure
landmark-one-main https://dequeuniversity.com/rules/axe/4.4/landmark-one-main?application=RuleDescription Ensures the document has a main landmark Moderate cat.semantics, best-practice failure
landmark-unique https://dequeuniversity.com/rules/axe/4.4/landmark-unique?application=RuleDescription Landmarks should have a unique role or role/label/title (i.e. accessible name) combination Moderate cat.semantics, best-practice failure
meta-viewport-large https://dequeuniversity.com/rules/axe/4.4/meta-viewport-large?application=RuleDescription Ensures <meta name="viewport"> can scale a significant amount Minor cat.sensory-and-visual-cues, best-practice failure
meta-viewport https://dequeuniversity.com/rules/axe/4.4/meta-viewport?application=RuleDescription Ensures <meta name="viewport"> does not disable text scaling and zooming Critical cat.sensory-and-visual-cues, best-practice, ACT failure b4f0c3
page-has-heading-one https://dequeuniversity.com/rules/axe/4.4/page-has-heading-one?application=RuleDescription Ensure that the page, or at least one of its frames contains a level-one heading Moderate cat.semantics, best-practice failure
presentation-role-conflict https://dequeuniversity.com/rules/axe/4.4/presentation-role-conflict?application=RuleDescription Flags elements whose role is none or presentation and which cause the role conflict resolution to trigger. Minor cat.aria, best-practice, ACT failure 46ca7f
region https://dequeuniversity.com/rules/axe/4.4/region?application=RuleDescription Ensures all page content is contained by landmarks Moderate cat.keyboard, best-practice failure
scope-attr-valid https://dequeuniversity.com/rules/axe/4.4/scope-attr-valid?application=RuleDescription Ensures the scope attribute is used correctly on tables Moderate, Critical cat.tables, best-practice failure
skip-link https://dequeuniversity.com/rules/axe/4.4/skip-link?application=RuleDescription Ensure all skip links have a focusable target Moderate cat.keyboard, best-practice failure, needs review
tabindex https://dequeuniversity.com/rules/axe/4.4/tabindex?application=RuleDescription Ensures tabindex attribute values are not greater than 0 Serious cat.keyboard, best-practice failure
table-duplicate-name https://dequeuniversity.com/rules/axe/4.4/table-duplicate-name?application=RuleDescription Ensure the <caption> element does not contain the same text as the summary attribute Minor cat.tables, best-practice failure, needs review

WCAG 2.0 and 2.1 level AAA rules

Rules that check for conformance to WCAG AAA success criteria that can be fully automated. These are disabled by default in axe-core.

Implemented Id Url Description Impact Tags Issue type Act rules
color-contrast-enhanced https://dequeuniversity.com/rules/axe/4.4/color-contrast-enhanced?application=RuleDescription Ensures the contrast between foreground and background colors meets WCAG 2 AAA contrast ratio thresholds Serious cat.color, wcag2aaa, wcag146, ACT failure, needs review 09o5cg
identical-links-same-purpose https://dequeuniversity.com/rules/axe/4.4/identical-links-same-purpose?application=RuleDescription Ensure that links with the same accessible name serve a similar purpose Minor cat.semantics, wcag2aaa, wcag249 needs review b20e66
meta-refresh-no-exceptions https://dequeuniversity.com/rules/axe/4.4/meta-refresh-no-exceptions?application=RuleDescription Ensures <meta http-equiv="refresh"> is not used for delayed refresh Minor cat.time-and-media, wcag2aaa, wcag224, wcag325 failure bisz58

Experimental Rules

Rules we are still testing and developing. They are disabled by default in axe-core, but are enabled for the axe browser extensions.

Implemented Id Url Description Impact Tags Issue type Act rules
css-orientation-lock https://dequeuniversity.com/rules/axe/4.4/css-orientation-lock?application=RuleDescription Ensures content is not locked to any specific display orientation, and the content is operable in all display orientations Serious cat.structure, wcag134, wcag21aa, experimental failure, needs review b33eff
focus-order-semantics https://dequeuniversity.com/rules/axe/4.4/focus-order-semantics?application=RuleDescription Ensures elements in the focus order have a role appropriate for interactive content Minor cat.keyboard, best-practice, experimental failure
hidden-content https://dequeuniversity.com/rules/axe/4.4/hidden-content?application=RuleDescription Informs users about hidden content. Minor cat.structure, experimental, review-item, best-practice failure, needs review
label-content-name-mismatch https://dequeuniversity.com/rules/axe/4.4/label-content-name-mismatch?application=RuleDescription Ensures that elements labelled through their content must have their visible text as part of their accessible name Serious cat.semantics, wcag21a, wcag253, experimental failure 2ee8b8
link-in-text-block https://dequeuniversity.com/rules/axe/4.4/link-in-text-block?application=RuleDescription Ensure links are distinguished from surrounding text in a way that does not rely on color Serious cat.color, experimental, wcag2a, wcag141 failure, needs review
p-as-heading https://dequeuniversity.com/rules/axe/4.4/p-as-heading?application=RuleDescription Ensure bold, italic text and font-size is not used to style <p> elements as a heading Serious cat.semantics, wcag2a, wcag131, experimental failure, needs review
table-fake-caption https://dequeuniversity.com/rules/axe/4.4/table-fake-caption?application=RuleDescription Ensure that tables with a caption use the <caption> element. Serious cat.tables, experimental, wcag2a, wcag131, section508, section508.22.g failure
td-has-header https://dequeuniversity.com/rules/axe/4.4/td-has-header?application=RuleDescription Ensure that each non-empty data cell in a <table> larger than 3 by 3 has one or more table headers Critical cat.tables, experimental, wcag2a, wcag131, section508, section508.22.g failure