Nombre accesible y significativo

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data
Mejores Prácticas Impacto - Menor

El nombre accesible de un elemento no debe incluir su atributo de accesibilidad.

Esta regla aplica una práctica recomendada establecida por las Pautas de interfaz humana de Apple . Puede desactivar esta regla desde el Panel móvil o ignorando la regla en las pruebas escritas para iOS.

Aprenda cómo desactivar las reglas desde el Panel móvil.

Impacto

Los usuarios de VoiceOver deben tener acceso a la misma información visible en la pantalla sin información repetida en el anuncio de VoiceOver.

Confirmación

  1. Activar VoiceOver
  2. Enfócate en el elemento
  3. Ocurrirá uno de los siguientes casos:
    • Inaccesible: VoiceOver anunciará el atributo de accesibilidad del elemento dos veces: como parte del nombre accesible del elemento y como un atributo de accesibilidad (por ejemplo, el anuncio será "Botón Siguiente, botón").
    • Accesible: VoiceOver anunciará el nombre accesible del elemento seguido del rasgo de accesibilidad. El rasgo solo se anunciará una vez después del nombre (por ejemplo, el anuncio será "Siguiente, botón").

Cómo solucionarlo

Un problema encontrado por esta regla se produce cuando el nombre accesible contiene el rasgo de accesibilidad del elemento.

UIKit

En el guión gráfico:

  1. Seleccione el elemento con un MeaningfulAccessibleName problema
  2. Asegúrese de que el Panel de inspectores esté visible
  3. Seleccione el Inspector de identidad
  4. Dentro de Accesibilidad, hay una categoría llamada “Etiqueta”. Ingrese una etiqueta que coincida exactamente o contenga todo el texto visible y que no incluya la característica de accesibilidad del elemento como parte de la etiqueta.

En código:

Encuentre dónde se estableció la etiqueta de accesibilidad y asegúrese de que el valor de la etiqueta de accesibilidad coincida o contenga todo el texto visible del componente y no contenga el rasgo de accesibilidad del elemento.

button.title = "Next"
button.accessibilityTraits = .button

SwiftUI

Asegúrese de establecer una etiqueta de accesibilidad que no incluya la característica de accesibilidad del elemento.

Button(action: {
    openMenu()
}) {
    Text("Next")
}.accessibility(label: Text("Next"))

React Native

Asegúrese de que la etiqueta de accesibilidad de un elemento no contenga el rol de accesibilidad del elemento.

<Button title='Order now' accessibilityLabel='order now' accessibilityRole='button'/>