Nearly 1 in 7 people have a disability, therefore it is important to make sure your application or website is accessible for everyone. This probably also means that it will increase the user experience of the common user and (SEO) bots. Along the way you’ll notice that this will bring more satisfaction and enjoyment during development and again when you deliver the product: making everyone happier, from developer, to management, to user.
This post is about using libraries to follow accessibility best practices and catching issues during development, making the pit of success wider for you and your team. I’m no accessibility expert but I believe that following these rules will have a high-impact, with almost zero effort.
This post does not contain tips and tricks nor a checklist to make your application accessible (e.g. use semantic HTML, don’t use divs for everything). We will not cover all cases, use this post as a starting point to make your applications (more) accessible.
What is accessible link
Before we start let’s first define the term accessible. If you search for accessible on google, these are some few points that you’ll encounter:
- easy to approach, reach, enter, speak with, get along with.
- capable of being used or seen: available
- easily used or accessed by people with disabilities**: adapted** for use by people with disabilities
An estimated 1 billion people are disabled, about 15% of the world’s population — World Health Organisation
The easiest “bang for the buck” tool is pa11y, an open-source project to automate accessibility checks. It is very easy to use, gives a nice overview of the errors and can be used during a CI build. Using pa11y can be as simple as installing and running it against a website.
As a use case we’re going to focus on the Angular NgRx Material Starter Project by Tomas Trajan and a big community of open source contributors. The project can be found on GitHub, more about this later.
$ npm install pa11y -g $ pa11y https://tomastrajan.github.io/angular-ngrx-material-starter
To get the most from pa11y, pa11y-ci is needed. As the name already gives away, it does the same thing but is focused on running during a CI build. Pa11y-ci is also more customizable, and this can be done via a config file (
.pa11yci by default). The following steps show you how to integrate pa11y-ci into your CI build:
The next step is to create the
.pa11yci config file. This file contains the configuration in JSON format.
The last step is to add some scripts in the
These scripts are needed to build and serve our application first before we can use pa11y-ci. To serve the application a server is needed, you can either use angular-http-server for this or create your own node server with express. Npm-run-all (install it via
npm install npm-run-all --save-dev) is being used here to start the server. Once the server is up and running, we can run pa11y-ci against it.
Now if we do
npm run accessibility,we get an overview with errors, just like before.
With this in place all that is left to do is to add this command as a step in the CI build. Here is an example with CircleCI:
Pa11y tips link
- Run pa11y against local html files without launching a server:
- Instead of defining the URLs manually, refer to a sitemap — docs
- When adding pa11y to an existing project, set a high threshold number in order to not break the build until all errors are solved:
pa11y-ci --threshold 250
- Ignore certain elements you have no control over:
- Override the defaults for a specific URL:
- It’s even possible to perform some actions before the pa11y tests are run without writing a single line of code.
Use a library based on dom-testing-library for example ngx-testing-library or cypress-testing-library, to test your application in a way that your users are using the application, in contrast to using the component’s API.
Instead of setting the component’s values directly or using css selectors to populate the fields in a form, use a label with a
for attribute or use the
aria-labelledby attribute on the input field. This has more meaning to your end users. And, you’ll also get the benefit that your tests won’t break when the id or the class of an element has been changed. The code below shows you a comparison between these ways of testing, by testing a simple login Angular component.
The default or standard approach:
And now in comparison with ngx-testing-library:
As you can see in the example above: the library encourages, or even enforces, you to think like a user, making the application more accessible.
Keyboard events link
Another way to make sure your components are accessible is to use keyboard events in your test cases, whether it is a unit, integration or end to end test. An example that illustrates this, is a user using a dropdown component:
Notice that this becomes a breeze with ngx-testing-library.
During development link
When you create a new component make it a habit to read through the W3C standards about accessibility. I’m sure that this will make you look at your components through different eyes. More often than not, this will result in a cleaner and more reusable API. It will also bring more joy and satisfaction when you’re finished.
If you need some inspiration, go take a look at the source code of libraries like Angular Material, they even have an a11y cdk package! Their components are often designed with accessibility as a first class citizen.
Next steps link
While these libraries might give you some ideas and will definitely make your applications more accessible, it doesn’t stop here. If you want to take it to the next level, use your own application with a screen reader (start by using the native screen reader of your OS) or drop your mouse while you browse through your application. By doing this you’ll quickly find some weird quirks;
Talk about accessibility within your team (e.g. add it to the Definition of Done) or online to raise the awareness about accessibility;
Start opening issues or submitting pull requests to some open source projects;
Invite people with a disability to your testing groups;
If you don’t got the knowledge in house, ask for an external audit to get you and your team on the right track;
You might already have noticed that making your application accessible isn’t a one-time thing, you’ll have to make room for it within your process to maintain it along the way. The sooner the better.
Hacktoberfest is a month-long celebration of open source software run by DigitalOcean in partnership with GitHub and Twilio.
As briefly mentioned in this post, I’ve set up pa11y in the Angular NgRx Material Starter Project and there are some accessibility issues. Therefore we created a couple of open issues, I would like to invite you to take a look at the Hacktoberfest open issues and get your first experience with accessibility testing or open source contributions. Feel free to ask questions, we’ll be there to guide you along the way.
Feel free to update this blog post on GitHub, thanks in advance!
I appreciate it if you would support me if have you enjoyed this post and found it useful, thank you in advance.