Edit this page

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>
tip

Screen readers may not recognize image buttons when their aria-label attribute is set (especially under IE), so you may want to avoid setting the Label property in AriaSettings.

note

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.

See Also