Skip to content

Latest commit

 

History

History
38 lines (26 loc) · 1.47 KB

no-nested-interactive.md

File metadata and controls

38 lines (26 loc) · 1.47 KB
Raw

no-nested-interactive

✅ The extends: 'recommended' property in a configuration file enables this rule.

Usage of nested, interactive content can lead to UX problems, accessibility problems, bugs, and in some cases DOM errors. You should not put interactive content elements nested inside other interactive content elements. Instead of using nested interactive content elements, you should separate them, or use styling on a single element.

Examples

This rule forbids the following (button nested inside a link):

<a href="/contact-us">
  <button type="button">
    Contact Us
  </button>
</a>

This rule allows the following (link with button styling):

<a href="/contact-us" class="button">Contact Us</a>

Configuration

The following values are valid configuration:

  • boolean -- true indicates all allowlisted tests will run, false indicates that the rule is disabled.
  • object - Containing the following values:
    • ignoredTags - An array of element tag names that should be allowlisted. Default to [].
    • ignoreTabindex - When true tabindex will be ignored. Defaults to false.
    • ignoreUsemapAttribute - When true ignores the usemap attribute on img and object elements. Defaults false.
    • additionalInteractiveTags - An array of element tag names that should also be considered as interactive. Defaults to [].

References