Cambiar el Umbral de Accesibilidad (A11y)
Personaliza y prioriza cómo tu organización trata los problemas de accesibilidad
A11y es una abreviatura basada en números (o numerónimo) de la palabra „accesibilidad“, con „11“ (once) representando el número de caracteres entre la inicial „a“ y la final „y“ en accesibilidad. Sigue leyendo para aprender más sobre el umbral a11y y los criterios que el Axe Developer Hub utiliza para su cálculo.
¿Qué es el Umbral de A11y?
El umbral a11y refleja la tolerancia de tu organización hacia los errores de accesibilidad, y es un número que se calcula a partir de dos criterios:
- Si el cálculo utiliza todos problemas de accesibilidad encontrados por Axe Developer Hub durante tus ejecuciones de prueba o solo nuevos problemas descubiertos en la última ejecución de prueba. (La detección de nuevos problemas está disponible solo para proyectos web. ¡Móvil próximamente!)
- Qué niveles de impacto (Crítico, Grave, Moderado y Menor) se incluirán en el cálculo del umbral.
Si cambias alguno de los criterios para el umbral a11y, el cambio solo afectará a los cálculos futuros. Los valores anteriores del umbral a11y no se recalculan. Aparecerá un icono junto al cálculo para indicar que la configuración ha cambiado, y si colocas el cursor sobre él, verás un recordatorio de que el umbral ha cambiado:
El umbral a11y te permite personalizar Axe Developer Hub para lo que es importante para tu organización. ¿Son los nuevos problemas la principal preocupación de tu organización, o quieres rastrear todos los problemas? ¿Qué niveles de impacto deberían priorizarse?
Por ejemplo, el enfoque actual de tu organización puede ser solo mitigar problemas críticos, o tu objetivo puede ser remediar ambos problemas críticos y graves. Si tu organización está comenzando a abordar problemas de accesibilidad, podría ser necesario limitar los niveles de impacto que priorizas para evitar sentirte abrumado. Más adelante, a medida que el conocimiento de tu organización sobre la mitigación de problemas de accesibilidad aumente, podrás cambiar el umbral a11y para incluir problemas de accesibilidad con menor impacto.
¿Cómo se Utiliza el Umbral de A11y?
El umbral a11y proporciona una medida rápida de la calidad de accesibilidad de tu proyecto y aparece de manera prominente a medida que profundizas para identificar problemas en Axe Developer Hub. Cualquier valor por encima de cero supera el umbral de accesibilidad permitido e indica problemas que deben abordarse. Con el tiempo, puedes rastrear el umbral de accesibilidad desde commit a commit, y de versión a versión, para desarrollar una imagen de la salud de accesibilidad de tu proyecto.
En el ejemplo a continuación, puedes ver el umbral a11y calculado en la sección izquierda de cada panel. Aquí, el valor de 2 indica dos problemas que superan el umbral actual:
Hacer clic en el valor del umbral a11y - aquí, 2 - añade los problemas con niveles de impacto correspondientes al filtro, para que puedas profundizar solo en los problemas que superaron el umbral a11y. (En este caso, al hacer clic en 2 se añaden todos los problemas al filtro, ya que todos fueron establecidos en la configuración a11y.)
Configurar el Umbral de A11y
Solo los administradores pueden cambiar los criterios del umbral a11y. Hacerlo cambiará la configuración para todos los usuarios de la empresa.
En tu página Cuenta de Axe haz clic en la pestaña CONFIGURACIÓN en la parte superior de la página. En la página de Configuración, selecciona Axe Developer Hub de la lista en el lado izquierdo de la página para ver y editar la configuración del umbral a11y.
Después de haber cambiado tus configuraciones del umbral a11y, haz clic en GUARDAR.
Problemas Incluidos
El valor Problemas Incluidos indica si se deben incluir en el cálculo del umbral todos los problemas de accesibilidad que cumplen con los impactos seleccionados, o solo los nuevos problemas de accesibilidad. Los Nuevos problemas de accesibilidad son aquellos detectados en tu escaneo actual que no se encontraron en el escaneo con el cual se está comparando, ya sea la ejecución de prueba anterior, el anterior commit o el último escaneo en la rama por defecto. El valor que se muestra para el umbral a11y será consistente en todas las páginas cuando se configure para incluir todos los problemas. Cuando se configure para ver solo problemas nuevos, el valor puede variar por página, porque cada página compara su escaneo contra un punto de referencia diferente.
Nota: La detección de nuevos problemas solo está disponible para proyectos web. Móvil próximamente.
Impactos Incluidos
El valor Impactos Incluidos indica qué nivel o niveles de impacto incluir en el cálculo. Los problemas con Crítico impacto no pueden ser deseleccionados, ya que estos problemas bloquean completamente a los usuarios con discapacidades para acceder o interactuar con una función en una página web o aplicación móvil. Aprende más sobre todos los niveles de impacto.
Usar el Umbral de A11y con la Acción de GitHub
Cuando se utiliza el Acción de GitHub del Axe Developer Hub para proyectos web, el umbral a11y sirve como un guardián para bloquear pull requests que contienen problemas de accesibilidad. La acción añadirá un comentario al pull request indicando el problema:
En el ejemplo anterior, el comentario de la solicitud de extracción conecta a una página del sitio web de Axe Developer Hub donde puede ver una lista de los problemas que fallaron. Puede cambiar el comportamiento predeterminado de la Acción de GitHub para solo advertir a los usuarios sobre problemas de accesibilidad en lugar de bloquear la fusión de la solicitud de extracción.
Cómo Funciona
La Acción de GitHub consulta al servidor de Axe Developer Hub (a través de su punto final REST) por el último commit asociado con la solicitud de extracción. El servicio web devuelve el número de problemas de accesibilidad según lo determinado por los ajustes de umbral de a11y. Cualquier número de errores de accesibilidad por encima de cero se considera un fracaso, lo que añade un comentario a la solicitud de extracción y puede bloquear su fusión.
Vea Usando la Acción de GitHub para más información.