WAI-ARIA Support
This article demonstrates how to enable and use the WAI-ARIA support of the RadImageButton control.
The WAI-ARIA Suite defines an approach to make web content and web applications more accessible to people with disabilities. RadImageButton offers WAI-ARIA support.
In order to enable the WAI-ARIA support, set the RadImageButton control's EnableAriaSupport
property to true
and, optionally, set the inner properties (DescribedBy and Label) of the AriaSettings
composite tag to the desired values as shown in Example 1.
Example 1: Enabling WAI-ARIA support for RadImageButton
<telerik:RadImageButton ID="RadImageButton1" runat="server" EnableAriaSupport="true" Text="Image Button with WAI-ARIA attributes" Image-Url="some-image.png">
<AriaSettings DescribedBy="someElementId" Label="Some Label Value" />
</telerik:RadImageButton>
Screen readers may not recognize image buttons when their
aria-label
attribute is set (especially under IE), so you may want to avoid setting theLabel
property inAriaSettings
.
The implementation of the WAI ARIA support is achieved entirely client-side (using JavaScript) by appending different attributes and appropriate WAI-ARIA roles to the DOM elements. This is done because an HTML document containing ARIA attributes will not pass validation if they are added on the server.