Skip to content

jsx_a11y/alt-text Correctness ​

✅ This rule is turned on by default.

What it does ​

Enforce that all elements that require alternative text have meaningful information to relay back to the end user.

Why is this necessary? ​

Alternative text is a critical component of accessibility for screen reader users, enabling them to understand the content and function of an element.

What it checks ​

This rule checks for alternative text on the following elements: <img>, <area>, <input type="image">, and <object>.

How to fix it ​

Ensure that the alt attribute is present and contains meaningful text that describes the element's content or purpose.

Example ​

Examples of incorrect code for this rule:

jsx
<img src="flower.jpg" alt="A close-up of a white daisy" />

Examples of correct code for this rule:

jsx
<img src="flower.jpg" />

How to use ​

To enable this rule in the CLI or using the config file, you can use:

bash
oxlint --deny jsx-a11y/alt-text --jsx-a11y-plugin
json
{
  "plugins": ["jsx-a11y"],
  "rules": {
    "jsx-a11y/alt-text": "error"
  }
}

References ​

Released under the MIT License.