Cambiar el umbral de accesibilidad (A11y)
Cómo cambiar el umbral de a11y para personalizar la forma en que su organización trata los problemas de accesibilidad
Este artículo analiza el umbral de accesibilidad (a11y) y cómo cambiar los criterios que utiliza axe Developer Hub para calcular el umbral a11y.
¿Qué es el umbral A11y?
El umbral a11y refleja la tolerancia de su organización a los errores de accesibilidad y es un número que se calcula a partir de dos criterios:
- Si el cálculo utiliza todos los problemas de accesibilidad encontrados por axe Developer Hub durante sus ejecuciones de prueba o solo los nuevos problemas descubiertos en la última ejecución de prueba.
- ¿Qué impactos (críticos, graves, moderados y menores) se incluirán en el cálculo del umbral?
Si cambia alguno de los criterios para el umbral a11y, el cambio solo afectará los cálculos futuros y no los cálculos anteriores; los valores del umbral a11y más antiguos no se vuelven a calcular. Aparecerá un icono junto al cálculo para indicar que la configuración ha cambiado y, si pasa el cursor sobre él, se le recordará que el umbral ha cambiado:
El umbral de accesibilidad le permite personalizar Axe Developer Hub según lo que sea importante para su organización:
- ¿Los problemas nuevos son la principal preocupación de su organización o desea realizar un seguimiento de todos los problemas?
- ¿Qué impactos son importantes para su organización?
Por ejemplo, tal vez usted sólo esté interesado en mitigar problemas críticos, o tal vez usted sólo esté interesado en abordar * problemas críticos y graves* . Quizás su organización recién esté comenzando a abordar problemas de accesibilidad, por lo que necesita limitar el impacto para evitar verse abrumada. Más adelante, a medida que aumente el conocimiento de su organización sobre cómo mitigar los problemas de accesibilidad, podrá agregar impactos graves (o moderados o menores).
¿Cómo se utiliza el umbral A11y?
El umbral a11y proporciona un indicador rápido de la calidad de accesibilidad de su proyecto y aparece de forma destacada en todo el sitio axe Developer Hub. Cualquier valor mayor que cero excede el umbral de accesibilidad permitido e indica problemas que deben abordarse. Con el tiempo, puede realizar un seguimiento del umbral de accesibilidad de un commit a otro y de una versión a otra para desarrollar una imagen del estado de accesibilidad de su proyecto.
Las siguientes páginas muestran el umbral de a11y:
- Ramas página
- Confirmaciones página
- Ejecuciones de pruebas página
- Problemas página
El siguiente ejemplo muestra cómo se muestra el umbral de accesibilidad calculado en la sección izquierda de cada panel (aquí, hay dos problemas sobre el umbral):
![El panel de problemas después de hacer clic en el valor umbral a11y, que agrega los impactos al filtro].(images/dh-issues-a11y-threshold-filters-applied.png)
Al hacer clic en el valor del umbral de accesibilidad (aquí, 2), los impactos se agregan al filtro, de modo que puede explorar en profundidad solo los problemas que provocaron que se excediera el umbral de accesibilidad. (En este caso, al pulsar en 2 se agregaron todos los efectos al filtro porque todos se configuraron en la configuración a11y).
Cómo cambiar
En la página de su cuenta axe haga clic en la pestaña CONFIGURACIÓN en la parte superior de la página:
Verá la página de Configuración. Seleccione Axe Developer Hub de la lista en el lado izquierdo de la página para ver la configuración del umbral de accesibilidad:
Los titulares de cuentas individuales pueden cambiar los criterios de umbral de accesibilidad, pero si usted es parte de una empresa, debe ser administrador de la empresa para cambiarlos.
Si cambia el umbral de a11y como administrador de la empresa, lo cambiará para todos los usuarios.
Después de cambiar la configuración del umbral de a11y, haga clic en GUARDAR.
No puede deseleccionar crítico de la lista de impactos porque los problemas críticos bloquearán contenido para personas con discapacidades y les impedirán acceder a funciones o contenido fundamentales.
Problemas incluidos
El valor Problemas incluidos indica si se debe incluir en el cálculo del umbral.
- todos los problemas de accesibilidad que cumplan con los impactos seleccionados o
- sólo los nuevos .
Impactos incluidos
El valor de impactos incluidos indica qué nivel o niveles de impacto se deben incluir en el cálculo.
En la implementación actual, las configuraciones del umbral de accesibilidad (a11y) son completamente independientes de las configuraciones de accesibilidad global (en la pestaña Global de la página Configuración ) (pero esto puede cambiar en el futuro). Cambiar la configuración en la pestaña Global no cambiará el umbral de accesibilidad (o viceversa).
Uso del umbral de accesibilidad con la acción de GitHub
Puede utilizar el umbral de accesibilidad con la acción axe Developer Hub de GitHub para que actúe como guardián y bloquee, de manera predeterminada, las solicitudes de extracción que contengan problemas de accesibilidad que excedan el umbral de accesibilidad. La acción agregará un comentario a la solicitud de extracción indicando el problema:
![El mensaje que la acción de GitHub agregó a una solicitud de extracción para mostrar que se detectaron problemas de accesibilidad en esta solicitud de extracción].(images/dh-gha-pr-message.png)
En el comentario de solicitud de extracción de ejemplo anterior, el enlace lo dirige a la página Problemas en el sitio web de axe Developer Hub para ver los problemas que hicieron que esta solicitud de extracción fallara. También puede cambiar el comportamiento predeterminado 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 axe Developer Hub (a través de su punto final REST) para obtener la última confirmación asociada con esta solicitud de extracción. El servicio web devuelve la cantidad de problemas de accesibilidad según lo determinado por la configuración del umbral de a11y. De manera predeterminada, cualquier cantidad de errores de accesibilidad superior a cero se considera una falla, lo que provoca que se agregue un comentario como el anterior al pull request y que se bloquee la integración del pull request.
Consulta Uso de la acción de GitHub para obtener más información.