Accessibility
When web applications are properly designed and coded, people with disabilities can use them. However, currently many sites and tools are developed with accessibility barriers that make them difficult or impossible for some people to use.
Making the web accessible benefits individuals, businesses, and society. International web standards define what is needed for accessibility.
Wisej.NET has basic accessibility support built-in and provides a WebARIA extension to support most of the WAI-ARIA properties.
The WebARIA extension is provided with source code to enable developers to extend it and adapt it to their requirements.
Accessible Properties
All Wisej.NET controls expose two accessible properties:
- AccessibleName. Rendered in the browser as the
aria-labelattribute. - AccessibleDescription. Rendered in the browser as the
aria-descriptionattribute.
The role — button, textbox, tab, grid and so on — is decided by the control and rendered automatically, together with its ARIA state attributes. See Accessibility in the 4.1 release notes for the roles and attributes each control emits.
The AccessibleRole property and the Wisej.Web.AccessibleRole enumeration were removed in Wisej.NET 4.1. The role of a control can no longer be changed.
How an accessibility tool interprets these properties depends on the tool.
WebARIA Extension
The WebARIA extension is an extender component that you can drop on any designer surface. It will automatically add a number of new properties to all the controls in the designer.
Some properties reference other controls on the same page. Select the related control in the property grid, and the extension generates the corresponding WAI-ARIA attribute in the browser.
For example, setting the DescribedBy property of a button to a Label, will generate the "aria-describedby" attribute with the id of the label.
See the WebARIA extension for more information.