the-forest/client/node_modules/eslint-plugin-jsx-a11y/docs/rules/anchor-has-content.md
2024-09-17 20:35:18 -04:00

1.6 KiB

jsx-a11y/anchor-has-content

💼 This rule is enabled in the following configs: ☑️ recommended, 🔒 strict.

Enforce that anchors have content and that the content is accessible to screen readers. Accessible means that it is not hidden using the aria-hidden prop. Refer to the references to learn about why this is important.

Alternatively, you may use the title prop or the aria-label prop.

Rule options

This rule takes one optional object argument of type object:

{
    "rules": {
        "jsx-a11y/anchor-has-content": [ 2, {
            "components": [ "Anchor" ],
          }],
    }
}

For the components option, these strings determine which JSX elements (always including <a>) should be checked for having content. This is a good use case when you have a wrapper component that simply renders an a element (like in React):

// Anchor.js
const Anchor = props => {
  return (
    <a {...props}>{ props.children }</a>
  );
}

...

// CreateAccount.js (for example)
...
return (
  <Anchor>Create Account</Anchor>
);

Succeed

<a>Anchor Content!</a>
<a><TextWrapper /></a>
<a dangerouslySetInnerHTML={{ __html: 'foo' }} />
<a title='foo' />
<a aria-label='foo' />

Fail

<a />
<a><TextWrapper aria-hidden /></a>

Accessibility guidelines

Resources