@hint/hint-axe/docs/name-role-value.md

hint that that checks using axe for accessibility related best practices

<!-- autogenerated by scripts/create/create-docs.js -->
<!-- markdownlint-disable MD013 -->
# Axe: Name Role Value (`name-role-value`)

`axe/name-role-value` contains accessibility rules
from the axe name-role-value 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)

* [ARIA hidden element must not contain focusable elements][aria-hidden-focus] (aria-hidden-focus)
* [Buttons must have discernible text][button-name] (button-name)
* [Input buttons must have discernible text][input-button-name] (input-button-name)
* [Links must have discernible text][link-name] (link-name)

## Additional rules (off by default)

* [Headings should not be empty][empty-heading] (empty-heading)

<!-- Link labels: -->

[can configure]: https://webhint.io/docs/user-guide/hints/hint-axe/#can-the-hint-be-configured
[aria-hidden-focus]: https://dequeuniversity.com/rules/axe/4.4/aria-hidden-focus
[button-name]: https://dequeuniversity.com/rules/axe/4.4/button-name
[empty-heading]: https://dequeuniversity.com/rules/axe/4.4/empty-heading
[input-button-name]: https://dequeuniversity.com/rules/axe/4.4/input-button-name
[link-name]: https://dequeuniversity.com/rules/axe/4.4/link-name