Return to list of success criteria

4.1.2 Name, Role, Value [Level A]

Description

Name, Role, Value

4.1.2 For all user interface components (including but not limited to: form elements, links and components generated by scripts), the name and role can be programmatically determined; states, properties, and values that can be set by the user can be programmatically set; and notification of changes to these items is available to user agents, including assistive technologies. (Level A)Understanding Success Criterion 4.1.2

Note: This success criterion is primarily for Web authors who develop or script their own user interface components. For example, standard HTML controls already meet this success criterion when used according to specification.

Back to top

Sufficent Techniques

Sufficient Techniques for 4.1.2 - Name, Role, Value

Note: Other techniques may also be sufficient if they meet the success criterion.

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

  1. ARIA14: Using aria-label to provide an invisible label where a visible label cannot be used (ARIA)

  2. ARIA16: Using aria-labelledby to provide a name for user interface controls (ARIA)

  3. G108: Using markup features to expose the name and role, allow user-settable properties to be directly set, and provide notification of changes using technology-specific techniques below:

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

  1. 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:

  1. 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 using technology-specific techniques below:

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

  1. G10: Creating components using a technology that supports the accessibility API features of the platforms on which the user agents will be run to expose the names and roles, allow user-settable properties to be directly set, and provide notification of changes using technology-specific techniques below:

Advisory Techniques

Advisory Techniques for 4.1.2 - Name, Role, Value

  • Providing labels for all form controls that do not have implicit labels (future link)

Back to top

Failures

Failures for SC 4.1.2 - Name, Role, Value

Back to top

Notes

Back to top