@acot/acot-runner-storybook
Advanced tools
An acot custom runner for Storybook.
Weekly downloads
Changelog
0.0.18 (2022-05-11)
ignore
option to dialog-focus
rule (959bcbc)ignore
option to img-has-name
rule (36a152e)ignore
option to interactive-has-enough-size
rule (640a0aa)ignore
option to interactive-has-name
rule (bcf6119)ignore
option to interactive-supports-focus
rule (a563858)ignore
option to link-has-name
rule (97e01a5)isElementMatches
utilify function (53c4c58)Readme
An acot custom runner for Storybook.
The @acot/acot-runner-storybook
crawls all the Stories in Storybook and sets them up for acot to audit.
Install via npm:
$ npm install --save-dev @acot/acot-runner-storybook
Add @acot/storybook
to the runner
field of the configuration file.
{
"runner": "@acot/storybook"
}
You can pass a custom config to the parameters.acot
field in Story's metadata, as in the following example:
// Component Story Format (CSF) Example:
export default {
title: 'Button',
component: Button,
parameters: {
acot: {
rules: {
'@acot/wcag/button-has-name': 'off',
},
},
},
};
include
Type: string[]
Required: false
The Story name pattern to include in the audit target. See the micromatch documentation for pattern strings.
{
"runner": {
"uses": "@acot/storybook",
"with": {
"include": ["*", "/atoms/**/*"]
}
}
}
exclude
Type: string[]
Required: false
The Story name pattern to exclude in the audit target. See the micromatch documentation for pattern strings.
{
"runner": {
"uses": "@acot/storybook",
"with": {
"exclude": ["/utils/**/*"]
}
}
}
timeout
Type: number
Default: 60000
Required: false
Maximum time in milliseconds to wait for the browser instance to collect stories.
{
"runner": {
"uses": "@acot/storybook",
"with": {
"timeout": 120000
}
}
}
Since @acot/acot-runner-storybook
doesn't rely on UI frameworks like React, Angular, or Vue.js, it can be used in conjunction with any UI framework of your choice!