Techniques for WCAG 2.0

On this page:

-

# G135: Using the accessibility API features of a technology to expose names and roles, to allow user-settable properties to be directly set, and to provide notification of changes

## Applicability

programming technologies that have standard components that are programmed to interface with accessibility APIs

This technique relates to:

- Success Criterion 4.1.2 (Name, Role, Value)
  - How to Meet 4.1.2 (Name, Role, Value)
  - Understanding Success Criterion 4.1.2 (Name, Role, Value)

## Description

The objective of this technique is to allow assistive technology to understand Web content so that it can convey equivalent information to the user through an alternate user interface.

Sometimes content is not created using markup language but rather using a programming language or tools. In many cases, these technologies have interface components that are already programmed to interface with accessibility APIs. If an author uses these components and fills in the properties (e.g., name, etc) the resulting user interface components in the content will be accessible to assistive technology.

## Examples

### Example 1

- A Web page uses java to create an applet. Java swing objects (e.g., pushbutton) are used because they have accessibility properties built in that can be accessed from assistive technology written in Java and, with the Java Access Bridge, those written in other languages that use the Accessibility API of the operating system. The author fills in the values for the components and the result is accessible to AT.

## Resources

Resources are for information purposes only, no endorsement implied.

## Related Techniques

(none currently listed)

## Tests

### Procedure

1. Render content using an accessible User Agent

2. Use an Accessibility Tool designed for the Accessibility API of the User agent to evaluate each user interface component

3. Check that name and role for each user interface component are found by the tool.

### Expected Results

- Step #3 is true for each user interface component

- Top
- Contents
- Intro
- Previous: Technique G134
- Next: Technique G136