Alterar o Limite de Acessibilidade (A11y)
Personalize e priorize como sua organização trata questões de acessibilidade
A11y é uma abreviação numérica (ou numerônimo) para a palavra „acessibilidade“, com „11“ (onze) representando o número de caracteres entre o começo „a“ e o final „y“ em acessibilidade. Continue lendo para saber mais sobre o limite de a11y e os critérios que o Axe Developer Hub utiliza para seu cálculo.
O Que é o Limite de A11y?
O limite de a11y reflete a tolerância da sua organização para erros de acessibilidade, e é um número calculado a partir de dois critérios:
- Se o cálculo usa todas as questões de acessibilidade encontradas pelo Axe Developer Hub durante suas execuções de teste ou apenas novas questões descobertas na última execução de teste. (A detecção de novos problemas está disponível apenas para projetos web. Móvel em breve!)
- Quais níveis de impacto (Crítico, Sério, Moderado e Menor) serão incluídos no cálculo do limite.
Se você alterar qualquer um dos critérios para o limite de a11y, a mudança apenas afeta os cálculos futuros. Os valores antigos do limite de a11y não são recalculados. Um ícone aparecerá ao lado do cálculo para indicar que a configuração foi alterada, e se você passar o cursor sobre ele, verá um lembrete de que o limite foi alterado:
O limite de a11y permite que você personalize o Axe Developer Hub para o que importa à sua organização. Questões novas são a principal preocupação da sua organização, ou você quer acompanhar todas as questões? Quais níveis de impacto devem ser priorizados?
Por exemplo, o foco atual da sua organização pode ser apenas mitigar questões críticas, ou seu objetivo pode ser remediar tanto questões críticas quanto sérias. Se sua organização está apenas começando a abordar questões de acessibilidade, você pode precisar limitar os níveis de impacto que prioriza para evitar sobrecarregar-se. Mais tarde, à medida que o conhecimento da sua organização sobre mitigação de questões de acessibilidade aumentar, você poderá alterar o limite de a11y para incluir questões de acessibilidade com menor impacto.
Como o Limite de A11y é Usado?
O limite de a11y fornece uma medida rápida da qualidade de acessibilidade do seu projeto e aparece de forma proeminente enquanto você aprofunda a identificação de questões no Axe Developer Hub. Qualquer valor acima de zero ultrapassa o limite de acessibilidade permitido e indica questões que precisam ser resolvidas. Com o tempo, você pode acompanhar o limite de acessibilidade de commit a commit, e de versão a versão, para desenvolver uma visão da saúde de acessibilidade do seu projeto.
No exemplo abaixo, você pode ver o limite de a11y calculado na seção esquerda de cada painel. Aqui, o valor de 2 indica duas questões que excedem o limite atual:
Clicar no valor do limite de a11y - aqui, 2 - adiciona as questões com os níveis de impacto correspondentes ao filtro, para que você possa se aprofundar apenas nas questões que ultrapassaram o limite de a11y. (Neste caso, clicar em 2 adiciona todas as questões ao filtro, pois todas foram definidas na configuração de a11y.)
Configurar o Limite de A11y
Somente administradores podem alterar os critérios do limite de a11y. Fazer isso o mudará para todos os usuários da empresa.
Na sua página de Conta do Axe clique na aba CONFIGURAÇÃO no topo da página. Na página de Configuração, selecione Axe Developer Hub na lista no lado esquerdo da página para ver e editar a configuração do limite de acessibilidade.
Depois de alterar suas configurações de limite de acessibilidade, clique em SALVAR.
Problemas Incluídos
O valor de Problemas Incluídos indica se devem ser incluídos no cálculo do limite todos os problemas de acessibilidade que atendem aos impactos selecionados, ou apenas novos problemas de acessibilidade. Novos problemas de acessibilidade são aqueles detectados em sua varredura atual que não foram encontrados na varredura à qual está sendo comparada - seja a execução do teste anterior, o commit anterior ou a varredura mais recente no branch padrão. O valor exibido para o limite de acessibilidade será consistente em todas as páginas quando configurado para incluir todos os problemas. Quando configurado para observar apenas novos problemas, o valor pode variar por página, pois cada página compara sua varredura com uma linha de base diferente.
Nota: A detecção de novos problemas está disponível apenas para projetos web. Para dispositivos móveis, em breve.
Impactos Incluídos
O valor de Impactos Incluídos indica qual nível ou níveis de impacto incluir no cálculo. Problemas com impacto Crítico não podem ser desmarcados, pois esses problemas impedem completamente que usuários com deficiência acessem ou interajam com um recurso em uma página web ou em um aplicativo móvel. Saiba mais sobre todos os níveis de impacto.
Usando o Limite de Acessibilidade com a GitHub Action
Ao usar a Axe Developer Hub GitHub Action para projetos web, o limite de acessibilidade atua como um guardião para bloquear pull requests que contenham problemas de acessibilidade. A ação adicionará um comentário ao pull request indicando o problema:
No exemplo acima, o comentário do pull request faz link para uma página no site do Axe Developer Hub onde você pode ver uma lista dos problemas que falharam. Você pode alterar o comportamento padrão da GitHub Action para apenas alertar os usuários sobre problemas de acessibilidade, em vez de bloquear o pull request de ser mesclado.
Como Funciona
A GitHub Action consulta o servidor do Axe Developer Hub (via seu endpoint REST) para o último commit associado ao pull request. O serviço web retorna o número de problemas de acessibilidade determinado pelas configurações do limite de acessibilidade. Qualquer número de erros de acessibilidade acima de zero é considerado uma falha, o que adiciona um comentário ao pull request e pode bloqueá-lo de ser mesclado.
Consulte Usando a GitHub Action para mais informações.