Nebulous Puffy Marshmallows
Wondering what’s next for npm?Check out our public roadmap! »

@modus/gimbal-plugin-axe

1.2.6 • Public • Published

Gimbal axe Plugin

npm (scoped) npm CircleCI PRs Welcome MIT Licensed Powered by Modus_Create

The axe plugin adds axe auditing to Gimbal. This plugin will check for violations reported by axe and check the impact of the violations against the configured thresholds.

Installation

First, you need to install the plugin to your project:

# with npm 
npm install --save-dev @modus/gimbal-plugin-axe
 
# or with yarn 
yarn add --dev @modus/gimbal-plugin-axe

Next, you need to add the plugin to your Gimbal configuration file:

YAML

plugins:
  - '@modus/gimbal-plugin-axe'

JSON

{
  "plugins": ["@modus/gimbal-plugin-axe"]
}

JavaScript

modules.exports = {
  plugins: ['@modus/gimbal-plugin-axe'],
};

Configuration

There are three configs that you can change:

  • disabledRules - An optional string or array of strings that will disable certain rules. For more, see here.
  • exclude - An optional string or array of strings that will allow certain CSS selectors to be excluded from the axe analysis. For more, see here.
  • include - An optional string or array of strings that will only allow certain CSS selectors to be included in the axe analysis. For more, see here.
  • rules - An optional string or array of strings that will only allow certain axe rules to be run in the axe analysis. For more, see here.
  • showSuccesses - If set to false, the output of the final report will now show the successful rules.
  • tags - An optional string or array of strings that will allow only the specified rule IDs in the axe analysis. For more, see here.
  • threshold - This is the object of thresholds. Each rule can have it's own threshold.

Threshold

By default, there is a single threshold that is set to minor meaning only minor violations will be allowed. Each rule can have it's own threshold defined:

plugins:
  plugin: '@modus/gimbal-plugin-axe'
    thresholds:
      bypass: serious

The acceptable levels in order from least to greater impact are: none, minor, moderate, serious, critical.

Default Configuration

plugins:
  plugin: '@modus/gimbal-plugin-axe'
    showSuccesses: true
    thresholds:
      impact: none

Install

npm i @modus/gimbal-plugin-axe

DownloadsWeekly Downloads

121

Version

1.2.6

License

MIT

Unpacked Size

16.9 kB

Total Files

5

Last publish

Collaborators

  • avatar
  • avatar
  • avatar