Screen Reader Accessibility Guide

Understanding the Challenges of Screen Reader Compatibility

When developing accessible user interfaces, it's critical to ensure compatibility with screen readers. Screen readers can interpret content differently, which is why testing on actual devices is necessary. This challenge is particularly evident when dealing with virtual components, where not all items exist in the Document Object Model (DOM). In a virtual list, for instance, recycling the DOM can lead to incorrect readings of items' current and total numbers.

To address this, we employ Accessible Rich Internet Applications (ARIA) attributes like ARIA set size and ARIA posinset. ARIA set size defines the total number of items, while ARIA posinset indicates the current item's position. This ensures the screen reader accurately conveys both the current position and the total number of items. Such measures are essential, even when elements are not visible on the screen.

Introduction to the Enact Framework

The Enact framework, built on React, is designed for TV UI components, focusing on spatial navigation, accessibility, and internationalization. It powers millions of LG webOS TVs, demonstrating its scalability and reliability. The framework's accessibility features are fundamental, beginning with keyboard navigation. By default, elements like div and span are not keyboard navigable, necessitating the addition of tab indexes.

Enact includes a module called Spotlight, which facilitates keyboard navigation using TV remote direction keys. This ensures all components meet the basic accessibility requirement, supporting both pointer and directional key inputs. Additionally, the framework supports touch input, highlighting its versatility.

Implementing ARIA Attributes for Enhanced Accessibility

JSX, the syntax extension for React, supports all attributes and roles as built-in features. While most React attributes use camel case, accessibility properties adhere to standard HTML attributes. A critical aspect of accessibility is reading the text of the focused DOM element. However, there are scenarios where the default functionality isn't sufficient.

One such case involves reading icons with no accompanying text. Here, the ARIA label attribute is invaluable. It provides a string to label interactive elements, useful when there's no visible text or when the on-screen text doesn't match what needs to be read. The reading order is crucial, as it affects the user's understanding.

Reading Order and Value Updates

When defining the reading order for multiple elements, the ARIA labeled by attribute is employed. This attribute specifies the reading order by listing element IDs, which the screen reader processes sequentially. This ensures users receive information in a logical and intuitive sequence.

Handling range widgets like sliders or spin buttons, which change value while maintaining focus, requires specific ARIA attributes. ARIA value now indicates the current value, while ARIA value text provides a human-readable alternative. This approach enriches the information provided to users, beyond mere numerical values.

Announcing Alerts and Custom Messages

Alert popups need immediate attention upon appearing, even without focus. The ARIA live attribute alerts screen readers to content updates, prompting automatic reading. For alert popups, ARIA live assertive is the default setting, but adjustments may be necessary to prevent redundant readings.

Custom message announcements, akin to native Text-to-Speech (TTS) functions, are implemented by creating a span tag with an alert. This tag, although invisible, can relay messages by setting the ARIA level value. Such customization ensures important messages are conveyed effectively.

Tools and Best Practices for Accessibility Development

Developers benefit from tools like the ESLint plugin JSX A11y, which performs static analysis to catch accessibility issues in JSX. This tool is easily integrated into development environments like VS Code, helping identify errors early in the process.

Chrome DevTools offers robust accessibility features, allowing developers to view accessibility trees and ARIA attributes. Despite these tools, it's crucial to use screen readers for testing, as they provide real-world feedback on how content is read. Different screen readers may behave differently, underscoring the importance of testing on target devices.

Enhancing React UI accessibility, particularly for TV applications, involves a multifaceted approach. By understanding the challenges, leveraging the Enact framework, and implementing ARIA attributes, developers can create accessible and user-friendly interfaces. Tools and best practices ensure these interfaces function seamlessly across devices and screen readers, ultimately enhancing user experience.

Watch full talk with demos and examples:

Watch video on a separate page
Rate this content
Bookmark
SlidesGithubProject website

This talk has been presented at React Summit US 2024, check out the latest edition of this React Conference.

FAQ

The Enact framework includes a module called Spotlight for TV remote direction keys, making all components keyboard navigable and meeting accessibility requirements.

The ARIA label is an attribute used to define a string that labels an interactive element, especially when there is no visible text or when you want different text to be read than what is visible on the screen.

ARIA value now defines the current value of a range widget, while ARIA value text provides a human-readable text alternative. If both are present, the screen reader reads the ARIA value text.

Use ARIA live attribute to tell the screen reader that content will update, allowing it to read alert popups automatically when they appear on the screen.

Reading order is managed using the ARIA labeled by attribute, which identifies the level of an element. The screen reader reads the IDs in the order they appear, ensuring correct reading order.

Recommended tools include ESLint plugin JSX A11y for static analysis of accessibility issues, and Chrome DevTools for viewing accessibility trees and ARIA attributes.

For virtual components, use ARIA set size to define the total number of items and ARIA pos in set to define the current element's position, ensuring the screen reader reads the correct information.

