Personalizando Axe DevTools para Regras de Acessibilidade na Web
Modificando sua configuração de regras dentro do Axe DevTools para Web
Dentro das APIs do Axe DevTools, existe a opção de alterar seu conjunto de regras padrão, assim como sua versão do axe-core. À medida que o Axe DevTools é atualizado, o conjunto de regras e a versão do axe-core serão alterados. Para usuários de uma única ferramenta, a configuração específica do conjunto de regras e a versão do axe-core podem não importar. Para usuários de múltiplos componentes do Axe DevTools, garantir que todos usem a mesma configuração de regras e versão do axe-core mantém os resultados das varreduras 100% consistentes entre as ferramentas.
Configuração do Conjunto de Regras
O Axe DevTools tem a capacidade de usar uma ampla variedade de configurações de regras. Para mais informações sobre os diversos conjuntos de regras, leia a página sobre conjuntos de regras axe-core. Você pode mudar para um dos vários outros conjuntos de regras WCAG, ADA seção 508, Trusted Tester v5, EN 301 549, ou RGAA. Além disso, modificações nesses conjuntos de regras, como melhores práticas não cobertas sob a WCAG ou seção 508, ou novas regras experimentais, podem ser adicionadas a qualquer configuração de conjunto de regras. Para uma descrição de cada conjunto de regras, veja Conjuntos de Regras.
O Conjunto de Regras Padrão
A menos que você configure algo diferente, o Axe DevTools para Web APIs e o CLI testam contra WCAG 2.1 Nível AA, identificado pelo ID do conjunto de regras wcag2.1. Como os conjuntos de regras WCAG são cumulativos, isso cobre as regras de nível A e AA tanto da WCAG 2.0 quanto da WCAG 2.1.
Sob o conjunto de regras padrão, regras marcadas best-practice e regras marcadas experimental são desativadas. Uma varredura padrão relata apenas falhas que correspondem aos critérios de sucesso de WCAG 2.1 Nível A e AA, portanto não exibe as descobertas de melhores práticas da Deque, a menos que você opte por elas.
As regras de melhores práticas não fazem parte de nenhum padrão de acessibilidade, mas ajudam a tornar um site o mais equitativo possível no uso. Como ativá-las depende da linguagem, e nem toda integração oferece uma chave dedicada:
| Linguagem | Habilitando melhores práticas |
|---|---|
| Java | Passe true como o segundo argumento para forRuleset(rulesetId, enableBestPractices). Veja o Referência API Java Selenium. |
| C# | Passe true como o segundo argumento para WithRuleset(rulesetId, enableBestPractices). Veja o Referência API C#. |
| Python | Passe enable_best_practices=True para with_ruleset(). Veja o Referência API Python. |
| Node.js e JavaScript | Playwright, Puppeteer e WebdriverIO aceitam uma opção enableBestPractices. Outras integrações selecionam regras por tag em vez disso. Veja o Visão geral de Node.js e JavaScript. |
| Ruby | Não há bandeira de melhores práticas. Adicione a tag best-practice através da cláusula de tag descrita para RSpec e Cucumber. |
| CLI | Gere um arquivo de conjunto de regras que inclua as regras de melhores práticas e aplique-o com --custom. Veja Conjuntos de Regras Personalizados. |
Para testar contra um padrão diferente, passe o ID do seu conjunto de regras no mesmo local. Usando o Conjunto de Regras RGAA explica isso para um padrão e lista o método de seleção para cada linguagem.
Versão do axe-core
O motor de testes de acessibilidade por trás do Axe DevTools, axe-core, está sendo continuamente atualizado e melhorado. Por causa disso, diferentes versões do axe-core podem nem sempre produzir os mesmos resultados de varredura. Garantir que sua versão do axe-core seja consistente entre componentes, desenvolvedores e equipes elimina os riscos associados a diferentes varreduras produzindo resultados diferentes. No Axe DevTools, sua versão do axe-core será sincronizada com sua versão do Axe DevTools. Existe a opção de importar versões específicas do axe-core.