diff --git a/understanding/20/name-role-value.html b/understanding/20/name-role-value.html index e0db538bbb..8629273f72 100644 --- a/understanding/20/name-role-value.html +++ b/understanding/20/name-role-value.html @@ -1,50 +1,41 @@ - + Understanding Name, Role, Value

Understanding Name, Role, Value

-

In brief

Goal
People using assistive technology understand all components.
What to do
Give components correct names, roles, states, and values.
-
Why it's important
Assistive technology only works well when code is done properly.
+
Why it's important
Assistive technology only works well when code is done properly.
-
-

Intent of Name, Role, Value

- -

The intent of this Success Criterion is to ensure that Assistive Technologies (AT) can gather appropriate information about, activate (or set) and keep up to date on the status of user interface controls in the content.

-

When standard controls from accessible technologies are used, this process is straightforward. If the user interface elements are used according to specification the conditions of this provision will be met. (See examples of Success Criterion 4.1.2 below)

-

If custom controls are created, however, or interface elements are programmed (in code or script) to have a different role and/or function than usual, then additional measures need to be taken to ensure that the controls provide important and appropriate information to assistive technologies and allow themselves to be controlled by assistive technologies.

-

What roles and states are appropriate to convey to assistive technology will depend on what the control represents. Specifics about such information are defined by other specifications, such as WAI-ARIA, or the relevant platform standards. Another factor to consider is whether there is sufficient accessibility support with assistive technologies to convey the information as specified.

-

A particularly important state of a user interface control is whether or not it has focus. The focus state of a control can be programmatically determined, and notifications about change of focus are sent to user agents and assistive technology. Other examples @@ -52,48 +43,32 @@

Intent of Name, Role, Value

been selected, or whether a collapsible tree view or accordion is expanded or collapsed.

-
-

Success Criterion 4.1.2 requires a programmatically determinable name for all user interface components. Names may be visible or invisible. Occasionally, the name needs to be visible, in which case it is identified as a label. Refer to the definition of name and label in the glossary for more information.

-
- -

Benefits of Name, Role, Value

- - -
-

Examples of Name, Role, Value

-
Accessible APIs
A Java applet uses the accessibility API defined by the language.
-
-

Resources for Name, Role, Value

- - -
-

Techniques for Name, Role, Value

- -

Sufficient Techniques for Name, Role, Value

- -
-

Situation A: If using a standard user interface component in a markup language (e.g., HTML):

- -
-
-

Situation B: If using script or code to re-purpose a standard user interface component in a markup language:

-
    -
  • -

    Exposing the names and roles, allowing user-settable properties to be directly set, and providing notification of changes using one of the following techniques:

    -
      -
    • - -
    • -
    -
  • -
-
-
-

Situation C: If using a standard user interface component in a programming technology:

- -
-
-

Situation D: If creating your own user interface component in a programming language:

- -
-
-

Additional Techniques (Advisory) for Name, Role, Value

-
-

Failures for Name, Role, Value

- - -
-
-