New
Storybook for full-stack developersAutomate with Chromatic
Star75,299
Back to integrations
Add your integration
Categories
  • ⭐️ Popular
  • 🧩 Essentials
  • 🛠 Code
  • ⚡️ Data & state
  • ✅ Test
  • 💅 Style
  • 🎨 Design
  • ⚙️ Appearance
  • 🗄 Organize
How to install addons Create an addon
addon-screen-reader
A Screen Reader Storybook addon
npm install addon-screen-reader
Last updated over 1 year ago
16.4k
Downloads per week
Readme View on GitHub

Storybook Screen Reader Addon

Storybook Demo NPM Version Known Vulnerabilities Security Score Pipeline status Netlify Status

Addon to display a custom screen reader in the addons panel of Storybook. Allows the developers to quickly test their accessibility without need of external screen reader or complex programs.

It allows to have separate outputs for voice and text.

Disclaimer

This is a starting project with a lot of things to improve.

Only a few use cases of screen readers and keyboard navigation are covered and is not intended to replace a full test with a real screen reader.

This is a personal project, while I am improving myself in accessibility topics, to help me to understand in deep how a screen reader works, and there is no better way than try to build one by myself right?

Installation

Just like any regular NPM package.

Install as a dev dependency:

npm install -d addon-screen-reader

or

yarn add -dev addon-screen-reader

Add the addon to your addons file (usually .storybook/main.js)

module.exports = {
  addons: ['addon-screen-reader'],
};

Usage

  • Run the storybook of your project.
  • Navigate to the new "Screen Reader" tab.
  • Enable the voice / text option.
  • Navigate though your page with Alt + Tab or Option + Tab .

Demo

The CI integration of this project deploys a demo storybook in netlify, so you can check by yourself.

Demo

Feedback

All the feedback is welcome! You can create any issue in the repository and I will reach you ASAP.

Contributing

You want to contribute? yay!

Just fork this project and open a PR, I will help you in what you need.

Join the community
5,867 developers and counting
WhyWhy StorybookComponent-driven UI
Open source software
Storybook

Maintained by
Chromatic
Special thanks to Netlify and CircleCI