diff --git a/text/0000-a11y-routing.md b/text/0000-a11y-routing.md new file mode 100644 index 0000000000..da67b080f0 --- /dev/null +++ b/text/0000-a11y-routing.md @@ -0,0 +1,59 @@ +- Start Date: (2019-01-18) +- RFC PR: (leave this empty) +- Ember Issue: (leave this empty) + +# Accessible Routing in Ember - Route Navigation Announcement + +## Summary + +When the user navigates to a new route within an Ember application, screen readers do not read out the new content or appropriately move focus. This makes Ember applications not natively accessible for users with assistive technology. + +Ember needs to provide a machine-readable way for assistive technology (like screen readers) to know that the route transition has occurred. + +## Motivation + +In a world where accessible websites are increasingly the norm, it becomes good business to ensure that Ember applications are able to reach basic accessibility standards. The first initiative in this area is to ensure that Ember can provide the same level of accessibility as a static website- and the first task is to tackle basic navigation within a web app. + +In a static website, checking `document.activeElement` in the console upon navigation to a new page should return `[object HTMLBodyElement]`. However, in an Ember app this is not the case. For example, if you navigate to one of the pages via the navbar, the focus remains on the element in the navbar. Or, if you navigate via link in the HTML `