Headings must be accessible

Docs > Code Analysis > Static Analysis Rules > Headings must be accessible

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Metadata

ID: tsx-react/no-unaccessible-heading

Language: TypeScript

Severity: Warning

Category: Code Style

Description

This rule ensures that all heading elements in your TypeScript code are accessible to all users, including those using assistive technologies like screen readers. This helps ensure that your web pages are inclusive and accessible to all users, regardless of their abilities or disabilities.

In the non-compliant code example, the heading element <h1 aria-hidden>Foo</h1> is marked with the aria-hidden attribute, which hides the element from assistive technologies. This is a violation of the rule because it makes the heading inaccessible to users who rely on these technologies.

To avoid these violations, ensure that all your heading elements are visible to assistive technologies and provide useful information. Don’t use the aria-hidden attribute on them unless it’s absolutely necessary.

Non-Compliant Code Examples

function Test() {
  return (
    <>
      <h1 aria-hidden>Foo</h1>
      <h1/>
    </>
  );
}

Compliant Code Examples

function Test() {
  return (
    <h1>Foo</h1>
  );
}