All Posts


I originally published this blog post on the LeanIX Engineering Blog.

I extracted this article from a talk I'm giving to LeanIX employees (and at conferences; includes recording). Big thanks to @polarbirke for sparking my interest in web accessibility several years ago and also giving me tips on my talk.

Disclaimer: I'm by no means an accessibility expert. I would rather call myself an accessibility nerd. As I prepared my accessibility talk at LeanIX I kept falling deeper into the accessibility rabbit hole and there are still so many things I don't know.

In this post I'm trying to answer the "What, Why, Who, and How" of web accessibility and provide you with the tools to build more accessible web services.

What is web accessibility?

Short and crisp:

Web accessibility is about enabling all humans to use web services, regardless of their physical or situational disability.

or as Tim Berners-Lee said:

The power of the Web is in its universality.
Access by everyone regardless of disability is an essential aspect.

Source: W3C Accessibility

Why should you care?

First and foremost learning about and building accessible web services makes the web more open to everyone. Secondly, because those "everyone" also includes your paying customers.

The people (aka our customers)

I used to think of web accessibility mattering only to people with permanent disabilities, but there are plenty of examples where anyone is going to miss accessibility support in web services due to temporary or situational disabilities such as a broken arm as well. Not being able to navigate all features of LeanIX using my left hand and a keyboard is very frustrating in this case.

This graphic from Microsoft Inclusive Design presents a small excerpt of people who rely on developers who are mindful of accessibility so that they can use their web services:

Showcase by Microsoft Inclusive Design of different kinds of disabilities that put you in a position to rely on web accessibility

On the other hand there's ...

The law

Here's a list of the laws that I've known the longest/found to be the most influential:

Overview: Web Accessibility Laws and Policies | W3C

By the BITV 2.0 law, for example, any web services that are operated by a public agency in Germany need to be accessible by anyone regardless of their disability.

There've also been several successful court cases in the US about websites of US service providers were not accessible to disabled people, which violates the ADA linked above.

Who: Meet the WCAG by the W3C

The World Wide Web Consortium (W3C) is the main international standards organization for the World Wide Web founded in 1994 and led by Tim Berners-Lee.

They publish and maintain the Web Content Accessibility Guidelines as part of the Web Accessibility Initiative. If you want to know about web accessibility, I think they should be your first destination online. You can start with their introduction to web accessibility page.

WCAG POUR principles

The Web Content Accessibility Guidelines (WCAG) are categorized in the following four principles (source):

Web content must be...

  1. Perceivable - Information and user interface components must be presentable to users in ways they can perceive.

    This means that users must be able to perceive the information being presented, it can't be invisible to all of their senses.

  2. Operable - User interface components and navigation must be operable.

    This means that users must be able to operate the interface. The interface cannot require interaction that a user cannot perform.

  3. Understandable - Information and the operation of the user interface must be understandable.

    This means that users must be able to understand the information as well as the operation of the user interface. The content or operation cannot be beyond their understanding.

  4. Robust - Content must be robust enough that it can be interpreted reliably by a wide variety of user agents, including assistive technologies.

    This means that users must be able to access the content as technologies advance. As technologies and user agents evolve, the content should remain accessible.

Disability perspectives

Disability emerges where there is a mismatch between individual capacities and environmental demands.

The non-profit organization WebAIM distinguishes the following four categories for permanent disability:

Source: WebAIM: Introduction to Web Accessibility

However as I mentioned before there are many situations where anyone may become reliant on accessible web services, such as a broken arm or wrist or a visually impaired person who just misplaced their glasses.

This video by the W3C is a must-see for me as a non disabled person: Web Accessibility Perspectives - Compilation of 10 Topics/Videos

Now that you've read about the Web Content Accessibility guidelines and different kinds of disabilities, let's jump into how to use them to build more accessible web services.


If you're just starting with paying attention to accessibility in the user interfaces of your services/products, I would suggest starting with one simple rule to adhere to:

If an action can be done with a mouse, it needs to be doable with a keyboard as well.

A more comprehensive approach that conforms with most laws would be to strive for WCAG conformance level AA.

