Usando os Resultados de Acessibilidade com Java

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

Informações sobre o formato dos resultados de acessibilidade

Not for use with personal data

Existem praticamente infinitas maneiras de aproveitar os resultados de uma varredura do Axe DevTools

Todas as varreduras de acessibilidade conduzidas pelo axe-core podem ser configuradas para retornar seus resultados como um objeto JSON. Este formato facilita o consumo para iniciantes em acessibilidade na web, contém a profundidade de informações que especialistas experientes precisam e permite a geração automatizada de relatórios e testes personalizados, mesmo fora de um formato de teste baseado em asserção padrão.

Gerando o objeto de resultados

Para gerar o objeto de resultados, veja Gerar Relatórios com Java

Visão Geral dos Resultados

Constatações

O início dos resultados é demarcado pelo cabeçalho "constatações". Existem quatro tipos de resultado, cada um com seu próprio array. Esses tipos de resultado são inaplicável, incompleto, passou e violação. Além disso, há alguns dados específicos do teste localizados imediatamente antes do array de violações.

Inaplicável

Inaplicável significa que não havia conteúdo da página relevante para aquele teste específico, como testes relacionados a formulários em uma página sem formulários.

Incompleto

Incompletos são testes que foram executados, mas os resultados requerem revisão adicional para determinar em qual categoria os resultados devem ser finalmente classificados. Uma ocorrência comum de incompleto é a verificação de contraste de cor em elementos com background de cor variável, onde nem sempre é claro se o contraste suficiente é atendido. Questões nesta categoria não devem ser automaticamente tratadas como violações, pois podem ou não ser. Para usuários com mais conhecimento em acessibilidade, uma análise mais aprofundada desses resultados pode ajudar a encontrar violações adicionais que não podem ser testadas automaticamente.

Passou

Este grupo de resultados enumera as regras que foram verificadas e não encontraram violações de acessibilidade relacionadas. Associado a cada regra aprovada, haverá um array de elementos da página que foram verificados em relação à regra e passaram.

Violações

O array de violações contém todas as violações de acessibilidade encontradas na varredura. Graças à política de zero falsos positivos da Deque, qualquer resultado encontrado aqui é garantido como genuíno. Cada violação contém mais informações sobre o que é a violação, onde ela está na página, sugestões de como corrigi-la, e mais. Veja a referência de campo abaixo para mais informações.

Referência de Campos - Passou e Violações

description — String de texto que descreve o que a regra faz
help — Texto de ajuda que descreve o teste realizado
helpUrl — URL que fornece mais informações sobre os detalhes da violação. Links para uma página no site da Deque University.
id — Identificador único para a regra; veja a lista de regras.
impact — Quão séria é a violação. Pode ser menor, moderada, séria, ou crítica se o teste falhou, ou nulo se o teste passou
tags — Array de tags atribuídas a esta regra. Essas tags podem ser usadas na estrutura de opção para selecionar quais regras são executadas.
nodes — Array de todos os elementos que a Regra testou
- html — Trecho de HTML do Elemento
- impact — Quão séria é a violação. Pode ser menor, moderada, séria, ou crítica se o teste falhou, ou nulo se o teste passou
- target — Array de seletores em que cada elemento corresponde a um nível de iframe ou frame. Se houver um iframe ou frame, deve haver duas entradas no alvo. Se houver três níveis de iframe, deve haver quatro entradas no alvo.
- any — Array de verificações realizadas onde pelo menos uma deve ter passado. Cada entrada no array contém:
- id — Identificador único para esta verificação. Identificadores de verificação podem ser os mesmos dos identificadores de Regra
- impact — Quão sério é este teste em particular. Pode ser menor, moderado, sério ou crítico. Cada teste que faz parte de uma regra pode ter diferentes impactos. O impacto mais alto de todos os testes que falham é relatado para a regra
- message — Descrição de por que essa verificação passou ou falhou
- data — Informações adicionais que são específicas ao tipo de Verificação, que são opcionais. Por exemplo, uma verificação de contraste de cor incluiria a cor de primeiro plano, cor de fundo, relação de contraste, etc.
- relatedNodes — Array opcional de informações sobre outros nós que estão relacionados a esta verificação. Por exemplo, uma violação de verificação de id duplicado listaria os outros seletores que tinham esse mesmo id duplicado. Cada entrada no array contém as seguintes informações:
  - target — Array de seletores para o nó relacionado
  - html — Fonte HTML do nó relacionado
- all — Array de verificações realizadas onde todas devem ter passado. Cada entrada no array contém as mesmas informações do array any
- none — Array de verificações realizadas onde todas não devem ter passado. Cada entrada no array contém as mesmas informações do array any

Uso dos Resultados

A Deque facilita o compartilhamento e a compreensão dos resultados das suas varreduras com nosso gerador de relatórios. É configurável para produzir relatórios em HTML, JUnit XML ou CSV e, uma vez configurado, retorna relatórios automaticamente. Veja o guia sobre relatórios para aprender como configurar e usar o gerador de relatórios.

Além disso, o objeto de resultados JSON facilita a criação de seus próprios testes personalizados. Além das asserções padrão de violações de acessibilidade, você pode dividir o objeto de resultados por violações, sua gravidade, seu impacto, seu conjunto de regras associado ou qualquer um dos parâmetros no objeto de resultados. Portanto, qualquer dado disposto no objeto de resultados pode ser testado.