Alterar o Limite de Acessibilidade (A11y)
Personalize e priorize como sua organização trata as questões de acessibilidade
A11y é uma abreviação baseada em números (ou numerônimo) para a palavra „acessibilidade“, com „11“ (onze) representando o número de caracteres entre a letra inicial „a“ e a final „e“ em acessibilidade. Continue lendo para saber mais sobre o limite a11y e os critérios que o Axe Developer Hub utiliza para seu cálculo.
O Que é o Limite A11y?
O limite a11y reflete a tolerância de sua organização para erros de acessibilidade, e é um número calculado a partir de dois critérios:
- Se o cálculo utiliza todos questões de acessibilidade encontradas pelo Axe Developer Hub durante suas execuções de teste ou apenas novos questões descobertas na última execução de teste. (A detecção de novos problemas está disponível apenas para projetos web. Em breve para mobile!)
- Quais níveis de impacto (Crítico, Grave, Moderado e Menor) serão incluídos no cálculo do limite.
Se você alterar qualquer um dos critérios para o limite a11y, a mudança somente afetará os cálculos daqui para frente. Os valores antigos do limite a11y não serã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 mudou:
O limite a11y permite personalizar o Axe Developer Hub para focar no que é importante para sua organização. Novas questões são a principal preocupação da sua organização ou você deseja 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 ambos questões críticas e graves. Se sua organização está apenas começando a abordar problemas de acessibilidade, pode ser necessário limitar os níveis de impacto que você prioriza para evitar sobrecarga. Mais tarde, à medida que o conhecimento sobre a mitigação de questões de acessibilidade aumentar, você poderá alterar o limite a11y para incluir questões de acessibilidade com menor impacto.
Como o Limite A11y é Usado?
O limite a11y fornece uma rápida avaliação da qualidade de acessibilidade do seu projeto e aparece de forma proeminente à medida que você aprofunda para identificar problemas no Axe Developer Hub. Qualquer valor acima de zero excede o limite de acessibilidade permitido e indica problemas que precisam ser resolvidos. Com o tempo, você pode acompanhar o limite de acessibilidade de commit a commit, e de lançamento a lançamento, para desenvolver um panorama da saúde de acessibilidade do seu projeto.
No exemplo abaixo, você pode ver o limite 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 a11y - aqui, 2 - adiciona as questões com os níveis de impacto correspondentes ao filtro, para que você possa se aprofundar apenas nos problemas que ultrapassaram o limite a11y. (Neste caso, clicar em 2 adiciona todas as questões ao filtro, porque todas foram definidas na configuração do a11y.)
Configurar o Limite A11y
Somente administradores podem alterar os critérios do limite a11y. Fazer isso irá mudá-lo para todos os usuários da empresa.
Na sua página Conta do Axe , clique na guia 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 a11y.
Depois de alterar suas configurações do limite a11y, clique em SALVAR.
Questões Incluídas
O valor de Questões Incluídas indica se deve incluir no cálculo do limite todas as questões de acessibilidade que atendem aos impactos selecionados, ou apenas as novas questões de acessibilidade. Novas questões de acessibilidade são aquelas detectadas na sua varredura atual que não foram encontradas na varredura a que está sendo comparada - seja a execução de teste anterior, o commit anterior ou a última varredura no ramo padrão. O valor exibido para o limite a11y será consistente em todas as páginas quando configurado para incluir todas as questões. Quando configurado para observar apenas novas questões, o valor pode variar por página, porque cada página compara sua varredura contra uma linha de base diferente.
Nota: A detecção de novos problemas está disponível apenas para projetos web. Em breve para mobile.
Impactos Incluídos
O valor de Impactos Incluídos indica quais níveis de impacto incluir no cálculo. Questões com impacto Crítico não podem ser desmarcadas, pois essas questões bloqueiam completamente usuários com deficiência de acessar ou interagir com uma funcionalidade em uma página web ou aplicativo móvel. Saiba mais sobre todos os níveis de impacto.
Usando o Limite A11y com o GitHub Action
Ao usar o Axe Developer Hub GitHub Action para projetos web, o limite a11y serve como 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 da pull request vincula a uma página no site Axe Developer Hub onde você pode ver uma lista de 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 a fusão da pull request.
Como Funciona
A GitHub Action consulta o servidor Axe Developer Hub (via seu endpoint REST) para o commit mais recente associado à pull request. O serviço web retorna o número de problemas de acessibilidade conforme determinado pelas configurações de limiar de a11y. Qualquer número de erros de acessibilidade acima de zero é considerado uma falha, o que adiciona um comentário à pull request e pode bloqueá-la de ser mesclada.
Veja Usando a GitHub Action para mais informações.