Elementos con etiquetas de tipo o de estado

Los usuarios de servicios de accesibilidad (como los lectores de pantalla) dependen de las etiquetas de texto para interactuar con interfaces de usuario.

Los lectores de pantalla indican la etiqueta de texto, además de información sobre el tipo de elemento o su estado. Por tanto, ya no es necesario que los desarrolladores de aplicaciones incluyan información sobre el tipo o el estado de los elementos dentro de las etiquetas. Por ejemplo:

• Cuando TalkBack indica un elemento Button en el que se puede hacer clic, añade la palabra "botón" a la etiqueta de texto proporcionada por el desarrollador. Si el desarrollador incluye "botón" en la etiqueta de texto (por ejemplo, "botón para guardar"), es posible que TalkBack repita dos veces esta palabra ("botón botón para guardar").
• Si una interfaz incluye un elemento CheckBox, el lector de pantalla detecta si el elemento está marcado y, por tanto, indicará "marcado" o "no marcado" junto con la etiqueta de texto proporcionada por el desarrollador. Si este incluye "marcado" o "no marcado" en la etiqueta de texto, es posible que el usuario escuche esta información dos veces.

Las tecnologías asistenciales suelen definir su propio conjunto de gestos o comportamientos de interacción adaptados a las necesidades de los usuarios. Las etiquetas de accesibilidad proporcionadas por la aplicación dependen de la tecnología asistencial utilizada y no deben dar instrucciones de interacción específicas, ya que podrían ser incorrectas. Por ejemplo:

• TalkBack incluye sus propias instrucciones de interacción del tipo "Toca dos veces para seleccionar" para describir elementos de la interfaz con los que se puede interactuar. Si se incluyen estas instrucciones en las etiquetas de accesibilidad proporcionadas por la aplicación, es posible que TalkBack repita dos veces las instrucciones. Si la aplicación facilita las instrucciones, estas no serían adecuadas para usuarios de accesibilidad con interruptores.

Implementación

View

Elementos estándar

Al incluir etiquetas de texto en los elementos estándar de la interfaz de usuario proporcionados por el SDK para Android, por la biblioteca de compatibilidad de Android o por la biblioteca de compatibilidad de diseño de Android, debes utilizar una breve cadena localizada que describa lo que hace o representa el elemento.

En las interfaces de usuario implementadas correctamente no se añaden descripciones sobre el tipo de elemento ni sobre su estado a los valores de los atributos android:contentDescription, android:text ni android:hint.

Vistas personalizadas

Al crear elementos de la interfaz de usuario con vistas personalizadas, debes ampliar la subclase View más relevante, ya que también es pertinente en tu caso. De esta manera, la implementación de una vista personalizada hereda todo el comportamiento de interacción posible de la accesibilidad estándar de la plataforma. Además, en muchos casos, la correcta representación del tipo de vista y de su estado se gestiona en nombre de tu aplicación.

Una aplicación puede modificar la manera en que aparece una vista personalizada en los servicios de accesibilidad, incluido cómo se representa su tipo o su estado, mediante AccessibilityDelegate o View#onInitializeAccessibilityNodeInfo. Para usar este método, es necesario que la vista gestione directamente su propia representación de AccessibilityNodeInfo.

En las vistas personalizadas con jerarquías de información complejas o en aquellas capaces de realizar varias acciones, la clase ExploreByTouchHelper puede simplificar la representación de las jerarquías de vistas virtuales en los servicios de accesibilidad de Android.

Compose

Elementos estándar

Al incluir etiquetas de texto en los elementos estándar de la interfaz de usuario proporcionados por la biblioteca estándar de Jetpack Compose, debes utilizar una breve cadena localizada que describa lo que hace o representa el elemento.

En las interfaces de usuario implementadas correctamente no se incluyen descripciones sobre el tipo de elemento ni sobre su estado en las descripciones del contenido ni en los atributos Modifiers.semantics#text.

Una aplicación puede modificar la manera en que aparecen los elementos componibles de nivel bajo en los servicios de accesibilidad, incluido cómo se representa su tipo o su estado, mediante Modifier.semantics o Modifier.semantics#role.

Diseño

Consulta las directrices de accesibilidad de Material Design para obtener más información sobre cómo crear etiquetas eficaces.

Pruebas

Sigue estos pasos para identificar manualmente los elementos de la interfaz de usuario que tienen etiquetas de tipo o de estado:

1. Activa TalkBack.
2. Abre la aplicación.
3. Mueve el enfoque de accesibilidad al elemento que quieras evaluar.
4. Escucha la descripción que proporciona TalkBack del elemento enfocado. Comprueba si el tipo o el estado del elemento se indican más de una vez en la descripción.

Las herramientas de prueba automáticas de Android pueden detectar ciertos elementos de la interfaz de usuario etiquetados con el tipo, el estado o las instrucciones de interacción. Te recomendamos que utilices Test de Accesibilidad para Android para probar tu aplicación manualmente en el dispositivo. Si quieres realizar pruebas automáticas, activa las comprobaciones de accesibilidad en Espresso y Robolectric.