# WAI-ARIA Support and Screen Readers

[WAI-ARIA (Web Accessibility Initiative - Accessible Rich Internet Applications)](https://www.w3.org/WAI/PF/aria-practices/) is a World Wide Web Consortium specification. It explains how to increase the accessibility of the web pages to help people with disabilities navigate the Internet.

WAI-ARIA represents a series of HTML attributes that screen readers can use. Attributes like `"role", "area-expanded", "area-haspopup"` and others provide information to the readers and help people with disabilities interact with dynamic content on the page.

Some controls from the Telerik® UI for ASP.NET AJAX suite have support for WAI-ARIA and can, therefore, render such attributes that screen readers can interpret. This help article lists the controls and shows the common way of enabling these attributes.

> note In order to use WAI-ARIA the form element on the page must have a role attribute set to "application" (`<form id="form1" runat="server" role="application">`). For more information on this requirement see: [W3C: WAI-ARIA](https://www.w3.org/TR/wai-aria/roles#application)

The following controls offer WAI-ARIA support:

* [AjaxLoadingPanel](https://www.telerik.com/products/aspnet-ajax/documentation/controls/ajaxloadingpanel/overview)

* [AjaxManager](https://www.telerik.com/products/aspnet-ajax/documentation/controls/ajaxmanager/overview)

* [AjaxPanel](https://www.telerik.com/products/aspnet-ajax/documentation/controls/ajaxpanel/overview)

* [AsyncUpload](https://www.telerik.com/products/aspnet-ajax/documentation/controls/asyncupload/overview)

* [AutoCompleteBox](https://www.telerik.com/products/aspnet-ajax/documentation/controls/autocompletebox/overview)

* [Barcode](https://www.telerik.com/products/aspnet-ajax/documentation/controls/barcode/overview)

* [Button](https://www.telerik.com/products/aspnet-ajax/documentation/controls/button/overview)

* [Calendar (DatePicker, TimePicker and MonthYearPicker)](https://www.telerik.com/products/aspnet-ajax/documentation/controls/calendar/overview)

* [ComboBox](https://www.telerik.com/products/aspnet-ajax/documentation/controls/combobox/overview)

* [DataPager](https://www.telerik.com/products/aspnet-ajax/documentation/controls/datapager/overview)

* [DropDownList](https://www.telerik.com/products/aspnet-ajax/documentation/controls/dropdownlist/overview)

* [Editor](https://www.telerik.com/products/aspnet-ajax/documentation/controls/editor/overview)

* [Filter](https://www.telerik.com/products/aspnet-ajax/documentation/controls/filter/overview)

* [Gantt](https://www.telerik.com/products/aspnet-ajax/documentation/controls/gantt/overview)

* [Grid](https://www.telerik.com/products/aspnet-ajax/documentation/controls/grid/overview)

* [Input](https://www.telerik.com/products/aspnet-ajax/documentation/controls/textbox/overview)

* [Menu](https://www.telerik.com/products/aspnet-ajax/documentation/controls/menu/overview)

* [Notification](https://www.telerik.com/products/aspnet-ajax/documentation/controls/notification/overview)

* [PivotGrid](https://www.telerik.com/products/aspnet-ajax/documentation/controls/pivotgrid/overview)

* [TabStrip](https://www.telerik.com/products/aspnet-ajax/documentation/controls/tabstrip/overview)

* [Tooltip](https://www.telerik.com/products/aspnet-ajax/documentation/controls/tooltip/overview)

* [TreeList](https://www.telerik.com/products/aspnet-ajax/documentation/controls/treelist/overview)

* [TreeView](https://www.telerik.com/products/aspnet-ajax/documentation/controls/treeview/overview)

* [Window](https://www.telerik.com/products/aspnet-ajax/documentation/controls/window/overview)

* [Alert, Confirm, Prompt](https://www.telerik.com/products/aspnet-ajax/documentation/controls/window/alert--confirm--prompt-dialogs/overview)

To enable WAI-ARIA support, you need to set the **EnableAriaSupport** property of the control to **true**. WAI-ARIA is enabled by default only for **RadGantt**. As the WAI-ARIA support cannot be disabled for this control, it does not expose **EnableAriaSupport** property.

Note that the WAI-ARIA attributes are not part of the HTML specifications and a page whose markup contains them would not validate and the browser would enter quirks mode. To avoid this, the Telerik controls render the WAI-ARIA attributes with JavaScript. Thus, you need to examine the source code of the rendered page in the developer toolbar of the browser in order to see them because they will not be present in the markup sent from the server.

A screen reader commonly used with is **JAWS** ([JAWS official site](http://www.freedomscientific.com/products/fs/jaws-product-page.asp)) and the Telerik controls are tested with it.

> note WAI-ARIA support for the *Window* and *Tooltip* controls can be expected to work with *JAWS* when the controls' *Lightweight [RenderMode](https://www.telerik.com/products/aspnet-ajax/documentation/styling/controlling-visual-appearance/render-modes)* is used. With it, they render with semantic HTML elements.
> Both the *Window* and *Tooltip* controls render their popup elements with JavaScript. Thus, it is up to the screen reader software to	detect this change in the DOM and read them out.

## See Also

* [W3C: WAI-ARIA Practices](https://www.w3.org/WAI/PF/aria-practices/)

* [Force JAWS to pronounce artbitrary text with JavaScript](https://www.telerik.com/support/kb/aspnet-ajax/details/force-jaws-to-pronounce-artbitrary-text-with-javascript) KB article

* [Accessibility Compliance](https://www.telerik.com/products/aspnet-ajax/documentation/accessibility/accessibility-compliance)

* [GSA Government-Wide Section 508 Accessibility Program](https://www.access-board.gov/law/ra.html#section-508-federal-electronic-and-information-technology)