@hint/hint-axe
Version:
hint that that checks using axe for accessibility related best practices
49 lines (40 loc) • 3.45 kB
Markdown
<!-- autogenerated by scripts/create/create-docs.js -->
<!-- markdownlint-disable MD013 -->
# Axe: Semantics (`semantics`)
`axe/semantics` contains accessibility rules
from the axe semantics category.
See the ["Can the hint be configured?"][can configure] section of
`hint-axe` for examples of enabling, disabling, and changing the
severity of individual rules.
## Default rules (WCAG 2.1 Level A and Level AA)
* [Links with the same name must have a similar purpose][identical-links-same-purpose] (identical-links-same-purpose)
## Additional rules (off by default)
* [Heading levels should only increase by one][heading-order] (heading-order)
* [Elements must have their visible text as part of their accessible name][label-content-name-mismatch] (label-content-name-mismatch)
* [Banner landmark should not be contained in another landmark][landmark-banner-is-top-level] (landmark-banner-is-top-level)
* [Aside should not be contained in another landmark][landmark-complementary-is-top-level] (landmark-complementary-is-top-level)
* [Contentinfo landmark should not be contained in another landmark][landmark-contentinfo-is-top-level] (landmark-contentinfo-is-top-level)
* [Main landmark should not be contained in another landmark][landmark-main-is-top-level] (landmark-main-is-top-level)
* [Document should not have more than one banner landmark][landmark-no-duplicate-banner] (landmark-no-duplicate-banner)
* [Document should not have more than one contentinfo landmark][landmark-no-duplicate-contentinfo] (landmark-no-duplicate-contentinfo)
* [Document should not have more than one main landmark][landmark-no-duplicate-main] (landmark-no-duplicate-main)
* [Document should have one main landmark][landmark-one-main] (landmark-one-main)
* [Ensures landmarks are unique][landmark-unique] (landmark-unique)
* [Styled \<p> elements must not be used as headings][p-as-heading] (p-as-heading)
* [Page should contain a level-one heading][page-has-heading-one] (page-has-heading-one)
<!-- Link labels: -->
[can configure]: https://webhint.io/docs/user-guide/hints/hint-axe/#can-the-hint-be-configured
[heading-order]: https://dequeuniversity.com/rules/axe/4.4/heading-order
[identical-links-same-purpose]: https://dequeuniversity.com/rules/axe/4.4/identical-links-same-purpose
[label-content-name-mismatch]: https://dequeuniversity.com/rules/axe/4.4/label-content-name-mismatch
[landmark-banner-is-top-level]: https://dequeuniversity.com/rules/axe/4.4/landmark-banner-is-top-level
[landmark-complementary-is-top-level]: https://dequeuniversity.com/rules/axe/4.4/landmark-complementary-is-top-level
[landmark-contentinfo-is-top-level]: https://dequeuniversity.com/rules/axe/4.4/landmark-contentinfo-is-top-level
[landmark-main-is-top-level]: https://dequeuniversity.com/rules/axe/4.4/landmark-main-is-top-level
[landmark-no-duplicate-banner]: https://dequeuniversity.com/rules/axe/4.4/landmark-no-duplicate-banner
[landmark-no-duplicate-contentinfo]: https://dequeuniversity.com/rules/axe/4.4/landmark-no-duplicate-contentinfo
[landmark-no-duplicate-main]: https://dequeuniversity.com/rules/axe/4.4/landmark-no-duplicate-main
[landmark-one-main]: https://dequeuniversity.com/rules/axe/4.4/landmark-one-main
[landmark-unique]: https://dequeuniversity.com/rules/axe/4.4/landmark-unique
[p-as-heading]: https://dequeuniversity.com/rules/axe/4.4/p-as-heading
[page-has-heading-one]: https://dequeuniversity.com/rules/axe/4.4/page-has-heading-one