{"_id":"eslint-plugin-jsx-a11y","maintainers":[{"name":"ljharb","email":"ljharb@gmail.com"},{"name":"lencioni","email":"joe.lencioni@gmail.com"},{"name":"jessebeach","email":"jesse.r.beach@icloud.com"},{"name":"evcohen","email":"ethanvcohen@gmail.com"}],"keywords":["eslint","eslintplugin","eslint-plugin","a11y","accessibility","jsx"],"dist-tags":{"v5-backport":"5.1.1","latest":"6.10.2"},"author":{"name":"Ethan Cohen"},"description":"Static AST checker for accessibility rules on JSX elements.","readme":"

\n \n \"CI\n \n \n \"npm\n \n \n \"license\"\n \n \n Coverage Status\n \n \n Total npm downloads\n \n

\n\nGet professional support for eslint-plugin-jsx-a11y on Tidelift\n\n# eslint-plugin-jsx-a11y\n\nStatic AST checker for accessibility rules on JSX elements.\n\n#### _Read this in [other languages](https://github.com/ari-os310/eslint-plugin-jsx-a11y/blob/HEAD/translations/Translations.md)._\n\n[Mexican Spanish\uD83C\uDDF2\uD83C\uDDFD](https://github.com/ari-os310/eslint-plugin-jsx-a11y/blob/HEAD/translations/README.mx.md)\n\n## Why?\n\nThis plugin does a static evaluation of the JSX to spot accessibility issues in React apps. Because it only catches errors in static code, use it in combination with [@axe-core/react](https://github.com/dequelabs/axe-core-npm/tree/develop/packages/react) to test the accessibility of the rendered DOM. Consider these tools just as one step of a larger a11y testing process and always test your apps with assistive technology.\n\n## Installation\n\n**If you are installing this plugin via `eslint-config-airbnb`, please follow [these instructions](https://github.com/airbnb/javascript/tree/HEAD/packages/eslint-config-airbnb#eslint-config-airbnb-1).**\n\nYou'll first need to install [ESLint](https://eslint.org/docs/latest/user-guide/getting-started):\n\n```sh\n# npm\nnpm install eslint --save-dev\n\n# yarn\nyarn add eslint --dev\n```\n\nNext, install `eslint-plugin-jsx-a11y`:\n\n```sh\n# npm\nnpm install eslint-plugin-jsx-a11y --save-dev\n\n# yarn\nyarn add eslint-plugin-jsx-a11y --dev\n```\n\n**Note:** If you installed ESLint globally (using the `-g` flag in npm, or the `global` prefix in yarn) then you must also install `eslint-plugin-jsx-a11y` globally.\n\n\n## Usage - Legacy Config (`.eslintrc`)\n\nAdd `jsx-a11y` to the plugins section of your `.eslintrc` configuration file. You can omit the `eslint-plugin-` prefix:\n\n```json\n{\n \"plugins\": [\"jsx-a11y\"]\n}\n```\n\nThen configure the rules you want to use under the rules section.\n\n```json\n{\n \"rules\": {\n \"jsx-a11y/rule-name\": 2\n }\n}\n```\n\nYou can also enable all the recommended or strict rules at once.\nAdd `plugin:jsx-a11y/recommended` or `plugin:jsx-a11y/strict` in `extends`:\n\n```json\n{\n \"extends\": [\"plugin:jsx-a11y/recommended\"]\n}\n```\n\n### Configurations\n\n> As you are extending our configuration, you can omit `\"plugins\": [\"jsx-a11y\"]` from your `.eslintrc` configuration file.\n\n```json\n{\n \"settings\": {\n \"jsx-a11y\": {\n \"polymorphicPropName\": \"as\",\n \"components\": {\n \"CityInput\": \"input\",\n \"CustomButton\": \"button\",\n \"MyButton\": \"button\",\n \"RoundButton\": \"button\"\n },\n \"attributes\": {\n \"for\": [\"htmlFor\", \"for\"]\n }\n }\n }\n}\n```\n\n## Usage - Flat Config (`eslint.config.js`)\n\nThe default export of `eslint-plugin-jsx-a11y` is a plugin object.\n\n```js\nconst jsxA11y = require('eslint-plugin-jsx-a11y');\n\nmodule.exports = [\n …\n {\n files: ['**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mtsx}'],\n plugins: {\n 'jsx-a11y': jsxA11y,\n },\n languageOptions: {\n parserOptions: {\n ecmaFeatures: {\n jsx: true,\n },\n },\n },\n rules: {\n // ... any rules you want\n 'jsx-a11y/alt-text': 'error',\n },\n // ... others are omitted for brevity\n },\n …\n];\n```\n\n### Shareable Configs\n\nThere are two shareable configs, provided by the plugin.\n\n- `flatConfigs.recommended`\n- `flatConfigs.strict`\n\n#### CJS\n\n```js\nconst jsxA11y = require('eslint-plugin-jsx-a11y');\n\nexport default [\n jsxA11y.flatConfigs.recommended,\n {\n // Your additional configs and overrides\n },\n];\n```\n\n#### ESM\n\n```js\nimport jsxA11y from 'eslint-plugin-jsx-a11y';\n\nexport default [\n jsxA11y.flatConfigs.recommended,\n {\n // Your additional configs and overrides\n },\n];\n```\n\n**Note**: Our shareable configs do NOT configure `files` or [`languageOptions.globals`](https://eslint.org/docs/latest/user-guide/configuring/configuration-files-new#configuration-objects).\nFor most of the cases, you probably want to configure some of these properties yourself.\n\n```js\nconst jsxA11y = require('eslint-plugin-jsx-a11y');\nconst globals = require('globals');\n\nmodule.exports = [\n …\n {\n files: ['**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mtsx}'],\n ...jsxA11y.flatConfigs.recommended,\n languageOptions: {\n ...jsxA11y.flatConfigs.recommended.languageOptions,\n globals: {\n ...globals.serviceworker,\n ...globals.browser,\n },\n },\n },\n …\n];\n```\n\n#### Component Mapping\n\nTo enable your custom components to be checked as DOM elements, you can set global settings in your configuration file by mapping each custom component name to a DOM element type.\n\n#### Attribute Mapping\n\nTo configure the JSX property to use for attribute checking, you can set global settings in your configuration file by mapping each DOM attribute to the JSX property you want to check.\nFor example, you may want to allow the `for` attribute in addition to the `htmlFor` attribute for checking label associations.\n\n#### Polymorphic Components\n\nYou can optionally use the `polymorphicPropName` setting to define the prop your code uses to create polymorphic components.\nThis setting will be used determine the element type in rules that require semantic context.\n\nFor example, if you set the `polymorphicPropName` setting to `as` then this element:\n\n`Configurations `\n\nwill be evaluated as an `h3`. If no `polymorphicPropName` is set, then the component will be evaluated as `Box`.\n\nTo restrict polymorphic linting to specified components, additionally set `polymorphicAllowList` to an array of component names.\n\n⚠️ Polymorphic components can make code harder to maintain; please use this feature with caution.\n\n## Supported Rules\n\n\n\n\uD83D\uDCBC Configurations enabled in.\\\n\uD83D\uDEAB Configurations disabled in.\\\n☑️ Set in the `recommended` configuration.\\\n\uD83D\uDD12 Set in the `strict` configuration.\\\n❌ Deprecated.\n\n| Name                                          | Description | \uD83D\uDCBC | \uD83D\uDEAB | ❌ |\n| :----------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | :---- | :---- | :- |\n| [accessible-emoji](docs/rules/accessible-emoji.md) | Enforce emojis are wrapped in `` and provide screen reader access. | | | ❌ |\n| [alt-text](docs/rules/alt-text.md) | Enforce all elements that require alternative text have meaningful information to relay back to end user. | ☑️ \uD83D\uDD12 | | |\n| [anchor-ambiguous-text](docs/rules/anchor-ambiguous-text.md) | Enforce `` text to not exactly match \"click here\", \"here\", \"link\", or \"a link\". | | ☑️ | |\n| [anchor-has-content](docs/rules/anchor-has-content.md) | Enforce all anchors to contain accessible content. | ☑️ \uD83D\uDD12 | | |\n| [anchor-is-valid](docs/rules/anchor-is-valid.md) | Enforce all anchors are valid, navigable elements. | ☑️ \uD83D\uDD12 | | |\n| [aria-activedescendant-has-tabindex](docs/rules/aria-activedescendant-has-tabindex.md) | Enforce elements with aria-activedescendant are tabbable. | ☑️ \uD83D\uDD12 | | |\n| [aria-props](docs/rules/aria-props.md) | Enforce all `aria-*` props are valid. | ☑️ \uD83D\uDD12 | | |\n| [aria-proptypes](docs/rules/aria-proptypes.md) | Enforce ARIA state and property values are valid. | ☑️ \uD83D\uDD12 | | |\n| [aria-role](docs/rules/aria-role.md) | Enforce that elements with ARIA roles must use a valid, non-abstract ARIA role. | ☑️ \uD83D\uDD12 | | |\n| [aria-unsupported-elements](docs/rules/aria-unsupported-elements.md) | Enforce that elements that do not support ARIA roles, states, and properties do not have those attributes. | ☑️ \uD83D\uDD12 | | |\n| [autocomplete-valid](docs/rules/autocomplete-valid.md) | Enforce that autocomplete attributes are used correctly. | ☑️ \uD83D\uDD12 | | |\n| [click-events-have-key-events](docs/rules/click-events-have-key-events.md) | Enforce a clickable non-interactive element has at least one keyboard event listener. | ☑️ \uD83D\uDD12 | | |\n| [control-has-associated-label](docs/rules/control-has-associated-label.md) | Enforce that a control (an interactive element) has a text label. | | ☑️ \uD83D\uDD12 | |\n| [heading-has-content](docs/rules/heading-has-content.md) | Enforce heading (`h1`, `h2`, etc) elements contain accessible content. | ☑️ \uD83D\uDD12 | | |\n| [html-has-lang](docs/rules/html-has-lang.md) | Enforce `` element has `lang` prop. | ☑️ \uD83D\uDD12 | | |\n| [iframe-has-title](docs/rules/iframe-has-title.md) | Enforce iframe elements have a title attribute. | ☑️ \uD83D\uDD12 | | |\n| [img-redundant-alt](docs/rules/img-redundant-alt.md) | Enforce `` alt prop does not contain the word \"image\", \"picture\", or \"photo\". | ☑️ \uD83D\uDD12 | | |\n| [interactive-supports-focus](docs/rules/interactive-supports-focus.md) | Enforce that elements with interactive handlers like `onClick` must be focusable. | ☑️ \uD83D\uDD12 | | |\n| [label-has-associated-control](docs/rules/label-has-associated-control.md) | Enforce that a `label` tag has a text label and an associated control. | ☑️ \uD83D\uDD12 | | |\n| [label-has-for](docs/rules/label-has-for.md) | Enforce that `