Editable element accessibility label

Editable elements such as EditTexts or TextViews should have both name and value available to screen readers. This ensures editable elements are fully accessible, allowing their purpose (name) and current value to be accurately communicated to users relying on screen readers.

App Accessibility can automatically check for violations related to editable element accessibility labels. These tools ensure that all editable fields are appropriately labeled and can be read by screen readers, identifying any missing or incorrect labels.

Success criteria

The rule checks for the following potential violations:

• Missing Labels
  Editable elements must have a descriptive label.
• Label-Value Association
  The label should be associated with the corresponding editable element, ensuring screen readers convey both the label and the current value.
• Consistency
  Labels should be consistent across different parts of the application.

How to fix

Example

The following Android example scan report highlights the editable element with the ID com.bsstag.espressotesting:id/url lacks an accessibility label. This violation prevents screen readers from providing the necessary information to users.

Fix

• Add a hint attribute to the EditText element to provide a label.
• Associate the EditText with a TextView using the labelFor attribute to define a relationship between the label and the editable element.

References

• 1.3.1 Info and Relationships (Level A): WCAG 2.1 · WCAG 2.2