How do you know what level you're at? Checklists and Audits.


Here's my personal "layman web accessibility checklist":

And here you can find actual professional accessibility checklists:


One important tool to bring attention to accessibility flaws in your services is to pay experts to audit them. I won't recommend any in this post, but there's several highly professional accessibility auditors who are passionate about what they do.

Use semantic elements aka "A div is not a button"

Using semantic elements is a way to get accessibility out of the box at a low cost.

A few examples:

If something is a list, make it a <ul> or <ol>.

If something is a button, make it a <button> (no <a>, <div>, <span> or whatever tag).

If something is a link, make it an <a> tag (no window.href=some-url).

The following HTML code compares the minimal required code to get a div element to implement the ARIA button role in an Angular component template next to the markup of the native button element.

<!-- div button using angular template features --->
<div tabindex="0"
Click me</div>

<!-- versus --->

<!-- native button --->
<button (click)="onAction()">Click me</button>

Cool resources on this:

ARIA what?

Aria is especially - but not exclusively - important for supporting screen readers.

It stands for "Accessible Rich Internet Applications suite of web standards". The Mozilla Developer Network lists some great resources on learning more about ARIA.

While you can put tabindex="0" and event listeners for click and enter events on a <span> element, this will not enable screen readers to treat this element like a button. To enable this you need to assign your <span> element the ARIA attribute called role with the value button.

Three things to keep in mind:

  1. Semantic elements > ARIA attributes (button > role="button").

  2. No ARIA is better than bad ARIA.

  3. A role is a promise. If you give something an aria role, you should properly implement all input methods that are specified for it.

On screen readers

A screen reader is a form of assistive technology that renders text and image content as speech or braille output. Since I'm not visually impaired, I've only ever used them for testing. I test with Apple VoiceOver since my developer machine uses Mac OS. You can enable it any time by pressing cmd + f5. It's worth it to look into the controls of screen readers before enabling them.

I highly recommend watching this screen reader demonstration video that was recently uploaded on the TetraLogical YouTube channel: Browsing with a desktop screen reader.

One of the directors at TetraLogical is Léonie Watson and she gave a very good talk at the Front-Trends conference in 2015: ARIA, Accessibility APIs and coding like you give a damn!

Improve how screen readers read your content

Describe interactable elements that do not contain any text that explains what it's doing using the aria-label attribute. Also from my research, I'm fairly certain that for targeting screen readers, aria-label is more widely supported than title attributes.

The following HTML code shows examples for using the aria-label and aria-hidden attributes including the text that Apple VoiceOver announces when selecting them.

<!-- Reads "button times" -->

<!-- Reads "button close" -->
<button aria-label="close">&times;</button>

<!-- Reads "button identical to menu" -->
<button>≡ menu</button>

<!-- Reads "button menu" -->
<button><span aria-hidden="true"></span> menu</button>

To learn more about the aria-label attribute I recommend reading this article on the Opera engineering blog.

Testing tools

When building accessible web applications, you need to be able to test that your efforts are achieving the desired results.

These are the tools I use for this:

Here's a comprehensive list of testing software by the W3C: Web Accessibility Evaluation Tools List

I also recommend taking the time to watch this great TetraLogical YouTube playlist where they demonstrate common accessibility test cases.


The accessibility rabbit hole goes deep and there's so much information on the web about it that takes a lot of time to consume. I hope that with this article I reduced the "fear" of this rabbit hole and maybe even sparked some interest.

And while I know that this might be much to ask next to keeping up with the latest JavaScript frameworks, if there are just three things you'll take away from this article, let it be these:

To conclude I'd like to quote a line from Léonie Watson's talk I linked above:

Perfect is the enemy of good.

Don't strive for perfection when building accessible web services. Every little piece can make a difference to your users.


(Dis)ability and the experience of accessibility in the urban environment

I've done a lot of reading to compose this article. In order to not take over your whole viewport with a wall of links, I'm including them in a disclosure widget.

Click to show more links to resources regarding accessibility

For testing Apple VoiceOver support:

Good resources on ARIA

Published 31 Jan 2022