After you click to install the plugin, there will be a slight pause to download additional requirements before axe DevTools Linter starts. Configuring the plugin isn't necessary, but if you want to change its behavior, see the next section, Configuration.
Configuration
You can add a file called axe-linter.yml at your project's root level to configure linting:
You can exclude files using wildcards. See Configuration File for more information.
axe-linter.yml Example
rules:
heading-order: false # Disable this rule
exclude:
- 'tests/**/*.html' # Skip files
global-components:
AxeButton: button # Lint as though it was a
Available Rules
axe DevTools Linter includes rules for WCAG 2.0 and WCAG 2.1 Level A and AA, as well as a few best practices. For a complete list of the rules, see axe DevTools Linter Accessibility Rules.
Custom Components
You can configure axe DevTools Linter to understand your custom components and ensure they are being used in a way that keeps your application accessible. We have standard mappings for Material UI (mui) and React Native that can be pulled in with a simple configuration change. For information on using the plugin with your custom components, see Linting Custom Components
Component Libraries
You can tell axe DevTools Linter which component library your project uses. Doing so enables the built-in custom component mapping for that library and some rules exclusive to this library. axe DevTools Linter supports several popular component libraries, including Material UI and React Native. Read Global Components Libraries for details.
Axe Linter in other tools
In addition to running axe DevTools Linter in Visual Studio Code, axe DevTools Linter is also available as an API or as an on-prem installable server. The API requires a key, which you can get with a free trial.
To use the pre-commit hook to block GitHub commits which contain accessibility errors, see Using the Git Pre-Commit Hook.
SonarQube
Integrating axe DevTools Linter with SonarQube allows you to track accessibility issues in SonarQube's dashboard and monitor your code's accessibility over time. For setup information, see SonarQube and axe DevTools Linter.
Jenkins
If you use Jenkins, you can automatically check for accessibility problems with each Jenkins build. For more information, see Jenkins and axe DevTools Linter.
To contact the axe DevTools Linter development team and other axe DevTools Linter users, join our accessibility Slack channel.
Telemetry
axe DevTools Linter gathers minimal telemetry to monitor the plugin's heartbeat. The collected data is limited to the date and time of scans, the axe DevTools Linter engine version, and the application that reported the data (axe DevTools Linter). We've also added telemetry to gather all error messages as needed to help provide a better end-user experience.
Deque Trademarks Policy
DEQUE, DEQUELABS, AXE®, and AXE-CORE® are trademarks of Deque Systems, Inc. Use of the Deque trademarks must be in accordance with Deque's trademark policy.