Implement a solution using a span tag with an alert, where the announce function takes a message, sets it as the ARIA level value, and applies the attribute to the element, allowing custom message announcements.

The Enact framework is a React-based framework designed for TV UI components, developed by LG Electronics. It includes features like spatial navigation, accessibility, and internationalization, and is used in tens of millions of LG webOS TVs annually.

Seungho Park
Seungho Park
10 min
22 Nov, 2024

Comments

Sign in or register to post your comment.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

Don't Solve Problems, Eliminate Them
React Advanced 2021React Advanced 2021
39 min
Don't Solve Problems, Eliminate Them
Top Content
Kent C. Dodds discusses the concept of problem elimination rather than just problem-solving. He introduces the idea of a problem tree and the importance of avoiding creating solutions prematurely. Kent uses examples like Tesla's electric engine and Remix framework to illustrate the benefits of problem elimination. He emphasizes the value of trade-offs and taking the easier path, as well as the need to constantly re-evaluate and change approaches to eliminate problems.
Using useEffect Effectively
React Advanced 2022React Advanced 2022
30 min
Using useEffect Effectively
Top Content
Today's Talk explores the use of the useEffect hook in React development, covering topics such as fetching data, handling race conditions and cleanup, and optimizing performance. It also discusses the correct use of useEffect in React 18, the distinction between Activity Effects and Action Effects, and the potential misuse of useEffect. The Talk highlights the benefits of using useQuery or SWR for data fetching, the problems with using useEffect for initializing global singletons, and the use of state machines for handling effects. The speaker also recommends exploring the beta React docs and using tools like the stately.ai editor for visualizing state machines.
Design Systems: Walking the Line Between Flexibility and Consistency
React Advanced 2021React Advanced 2021
47 min
Design Systems: Walking the Line Between Flexibility and Consistency
Top Content
The Talk discusses the balance between flexibility and consistency in design systems. It explores the API design of the ActionList component and the customization options it offers. The use of component-based APIs and composability is emphasized for flexibility and customization. The Talk also touches on the ActionMenu component and the concept of building for people. The Q&A session covers topics such as component inclusion in design systems, API complexity, and the decision between creating a custom design system or using a component library.
React Concurrency, Explained
React Summit 2023React Summit 2023
23 min
React Concurrency, Explained
Top Content
Watch video: React Concurrency, Explained
React 18's concurrent rendering, specifically the useTransition hook, optimizes app performance by allowing non-urgent updates to be processed without freezing the UI. However, there are drawbacks such as longer processing time for non-urgent updates and increased CPU usage. The useTransition hook works similarly to throttling or bouncing, making it useful for addressing performance issues caused by multiple small components. Libraries like React Query may require the use of alternative APIs to handle urgent and non-urgent updates effectively.
Managing React State: 10 Years of Lessons Learned
React Day Berlin 2023React Day Berlin 2023
16 min
Managing React State: 10 Years of Lessons Learned
Top Content
Watch video: Managing React State: 10 Years of Lessons Learned
This Talk focuses on effective React state management and lessons learned over the past 10 years. Key points include separating related state, utilizing UseReducer for protecting state and updating multiple pieces of state simultaneously, avoiding unnecessary state syncing with useEffect, using abstractions like React Query or SWR for fetching data, simplifying state management with custom hooks, and leveraging refs and third-party libraries for managing state. Additional resources and services are also provided for further learning and support.
TypeScript and React: Secrets of a Happy Marriage
React Advanced 2022React Advanced 2022
21 min
TypeScript and React: Secrets of a Happy Marriage
Top Content
React and TypeScript have a strong relationship, with TypeScript offering benefits like better type checking and contract enforcement. Failing early and failing hard is important in software development to catch errors and debug effectively. TypeScript provides early detection of errors and ensures data accuracy in components and hooks. It offers superior type safety but can become complex as the codebase grows. Using union types in props can resolve errors and address dependencies. Dynamic communication and type contracts can be achieved through generics. Understanding React's built-in types and hooks like useState and useRef is crucial for leveraging their functionality.

Workshops on related topic

