---

Using Accessibility Verifier

In Mac OS X v10.4 and later, Apple provides the Accessibility Verifier tool in /Developer/Applications/Utilities/Accessibility Tools. Accessibility Verifier displays the accessibility hierarchy comprising all currently instantiated objects in the selected application. To use Accessibility Verifier, be sure to enable assistive applications in the Universal Access Preferences.

Use Accessibility Verifier to perform any or all of the following tests (select the tests you want to run by clicking the Choose Tests... button):

• Parent/Child. This test checks the integrity of the accessibility hierarchy by making sure each parent-child pair forms a closed loop. For example, if a child listed in a parent object’s children attribute does not refer to that object as its parent, this parent-child pair is invalid. Invalid parent-child pairs can prevent an assistive application from correctly traversing an application’s accessibility hierarchy.

• Window. This test checks that all objects contained in a window include attributes that refer to the containing window. An object contained in a window is not necessarily the child of that window, but it should refer to its containing window as a convenience for assistive applications.

• Missing AXDescription. This test checks for the presence of the description attribute in accessibility objects that require one. Recall from “The Description Attribute” that all accessibility objects must provide some context-specific descriptive information to assistive applications. If an object does not display a descriptive title, it should include the description attribute and an appropriate value.

• Role Verification. This test verifies that an accessibility object’s attributes are appropriate for its role. See “Roles and Associated Attributes” for more information on the attributes that are associated with each role.

When you click Verify, Accessibility Verifier runs the tests you selected and displays the results for each. The problems are reported as warnings or errors, depending on their severity (you can filter the results by selecting a severity level in the Report Level pop-up menu).

It’s important to note that eliminating all errors and warnings Accessibility Verifier displays does not guarantee a perfectly accessible application. You should always test your application with various assistive applications to make sure there are no problems.

---