Accessibility

We are currently in the process of migrating, updating and centralizing all accessibility content from eBay MIND Patterns and eBay OATMEAL to this new Evo Web site.

Component-level accessibility guidance (accordions, menus, tabs, etc) can be found under the "accessibility" tab of any component . Everything non-component specific can be found in this section of the site.

Component Foundations vs Realities

The ARIA Authoring Practices Guide (APG) is an excellent resource for any web developer learning how to apply accessibility semantics to common design patterns and widgets, and our work here would be a lot more difficult without it. However, a close look at the top of every APG example reveals the following disclaimer:

"The code in this example is not intended for production environments. Before using it for any purpose, read this to understand why ... There may be support gaps in some browser and assistive technology combinations, especially for mobile/touch devices".

To satisfy "production environment" criteria we must take into account the realities of our supported screen reader or browser combinationsand our browser support policy . Resources such as a11ysupport.io , which informs developers about what code features are supported by assistive technologies, and MDN of course, are invaluable for this purpose.

It is the undertaking of a highly iterative process of cross-referencing, engineering & testing, under all of these competing criteria (not to mention visual design considerations), that ultimately produces the production ready version of a component on this site.

How This Section is Organized

This section is organized into the following main categories:

Patterns

User interface patterns that either have not yet been implemented as components, are more general in nature (such as description lists or forms), or just do not fit anywhere else.

Anti-Patterns

Common accessibility anti-patterns, along with recommended alternatives.

Techniques

Specific techniques for addressing common accessibility challenges here (e.g. live regions and keyboard interface types)

Testing

Guidance for manual accessibility testing.

Miscellaneous

Anything that does not fit into the above categories can be found here.