Building Accessible Websites
Visit HTML5Accessibility for information on which new HTML5 features are accessibly supported by Microsoft Edge.
How Accessibility Works
Assistive technologies add capabilities that computers don’t usually have. For example, a visually impaired user might use their keyboard in combination with assistive technology such as a screen reader, rather than directly using the browser with the mouse and screen. For applications on Microsoft platforms and on the web, the assistive technology interacts with Microsoft UI Automation, an application-specific object model such as the Document Object Model (DOM) in Microsoft Edge, or a combination of these.
For web developers, certain HTML elements are mapped to UI Automation objects, so in selecting those HTML elements, the developer can use the accessibility properties and events built in to those elements. While developing your website, you usually only need to be concerned with ensuring that the API is correctly written to (or that the appropriate element is specified), in order for the application to be accessible. Check out ARIA and UI Automation in Microsoft Edge for more information. For information on accessible Universal Windows Platform (UWP) apps, see the Accessibility topic in the Windows Dev Center.
Many common accessibility issues with dynamic content can be addressed by good coding practice, and the WCAG 2.0 documentation includes many techniques and best practices to help you create more accessible dynamic web applications. Even when coded properly, however, dynamic content is not necessarily accessible. Accessible Rich Internet Applications (ARIA) helps overcome this issue.
The Accessible Rich Internet Applications (ARIA) specification by the W3C's Web Accessibility Initiative defines as a syntax for making dynamic web content and custom user interfaces accessible to all people. ARIA extends HTML by using additional attributes (roles, properties, and states) that are designed to convey custom semantics. These attributes are used by browsers to pass along the controls' state and role to the accessibility API.
Roles, Properties, and States
ARIA roles are set on elements using the
role attribute to give assistive technologies and accessibility APIs information about the element. For example, the below
<li> element is assigned
role="menuitem" to signify it's an item in a menu.
ARIA states and properties are aria-prefixed attributes that provide specific information about an object to help form the definition of the nature of roles. Properties are attributes that are essential to the nature of an object, like
aria-haspopup. Changing a property affects the meaning of the object. In the example below, the property
aria-haspopup="true" is set on a
<li> menu item to signify it has a popup.
<li role="menuitem" aria-haspopup="true">Open</li>
States do not change the nature of the object, but represent information associated with the object or user interaction with the object, like
aria-checked. For example, the state
aria-checked="false" in the example below represents that the checkbox is not checked.
<div role="checkbox" aria-checked="false">Accept</div>
Go to The Roles Model by the W3C to see a full list of roles, properties, and states.
For more information on ARIA, see the ARIA in the Resources section.
The A11Y Project is a community-driven effort to make web accessibility easier. Check out their accessibility basics section to learn about basic accessibility principles, their accessible pattern and widget library, and their resources section for more information on accessibility software, blogs, books, and tools.
The W3C’s Web Accessibility Initiative (WAI) is an effort to help improve the accessibility of the web. Their site provides a variety of resources for Getting Started with Web Accessibility, Designing for Inclusion, tutorials and presentations, and more.
The Paciello Group provides consulting and technology solutions to organizations around the world to ensure their clients reach all audiences effectively and efficiently, while meeting governmental and international standards. Their blog covers topics like web accessibility best practices, accessibility tools, and accessibility trends.
Simply Accessible is a team of accessibility specialists providing accessibility training, consulting and more to change the perception of accessibility on the web. Their Articles section discusses best practices for web accessibility, accessible design, and more.
SSB BART Group is a digital accessibility firm supporting their clients in developing and deploying accessible products and services. Their blog addresses topics like ARIA best practices, accessibility trends, webinars, and more.
Practical ARIA examples to enhance your application accessibility
The OpenAjax Alliance website is an excellent resource for verifying the rules for WAI-ARIA and provides a number of examples of WAI-ARIA implementations.
The A11Y Project offers a library of accessible widgets and patterns like menus, buttons, tooltips, and more.
Accessibility Techniques & Tools
Get guidance on creating accessible extensions icons for Microsoft Edge.
This W3C mapping document explains how browsers determine name and descriptions of accessible objects from web content languages and expose them in accessibility APIs.
Accessibility Evaluation Resources is a multi-page resource by the W3C that outlines different approaches for evaluating websites for accessibility.
Test results showing how different content types and standards behave in assistive technologies (AT) like screen readers.
This .NET Web Development and Tools blog post describes the Visual Studio extension Web Accessibility Checker.
This W3C mapping document explains how the semantics of web content languages are exposed to accessibility APIs.
A series of quick checks by the WAI that help you asses the accessibility of a web page.
A quick reference to Web Content Accessibility Guidelines (WCAG) 2.0 requirements (success criteria) and techniques.
This W3C mappings document explains how HTML5.1 element and attributes map to platform accessibility APIs.
A list of quick web development tips for accessibility by The A11Y Project.
The Site Scan tool on Microsoft Edge Dev Center checks for out-of-date libraries, layout issues, and accessibility issues.
Techniques from the W3C that provide guidance for web developers on meeting Web Content Accessibility Guidelines (WCAG) 2.0 success criteria.
Tips from the W3C on developing web content that is more accessible to people with disabilities.
A document by the W3C that provides readers with an understanding of how to use WAI-ARIA 1.1 and recommends approaches to make widgets, navigation, and behaviors accessible using WAI-ARIA roles, states, and properties.
A series of web accessibility guidelines and standards developed by the WAI.
A list of web accessibility evaluation tools to help determine if websites meet accessibility guidelines.
A series of short situational videos by the W3C about the impact of accessibility and the benefits for everyone.