Web Accessibility Guidebook for Developers
Tags: a11y, webdev, react, kendoreact
Published: 2019-07-10 13:11:01

---
title: Web Accessibility Guidebook for Developers
published: true
tags: #a11y, #webdev, #react, #kendoreact 
canonical_url: https://www.telerik.com/blogs/web-accessibility-guidebook-for-developers
---

## Introduction to Accessibility

In the process of implementing [accessibility compliance](https://www.telerik.com/kendo-react-ui/components/accessibility/) (Section 508, WCAG 2.0 and WAI-ARIA) for [KendoReact](https://www.telerik.com/kendo-react-ui/), our suite of native UI components for React, we learned a lot about both fundamental and advanced accessibility topics. With this article, our goal is to introduce fellow engineers, regardless of level, to web accessibility and share our practical knowledge and best practices.

By the W3C definition, accessibility means that websites, tools, and technologies are designed and developed so that people with disabilities can use them. More specifically, people can: perceive, understand, navigate, and interact with the Web, and contribute to the Web.

One good example for accessibility is if you can use your site without looking at it. How would all the features and details you spent hours on developing work if you couldn’t use your eyesight to consume the content or use the mouse to interact with it? Imagine instead that you would need to listen to a screen reader that describes the UI and that navigation may not be through the traditional mouse or keyboard input.

### Why Accessibility is Often Neglected

While there are many reasons why accessibility is not omnipresent, although ideally it should be, there are three reasons that stick out.

First, it’s hard to accommodate for something that you don’t understand well. Most of the time, it is not motivation that we lack, but rather education on how disabilities prevent people from interacting with our site. This includes lack of knowledge around what disability types exist and how to accommodate them. We just do not know the ins and outs of the problem.

Second, making your application accessible requires a lot of work. Starting from understanding the premises of the standards you need to follow all the way to designing the needed features and functionalities into your app. Then of course, there’s testing whether your approach has yielded the desired result – and much of the testing can only be done manually. The practices described in this article will make this effort easier, but we are still talking about a serious undertaking.

Third is the economic argument which, rightly or not, dominates modern decision making: in most cases, a minority of your clients (or users) would be affected by a disability, which serves as justification to postpone implementing those accessibility improvements for the next release. It’s far easier for a business to justify focusing effort on something that benefits the majority rather than serving a smaller subset of users with improvements that may feel like the application did not actually move forward.

### Why Accessibility is Important

#### Ethics

People with disabilities deal with a lot of challenges on a daily basis. If they are among your clients or users, enabling them to interact with your web app is plain human decency.

#### Market

There's data that **1 billion people worldwide** , and **20% of all internet users** , have some form of disability. This is still a minority, but it comprises of a lot more people than most of us would think.

#### Legal

As legislation in this domain develops, it becomes more and more likely for your business to be required by law to be accessible. We will come back to this as the next section focuses on this exact topic.

#### User Experience

Accessibility guidelines are designed to help people access and use your website more easily. As a side effect, most of them improve usability and directly benefit all users, including those without disabilities. For example, readable text helps not only people with poor sight, but all users.

#### Engineering

Many of the good practices for accessibility are good engineering and design principles in general. Often it is the poorly written code that is not accessible. For those of us who strive for mastery of our craft, accessibility is just a matter of doing a good job.

#### Reputation

Having a more accessible site than your competition is a competitive advantage. It can also help create goodwill towards your brand.

#### SEO

There is some overlap between good practices for SEO and web accessibility. For example, writing semantic HTML with proper use of descriptive attributes such as labels, video transcription, image captioning and using title and header tags all improve both a website’s SEO and its accessibility.

### Legislation

Current legislation across the globe is moving in a direction where accessibility is becoming a mandatory feature of the web. In the USA, accessibility is covered by the Americans with Disabilities Act ([ADA](https://www.ada.gov/)). Many developed countries have similar laws, for example, the UK has the [Equality Act of 2010](http://www.legislation.gov.uk/ukpga/2010/15/contents). In practical terms, these laws mean that public sector organizations and businesses are required by law to follow the [Web Content Accessibility Guidelines (WCAG)](https://www.w3.org/WAI/standards-guidelines/wcag/).

It’s not just your customers and users you should be thinking about. If your organization has 50 or more employees, you need to ensure that you accommodate any individuals with disabilities. This means your internal web tools will have to be accessible as well.

Additionally, if you are a contractor working for the government, you need to comply with [Section 508 of the Rehabilitation Act](https://www.section508.gov/) in your work in addition to the above. By law, all US government services need to follow Section 508.

These laws are not just an indication of good intentions. More and more law firms take legal actions based on accessibility legislation. Progress has a detailed article on the topic for further reading, called “[Accessibility and the Law](https://dev.to/telerik/accessibility-and-the-law-164c-temp-slug-7160342).”

## Types of Disabilities and Accessibility Best Practices

There are four major disability types - **hearing** , **sight** , **motor** and **cognitive** disabilities. Each type includes a multitude of conditions. They cause different challenges when interacting with the web and require different approaches to solve these challenges. Let’s explore some best practices addressing each separate type of disability. You will notice that most of these practices are not about the underlying technology we use but about how we design our software. This means that everyone involved in the development process can contribute to better accessibility.

#### Hearing (Auditory) Disabilities

Hearing disabilities range from mild hearing loss to deafness. The best way to help these users is to avoid relying only on sound to convey critical information. Instead, add another media in parallel for support. For example, if you use video, make sure it supports subtitles with full captions. If you use audio, provide a transcript. Subtitles and transcripts should be full and not miss critical lines. In a later paragraph, we will list guidelines for readability. They strongly apply to subtitles and transcripts. In addition to this, for both video and audio, make sure background noise is minimized, so that the conveyed information is as audible as possible.

#### Visual Disabilities - Low Vision

The primary way to accommodate for low vision is to have a readable interface. UI elements need to be big and clear. Text is more complex, though, and in a later paragraph, we will list guidelines for readability. They are designed to assist people with low vision.

Contrast is another important aspect. High contrast between elements and colors in the UI will help people with low vision. There are tools available that examine if contrast is sufficient for people with this condition. Here you can find the [tools recommended by the Web Accessibility Initiative (WAI)](https://www.w3.org/WAI/ER/tools/). In most page designs used nowadays, contrast is indeed problematic. Below is an example of a high contrast theme that complies with WCAG. Such high contrast will not work well with regular themes and you would probably prefer not to sacrifice the visual appeal of your site. A good compromise is to include a high-contrast theme as an option on your website, much like the option to change the language.  
  
 ![Web accessibility - Contrast](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/contrast.png?sfvrsn=35e2e94e_1 "Web accessibility - Contrast")

#### Visual Disabilities - Blindness

Blind people use screen readers. These applications parse the HTML and describe it to the user using natural language. Developing for screen readers has its specifics, so a later section in the article will focus exclusively on them. Additionally, the input device a user with blindness will work with will be different. Using a mouse requires sight. A blind person will need full keyboard support instead.

#### Visual Disabilities - Colorblindness

Colorblindness, too, is not a single condition - there are different types of colorblindness. Keep in mind that the following explanations are quite simplified. Deuteranomaly is the difficulty to perceive green light and is the most common. Having difficulty perceiving red light is called protanomaly and is a bit less common. The visible specters of these two conditions are somewhat similar and the conditions are more commonly known as red-green colorblindness. Tritanomaly is a problem with perception of blue colors and is very rare.

The severity of each condition also varies - they can range from a slight perception problem to full inability to perceive that color. We use the prefix -nomaly when the color perception is partially affected and – nopia when a color cannot be perceived at all. Achromatopsia is the condition of seeing everything in greyscale and is very rare. Changes in color perception do not affect a single color but the whole visible spectrum.  
  
 ![Types of colorblindness](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/how-a-color-blind-person-sees-the-world.png?sfvrsn=25a31cd7_1 "How a color-blind person sees")

Your initial idea may be to pick colors that most people with colorblindness can see. This is not ideal because of the numerous variations of the disability, but orange and blue work ok in most cases. This is one of the reasons why the internet loves blue so much.

There are tools that simulate how your site looks when seen by colorblind people. You can use them to detect if there is a problem and then design and add optional themes for problematic types of the condition. This still requires your user to be able to find and switch to the respective theme.

Your most efficient solution is to not rely on color alone to convey critical information. You can design around the problem by using shapes, symbols, animation, and other creative means.

#### Motor Disabilities

Fast and/or repetitive actions, actions that require holding a button, actions with time limits - all of these are hard for people with motor disabilities and can cause physical pain. You need to avoid them, but it is not so simple. The following example illustrates why: imagine you have a slider that requires you to hold a button to move. Your solution may be to allow the slider to move by tapping a key, but if the step is too small, the result will be a repetitive action that is not much of an improvement. The general rule is that you need to design a website so a user would be able to conveniently use it both with a keyboard only and with a mouse only.

#### Cognitive Disabilities Related to Motion Sickness and Sensory Overload (Example - Epilepsy)

There are several patterns that can cause motion sickness or sensory overload. Usually these are rapid effects such as shaking, bright lights, quickly flashed (three times/second or faster). Repeating movement patterns, rapid or not, can cause the same issues. A good example for a repetitive but slow movement on a page is an animation of falling snowflakes, which we often see around the winter holidays. Sharp changes using flashy transitions in the contents on a page are also problematic; we need to use smooth transitions instead. A good practice is to avoid problematic effects, but if you want to use them, allow users to disable them as a compromise.

#### Cognitive Disabilities - Learning Difficulties

Simplicity is key. Make your scenarios simple, make your interface simple and free of clutter. Use simple language, avoid fancy words. Always provide clear instructions with concise information. The amount of information should follow the Goldilocks principle – too little will not be enough, but add too much and some users will get distracted. Avoid time limits that can put unnecessary pressure on the user.

#### Cognitive Disabilities - Dyslexia

Dyslexia is a type of disability that makes it difficult for some people to read: dyslexic people may confuse letters or see them rotated or crowded together. In the following paragraphs, we will list guidelines for readability. They strongly apply to addressing the challenges of dyslexia.  
  
 ![Accessibility - Dyslexia](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/dyslexia.png?sfvrsn=914c6482_1 "Cognitive disabilities - Dyslexia ")

#### Tips on Readability

Good readability ensures your website will be accessible for a number of people with disabilities: readable subtitles and transcripts will be of help to people with hearing problems and readable text in general will be of help to people with low vision or dyslexia. A rule of thumb is to use simple and clean sans-serif font in a large font size.

Space matters. For example, long lines are hard to read, so apply a limit of 70 characters per line. For subtitles, the recommended limit is 35 characters. Provide enough space for characters to breathe - 1.5x line spacing is ok. On the topic of space, text in all capital letters is hard to read, so use mixed case. Reading speed also matters, so do not advance text automatically or in the case of subtitles - keep them on the screen for at least 0.3 seconds per word.

A key part of the puzzle is contrast. Background images usually obscure text. Good fonts have a border around the letters to enhance contrast, but it is even better to avoid background images altogether and provide a solid background that contrasts well with the text.

The IT industry has created awesome and free specialized fonts that are optimized for readability. You may consider some of them. [Opendyslexic](https://opendyslexic.org/) and [Inter](https://rsms.me/inter/) are good examples.  
  
 ![OpenDyslexic specialized font](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/opendyslexic.png?sfvrsn=83a9d45a_1 "OpenDyslexic specialized font - dyslexia")

## Introduction to Assistive Technology

Assistive technology is the industry term that includes all software and hardware designed to help people with disabilities. Input devices include mouth sticks, head wands, big trackballs, specialized keyboards, voice recognition software. Output devices include screen magnifiers, screen readers, braille displays, hearing aids, software with natural language interfaces and more. Some of these enhance an existing technology, others provide an alternative way to interact with a computer.  
  
 ![Assistive devices - keyboard](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/devices4e4730fb07714f0892b9b8b95e227d78.png?sfvrsn=2022fd2d_1 "Assistive devices - keyboard")

Most assistive technologies work on the level of the operating system and web developers do not need to do anything additional to enable them to function properly. However, with screen readers things tend to be a little more complicated. What screen readers do, in essence, is parse the HTML, then describe and explain it using natural language. The quality of that voice description depends directly on the quality of the code. So, naturally, screen readers are a primary concern for web developers working on making their websites more accessible. In the following paragraphs we will look at some of the best practices when optimizing our web assets for screen readers.

### Optimizing for Screen Readers

#### Write Semantic HTML

The best practice to help screen readers do their job properly is to write semantic HTML – that is, to write valid HTML, follow best practices and use elements according to their intended purpose. For example, if something looks and behaves like a button, make it a button, not a <div>. If it is a heading, use the <h> tags and not some inline CSS.

The formal definition of the semantics of html elements can be found in [the living standard of HTML](https://html.spec.whatwg.org/multipage/).

In real life, this is not so simple, of course. This brings us to the next sections.

#### Follow the Spec

As with any fundamental technology, the Internet has multiple standardizing bodies. The [World Wide Web Consortium (W3C)](https://www.w3.org/) is one of them and the [Web Accessibility Initiative (WAI)](https://www.w3.org/WAI/)) is part of it. We as developers need to follow the [Web Content Accessibility Guidelines (WCAG)](https://www.w3.org/WAI/standards-guidelines/wcag/), developed by WAI, which is the general standard for web accessibility.

The design practices we went over earlier when discussing the different types of disabilities are described in greater detail in WCAG. It’s important to note that WCAG is a living standard that is actively being improved. The most recent version as of the time of writing this resource is 2.1.

WAI developed the [Web Accessibility Initiative - Accessible Rich Internet Applications Suite (WAI-ARIA),](https://www.w3.org/WAI/standards-guidelines/aria/)) the technical standard for how to write our code. We as developers need to follow this spec for screen readers to work properly. For brevity, in the next paragraphs I will refer to WCAG and WAI-ARIA as “the spec.”

#### Automated Testing

There are a variety of scanners that can automatically do checks covering many of the compliance rules that we are required to follow. For example, most automation software can easily scan for missing attributes and elements, check color contrasts or validate the HTML. A good practice is to do at least a quarterly scan of your site. And if you are really dedicated, you can include this step in your CI and CD process. Here is a list of good-quality scanners in no particular order:

- [Google Lighthouse](https://developers.google.com/web/tools/lighthouse/)
- [Axe](https://www.deque.com/axe/)
- [Wave](https://wave.webaim.org/)
- [Powermapper](https://www.powermapper.com/)
- [Dynomapper](https://dynomapper.com/)
- [Monsido](https://monsido.com/features/web-accessibility)
- [Various other tools listed by W3](https://www.w3.org/WAI/ER/tools/)

#### Manual Testing

Unfortunately, automation can take just a small part of the big picture. If you want to achieve meaningful results, you have to manually test your site. The most practical way to perform such a test is to close your eyes and use only a keyboard and a screen reader to perform a variety of tasks on the website you’re reviewing.

Side-note: Personally, this is the point when I discovered how difficult accessibility testing really is.

![Accessibility - Blind Testing](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/blind-testing.png?sfvrsn=3f056418_1 "Accessibility Blind Testing")

#### Navigation

With your eyes closed, you cannot use a mouse. Keyboard navigation in the dark is much harder than with visual input. A lot of your solutions may not work as well as you had hoped once you stop seeing the screen. You will probably discover scenarios that you’ve missed accounting for. In short, offering good, working, keyboard navigation is very hard.

#### Auditory Complexity

The market provides multiple screen readers and they are usually very hard to understand. You may struggle to make sense of what you hear. The reason is that screen readers do not just read the screen using text-to-speech. Their task is harder: they need to describe the UI in enough detail so you understand its structure. Screen readers can be understood well only when you provide them with simple constructs in simple scenarios. So you need to work very hard to simplify the information architecture of your site.

#### Inconsistencies

Each screen reader has its own subtle interpretation of the spec and behaves slightly differently on each browser. You will encounter a lot of grey areas where following the spec is just not enough to make all screen readers provide meaningful output. In those cases, your implementation needs to make a compromise that works ok in most combinations of readers and browsers.  
  
 ![NVDA JAWS ChromeVox readers](https://d585tldpucybw.cloudfront.net/sfimages/default-source/default-album/nvda-jaws-chromevox.png?sfvrsn=a62aa04c_1 "NVDA JAWS ChromeVox readers")

In our practice, we’ve discovered a few combinations that work well for testing purposes:

##### Jaws

[Jaws](http://www.freedomscientific.com/products/software/jaws/) is one of the oldest screen readers on the market. This means that it is one of the most popular tools out there. It has numerous users, so you need to make sure that your applications support it. But its age also means that Jaws needs to support a lot of legacy use cases. As a result, it is often not very compliant with the spec and difficult to work with. In our practice, we’ve found that Jaws works best with IE.

##### ChromeVox

[ChromeVox](https://chrome.google.com/webstore/detail/chromevox/kgejglhpjiefppelpmljglcjbhoiplfn) is the newest reader (as of the time of writing this article) and, consequently, most compliant with the spec. Its young age means it is still not very popular. It works best on Chrome.

##### NVDA

[NVDA](https://www.nvaccess.org/) is another new reader with good compliance with the spec. It is very popular and works best on Firefox.

#### Conclusion on Manual Testing

When a reader works well with a browser, this gives you some confidence that its users will use it primarily on that browser, though there are no rules and the possible scenarios are many. However, given that we usually work with limited resources, a good practice is to focus only on the popular combinations above and test often, instead of covering all possible combinations of readers and browsers, but doing it less often.

To back up our statements with data, here is a link to a reputable [screen reader user survey](https://webaim.org/projects/screenreadersurvey7/) that sheds light on user adoption of screen readers.

### Third Party Testing is Last

It is advisable that you test with people with disabilities or get accessibility feedback from clients. The best practice is to do this only after you have done your homework with in-house manual and automated testing. It is our responsibility to first make sure their user experience is not completely broken. Only then will you be able to get meaningful feedback from your users.

## Best Work Practices in Your Organization

### Education

The first step in addressing any problem, is first to become aware of it. That’s why it is recommended that you invest in educating your team on the topic. Regardless of our motivation to do the right thing, unless we know what needs to be done to make a website more accessible, we won’t achieve progress in this area.

Additionally, accessibility is not a single person’s responsibility – everyone working on a web app, from engineers and designers to management, need to have it as a consideration. Educating and sharing knowledge with fellow engineers is also the primary motivation behind this article.

### Documentation

As already discussed in previous parts, accessibility is not an exact science. You will often find yourself in a grey area without a clear solution in sight. The best practice in these situations is to document your approach. In that document, you may include the reasoning behind your current implementation and quote the WCAG rule(s) you’ve chosen to follow. This documentation will help your team to share knowledge and improve the consistency of your site and reduce the number of grey areas. Should you ever need to defend your decisions in court, having documentation can help defend your case.

[KendoReact](https://www.telerik.com/kendo-react-ui/) is one of a suite of JavaScript UI libraries called [Kendo UI](https://www.telerik.com/kendo-ui). At Progress, we share code and knowledge across teams to make sure when one team excels in something, the others will quickly get to the same level. Documentation is a very important part of how we share knowledge across teams when it comes to accessibility.

#### Usability and Accessibility are not the Same

Usability and accessibility have a lot in common. Most accessibility practices discussed in this article will benefit all users. But usability and accessibility are not the same. You may have invested heavily in usability, but that does not mean that you have automatically covered accessibility as well. Be aware that accessibility needs its own attention.

This is our recommended reading on usability:

- The US government provides research-based [web design and usability guidelines](https://webstandards.hhs.gov/guidelines)
- “Humane Interface” by Jeff Raskin is considered a fundamental work on the topic
- “Don't Make Me Think” by Steve Krug is a wonderful short book

As we have previously discussed, accessibility has multiple grey areas. Sometimes accessibility solutions may contradict usability solutions. The best practice in those cases is to not sacrifice usability, as it usually targets a larger number of users. Instead, we need to be creative and work around the problem.

#### Use Accessible Tools

Web accessibility is hard. A key way to achieve good results is to use accessible tools. For example, if you want a simple blog or website, WordPress will take care of accessibility for you. With our work on KendoReact library of UI components, we aim to help you in the same way. Our UI components are [designed and built from the ground up with accessibility in mind](https://www.telerik.com/kendo-react-ui/components/accessibility/), so you do not have to do most of the heavy lifting.

### Recommended Resources

Below, you can find relevant and authoritative resources I recommend for further reading on the topic

- [Mozilla's explanation of WCAG](https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG)
- [The a11y Project](https://a11yproject.com/) – a major community-driven hub with resources and tools
- [Free Accessibility course by Google](https://eu.udacity.com/course/web-accessibility--ud891)
- [Testing tools suggested by WAI](https://www.w3.org/WAI/ER/tools/)
- [AccessU](https://knowbility.org/programs/accessu/2019/) is a reputed accessibility-focused summit 
- [WebAIM (web accessibility in mind)](https://webaim.org/) – an organization that provides accessibility services such as training, evaluation and certification

Additionally, Progress has a whitepaper on accessibility that explores the domain in great detail, called [Accessibility for Web Developers](https://www.telerik.com/campaigns/kendo-ui/wp-accessibility), which is free to download.

### Conclusion

This is the finale of our article on web accessibility, summarizing the experience of the [KendoReact](https://www.telerik.com/kendo-react-ui/) team while working on the accessibility of our library of UI components for React. Our primary goal with this resource is to help build awareness on the topic. We hope that we have managed to convey how important accessibility is and have given you useful and practical ideas to efficiently tackle some of the challenges in building an accessible website. Please tell us about your experience with the topic in the comments below.

May the Force of Accessibility be with you.