Introduction
When we solve problems and create new features we don't want to be biased by our individual abilities but be emphatic to users who are limited in interacting with the provided user interface. Impairments are not always permanent but can be temporary or situational too, so we want to provide a variety of ways how to interact with our application.
The WCAG provides guidance on how to include users of all abilities and qualifies a level of accessibility by providing success criteria. Contentful aims to meet the WCAG 2.1 Level AA success criteria.
Assistive Technologies
There are several forms of limitations a user can face when interacting with a user interface, they can be roughly categorised as follows:
Auditory
Cognitive
Neurological
Physical
Visual
All major operating systems provide a certain amount of assistive technologies which enable alternative ways of communicating content and functionality especially for users with auditory and visual impairments. This includes tools like contrast switchers, screen readers or braille display support.
It is important to create content which is accessible and to provide technical implementations to enable those technologies. The following lists should provide simple guides on what to look out for and prevent common accessibility failures:
Text Alternatives
All non-text content should provide alternative text (e.g.
labelordescribedbyaria attributes;altattribute for images)
Adaptable
Information, structure, and relationships conveyed through presentation can be programmatically determined or are available in text (e.g. Provide labels for form components or use the aria
describedbyattribute to create relationship between content).Order content in a meaningful sequence. Use headings to structure content sections.
Keyboard Accessibility
Build for keyboard use only, all interactive elements should be focusable and show focus indicators like outlines or other stylings to guide the interaction.
Prevent keyboard traps. Every element that can be focused on using the keyboard can be unfocused using the keyboard.
If character key shortcuts are implemented (e.g. shortcuts just using a letter, number or symbol) it must be possible to either disable or reassign them.
Distinguishable
Color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element (e.g. A status like published, archived or deleted should not only be indicated by its color coding but show an additional status text).
Respect the contrast minimum. Paragraph text has a contrast of at least 4.5:1, the visual presentation of user interface or graphical components has a minimum contrast of 3:1 (https://webaim.org/resources/contrastchecker/)
Text can be resized up to 200 percent without loss of content or functionality (Except for captions and images of text)
Navigable
Provide a mechanism like skip links to bypass blocks of repeated content
All Pages have titles that describe the purpose of the page
Elements of the page can be focused in the sequence of appearance
The purpose of each link can be determined by the link text alone
The WCAG provides a quick reference to all Level AA success criteria which can be found here: https://www.w3.org/WAI/WCAG21/quickref
For best practices and additional guidance we highly recommend reading the WAI-ARIA Authoring Practices 1.1.
Automated Accessibility Testing
When implementing Forma 36 react components it is important to provide a basic level of automated testing for new components. This is why we use axe and Jest to test component snapshots on WCAG criteria.
Every component bootstrapped using the CLI (e.g. yarn add-component) will provide a basic Jest test for accessibility of the component snapshot. More information about testing can be found here: https://github.com/contentful/forma-36/blob/main/packages/forma-36-react-components/README.md#testing