Usar los Resultados de Accesibilidad con Java

Hay prácticamente formas ilimitadas de aprovechar los resultados de un escaneo de Axe DevTools

Todos los escaneos de accesibilidad impulsados por axe-core se pueden configurar para devolver sus resultados como un objeto JSON. Este formato significa que es fácil de consumir para los recién llegados a la accesibilidad web, contiene la profundidad de información que los expertos en la materia necesitan y permite la generación automática de informes y pruebas personalizadas incluso fuera de un formato de prueba basado en aserciones estándar.

Generar el objeto de resultados

Para generar el objeto de resultados, consulte Generar Informes con Java

Visión General de Resultados

Meta

El objeto de resultados comienza con algunas informaciones meta útiles. Esto incluye el nombre de la prueba, la dirección web de la página probada, la fecha y hora en que se realizó la prueba, el conjunto de reglas de axe-core utilizado, y más.

Conclusiones

El comienzo de los resultados está marcado con el título "Conclusiones". Hay cuatro tipos de resultado, cada uno con su propio arreglo. Estos tipos de resultado son no aplicable, incompleto, aprobado, y violación. Además, hay algunos datos específicos de la prueba ubicados inmediatamente antes del arreglo de violaciones.

No Aplicable

No aplicable significa que no había contenido relevante de la página para esa prueba en particular, como pruebas relacionadas con formularios en una página sin formularios.

Incompleto

Incompletos son pruebas que se ejecutaron, pero cuyos resultados requieren una revisión adicional para determinar en qué categoría deben clasificarse finalmente los resultados. Una ocurrencia común de incompleto son las verificaciones de contraste de color en elementos con fondos de color variable donde no siempre está claro si se cumple el contraste suficiente. No se debe tratar automáticamente los problemas en esta categoría como violaciones, ya que pueden ser o no. Para los usuarios con más conocimientos de accesibilidad, un examen más profundo de estos resultados puede ayudar a encontrar violaciones adicionales que no se pueden probar automáticamente.

Aprobados

Este grupo de resultados enumera las reglas que se verificaron y no encontraron violaciones de accesibilidad relacionadas. Asociado con cada regla aprobada habrá un arreglo de elementos de la página que se verificaron contra la regla y pasaron.

Violaciones

El arreglo de violaciones contiene todas las violaciones de accesibilidad encontradas en el escaneo. Gracias a la política de cero falsos positivos de Deque, cualquier resultado encontrado aquí está garantizado como genuino. Cada violación contiene más información sobre cuál es la violación, dónde está en la página, sugerencias sobre cómo solucionarlo, y más. Vea la referencia de campos a continuación para obtener más información.

Referencia de Campos - Aprobados y Violaciones

• description — Cadena de texto que describe lo que hace la regla
• help — Texto de ayuda que describe la prueba realizada
• helpUrl — URL que proporciona más información sobre los detalles de la violación. Enlaza a una página en el sitio de Deque University.
• id — Identificador único para la regla; ver la lista de reglas.
• impact — Qué tan grave es la violación. Puede ser menor, moderado, serio o crítico si la prueba falló o nulo si la verificación pasó.
• tags — Array de etiquetas asignadas a esta regla. Estas etiquetas se pueden usar en la estructura de opciones para seleccionar qué reglas se ejecutan.
• nodes — Array de todos los elementos que la Regla probó
  • html — Fragmento de HTML del Elemento
  • impacto — Qué tan grave es la violación. Puede ser menor, moderado, serio o crítico si la prueba falló o nulo si la verificación pasó.
  • target — Array de selectores que tiene cada elemento correspondiente a un nivel de iframe o frame. Si hay un iframe o frame, debe haber dos entradas en target. Si hay tres niveles de iframe, debe haber cuatro entradas en target.
  • any — Array de chequeos realizados donde al menos uno debe haber pasado. Cada entrada en el arreglo contiene:
  • id — Identificador único para este check. Los id de check pueden ser los mismos que los de Rule
  • impacto — Qué tan grave es este check en particular. Puede ser menor, moderado, serio o crítico. Cada chequeo que es parte de una regla puede tener diferentes impactos. Se reporta el impacto más alto de todos los chequeos que fallan para la regla.
  • message — Descripción de por qué este chequeo pasó o falló
  • data — Información adicional que es específica del tipo de Check que es opcional. Por ejemplo, un chequeo de contraste de color incluiría el color de primer plano, el color de fondo, la relación de contraste, etc.
  • relatedNodes — Array opcional de información sobre otros nodos que están relacionados con este check. Por ejemplo, una violación de chequeo de id duplicado enumeraría los otros selectores que tienen este mismo id duplicado. Cada entrada en el array contiene la siguiente información:
    • target — Array de selectores para el nodo relacionado
    • html — Fuente HTML del nodo relacionado
  • all — Array de chequeos realizados donde todos deben haber pasado. Cada entrada en el array contiene la misma información que el array any
  • none — Array de chequeos realizados donde todos no deben haber pasado. Cada entrada en el array contiene la misma información que el array any

Uso de Resultados

Deque facilita compartir y digerir los resultados de tus escaneos con nuestro generador de informes. Es configurable para producir informes en HTML, JUnit XML o CSV y una vez configurado, devuelve los informes automáticamente. Consulte la guía sobre informes para aprender cómo configurar y usar el generador de informes.

Además, el objeto de resultados JSON facilita la escritura de tus propias pruebas personalizadas. Más allá de las afirmaciones estándar de violaciones de accesibilidad, puedes dividir el objeto de resultados por violaciones, su gravedad, su impacto, el conjunto de reglas asociado, o cualquiera de los parámetros en el objeto de resultados. Por lo tanto, se puede probar cualquier dato presentado en el objeto de resultados.