React Performance Debugging Masterclass
React Summit 2023React Summit 2023
170 min
React Performance Debugging Masterclass
Top Content
Featured WorkshopFree
Ivan Akulov
Ivan Akulov
Ivan’s first attempts at performance debugging were chaotic. He would see a slow interaction, try a random optimization, see that it didn't help, and keep trying other optimizations until he found the right one (or gave up).
Back then, Ivan didn’t know how to use performance devtools well. He would do a recording in Chrome DevTools or React Profiler, poke around it, try clicking random things, and then close it in frustration a few minutes later. Now, Ivan knows exactly where and what to look for. And in this workshop, Ivan will teach you that too.
Here’s how this is going to work. We’ll take a slow app → debug it (using tools like Chrome DevTools, React Profiler, and why-did-you-render) → pinpoint the bottleneck → and then repeat, several times more. We won’t talk about the solutions (in 90% of the cases, it’s just the ol’ regular useMemo() or memo()). But we’ll talk about everything that comes before – and learn how to analyze any React performance problem, step by step.
(Note: This workshop is best suited for engineers who are already familiar with how useMemo() and memo() work – but want to get better at using the performance tools around React. Also, we’ll be covering interaction performance, not load speed, so you won’t hear a word about Lighthouse 🤐)
React Hooks Tips Only the Pros Know
React Summit Remote Edition 2021React Summit Remote Edition 2021
177 min
React Hooks Tips Only the Pros Know
Top Content
Featured Workshop
Maurice de Beijer
Maurice de Beijer
The addition of the hooks API to React was quite a major change. Before hooks most components had to be class based. Now, with hooks, these are often much simpler functional components. Hooks can be really simple to use. Almost deceptively simple. Because there are still plenty of ways you can mess up with hooks. And it often turns out there are many ways where you can improve your components a better understanding of how each React hook can be used.You will learn all about the pros and cons of the various hooks. You will learn when to use useState() versus useReducer(). We will look at using useContext() efficiently. You will see when to use useLayoutEffect() and when useEffect() is better.
React, TypeScript, and TDD
React Advanced 2021React Advanced 2021
174 min
React, TypeScript, and TDD
Top Content
Featured WorkshopFree
Paul Everitt
Paul Everitt
ReactJS is wildly popular and thus wildly supported. TypeScript is increasingly popular, and thus increasingly supported.

The two together? Not as much. Given that they both change quickly, it's hard to find accurate learning materials.

React+TypeScript, with JetBrains IDEs? That three-part combination is the topic of this series. We'll show a little about a lot. Meaning, the key steps to getting productive, in the IDE, for React projects using TypeScript. Along the way we'll show test-driven development and emphasize tips-and-tricks in the IDE.
Master JavaScript Patterns
JSNation 2024JSNation 2024
145 min
Master JavaScript Patterns
Top Content
Featured Workshop
Adrian Hajdin
Adrian Hajdin
During this workshop, participants will review the essential JavaScript patterns that every developer should know. Through hands-on exercises, real-world examples, and interactive discussions, attendees will deepen their understanding of best practices for organizing code, solving common challenges, and designing scalable architectures. By the end of the workshop, participants will gain newfound confidence in their ability to write high-quality JavaScript code that stands the test of time.
Points Covered:
1. Introduction to JavaScript Patterns2. Foundational Patterns3. Object Creation Patterns4. Behavioral Patterns5. Architectural Patterns6. Hands-On Exercises and Case Studies
How It Will Help Developers:
- Gain a deep understanding of JavaScript patterns and their applications in real-world scenarios- Learn best practices for organizing code, solving common challenges, and designing scalable architectures- Enhance problem-solving skills and code readability- Improve collaboration and communication within development teams- Accelerate career growth and opportunities for advancement in the software industry
Designing Effective Tests With React Testing Library
React Summit 2023React Summit 2023
151 min
Designing Effective Tests With React Testing Library
Top Content
Featured Workshop
Josh Justice
Josh Justice
React Testing Library is a great framework for React component tests because there are a lot of questions it answers for you, so you don’t need to worry about those questions. But that doesn’t mean testing is easy. There are still a lot of questions you have to figure out for yourself: How many component tests should you write vs end-to-end tests or lower-level unit tests? How can you test a certain line of code that is tricky to test? And what in the world are you supposed to do about that persistent act() warning?
In this three-hour workshop we’ll introduce React Testing Library along with a mental model for how to think about designing your component tests. This mental model will help you see how to test each bit of logic, whether or not to mock dependencies, and will help improve the design of your components. You’ll walk away with the tools, techniques, and principles you need to implement low-cost, high-value component tests.
Table of contents- The different kinds of React application tests, and where component tests fit in- A mental model for thinking about the inputs and outputs of the components you test- Options for selecting DOM elements to verify and interact with them- The value of mocks and why they shouldn’t be avoided- The challenges with asynchrony in RTL tests and how to handle them
Prerequisites- Familiarity with building applications with React- Basic experience writing automated tests with Jest or another unit testing framework- You do not need any experience with React Testing Library- Machine setup: Node LTS, Yarn
Next.js 13: Data Fetching Strategies
React Day Berlin 2022React Day Berlin 2022
53 min
Next.js 13: Data Fetching Strategies
Top Content
WorkshopFree
Alice De Mauro
Alice De Mauro
- Introduction- Prerequisites for the workshop- Fetching strategies: fundamentals- Fetching strategies – hands-on: fetch API, cache (static VS dynamic), revalidate, suspense (parallel data fetching)- Test your build and serve it on Vercel- Future: Server components VS Client components- Workshop easter egg (unrelated to the topic, calling out accessibility)- Wrapping up