Usando o Conjunto de Regras RGAA com Axe DevTools para APIs Web

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

Como o conjunto de regras RGAA funciona, como se relaciona com WCAG e como selecioná-lo no Axe DevTools para APIs Web e CLI.

Not for use with personal data

RGAA é um dos padrões de acessibilidade contra os quais você pode testar com o Axe DevTools para APIs Web e CLI, identificado pelo ID do conjunto de regras rgaav4. Esta página explica o que é o conjunto de regras RGAA, como ele se relaciona com os conjuntos de regras WCAG quando você lê seus resultados, e como selecioná-lo em cada ligação de linguagem e no CLI. Para uma visão geral de todos os padrões disponíveis, veja Conjuntos de Regras; para informações gerais sobre como mudar seu conjunto de regras e versão do axe-core, veja Personalizando Regras.

O Que É RGAA?

RGAA, ou Référentiel Général d'Amélioration de l'Accessibilité, é o padrão de acessibilidade web do governo francês. Ele é amplamente baseado no WCAG 2.1 e fornece critérios técnicos específicos para avaliar a acessibilidade do conteúdo web. A versão atual suportada é o RGAA 4. Você também pode encontrar o RGAA definido no Glossário.

O RGAA é principalmente relevante para organizações que devem cumprir as obrigações francesas de acessibilidade web, incluindo entidades do setor público e algumas grandes organizações privadas operando na França. Ele é publicado e mantido pelo governo francês no site oficial do RGAA.

Como o RGAA Se Relaciona com WCAG

O RGAA 4 não é um conjunto separado ou mais rigoroso de requisitos técnicos do que o WCAG. Ele transpõe os critérios de sucesso dos níveis A e AA do WCAG 2.1 em 106 critérios de controle testáveis organizados em 13 áreas temáticas, cada uma com procedimentos de teste detalhados. O nível técnico subjacente é essencialmente o WCAG 2.1 AA, com o RGAA adicionando uma metodologia de auditoria prescrita em francês, linguagem francesa e um regime legal de conformidade.

Para alguém que lê os resultados automatizados, a diferença entre o conjunto de regras RGAA e os conjuntos de regras WCAG é principalmente uma questão de rotulagem e escopo, em vez do que é verificado. O axe-core implementa o RGAA adicionando etiquetas RGAA às suas regras existentes, em grande parte baseadas no WCAG, em vez de executar um mecanismo distinto. Selecionar o conjunto de regras rgaav4 executa as regras derivadas do WCAG que correspondem aos critérios do RGAA, além de um pequeno número de regras que o WCAG trata como prática recomendada, mas que o RGAA requer — como region, skip-link, table-duplicate-name e o experimental focus-order-semantics.

important

Como o RGAA requer várias regras que o WCAG classifica como prática recomendada e experimental, uma varredura RGAA revela achados que uma execução padrão do WCAG 2.1 AA não faz. Espere que o conjunto de regras rgaav4 relate problemas que você não veria sob o conjunto de regras padrão wcag2.1.

note

Passar em uma varredura automatizada RGAA não é o mesmo que conformidade total com o RGAA: os testes automatizados cobrem apenas o subconjunto de critérios do RGAA testáveis por máquina, e a conformidade total requer adicionalmente testes manuais, a metodologia oficial de auditoria, uma declaração de acessibilidade e uma taxa de conformidade calculada que estão fora do escopo das ferramentas automatizadas.

Versão do axe-core

O suporte ao RGAA é uma adição recente ao mecanismo de testes de acessibilidade, então o conjunto de regras só está disponível quando sua versão do axe-core for suficientemente atual. Garantir que a versão do axe-core seja consistente entre componentes, desenvolvedores e equipes mantém os resultados das varreduras consistentes; veja Personalizando Regras para como a versão do axe-core é selecionada.

important

O RGAA 4 é suportado apenas nas versões do axe-core 4.11.0 e superiores.

Selecionando o Conjunto de Regras RGAA

Por padrão, o Axe DevTools testa de acordo com o padrão WCAG 2.1 AA. Você seleciona o RGAA da mesma forma que seleciona qualquer outro conjunto de regras, passando o ID do conjunto de regras rgaav4. Cada ligação de linguagem expõe seu próprio método de seleção de conjunto de regras; veja Sobre o Axe DevTools para APIs Web para a lista completa de linguagens e frameworks suportados.

APIs

Python (Visão geral do Python): selecione o conjunto de regras com with_ruleset("rgaav4"). Veja a Referência da API Python ou, para o Robot Framework, a Referência do Robot Framework.
Java (Visão geral do Java): selecione o conjunto de regras com forRuleset("rgaav4"). Veja a Referência da API Java Selenium e a Guia de Testes Java Selenium. A Guia de Testes Java Hamcrest não tem método forRuleset e, em vez disso, seleciona o RGAA como uma etiqueta com accordingTo("RGAAv4").
C# (Visão geral do C#): selecione o conjunto de regras com WithRuleset("rgaav4"). Veja a Referência da API C#, que também expõe RGAAv4 como um valor TagType para seleção baseada em etiqueta.
Node.js e JavaScript (Visão geral do Node.js e JavaScript): o mecanismo difere por framework. Passe o ID do conjunto de regras para AxeDevTools.init("rgaav4") no Referência do JavaScript para Navegadores, use cy.setAxeRuleset("rgaav4") no Documentação da API Cypress, ou defina a opção de construtor rulesetID: "rgaav4" no Referência do WebdriverIO.
Ruby (Introdução ao Ruby): RGAA é suportado nos pacotes Ruby e é selecionado através do mecanismo padrão according_to_ruleset documentado para RSpec e Cucumber. Observe que os exemplos dessas páginas focam nos conjuntos de regras WCAG e Seção 508 e não enumeram rgaav4 explicitamente.

A maioria desses métodos também aceita um argumento opcional para ativar regras de boas práticas; o nome exato varia por linguagem, portanto, consulte a referência vinculada para cada uma.

CLI

O CLI oferece duas maneiras de trabalhar com RGAA. Primeiro, gere um arquivo de configuração padrão do RGAA v4 com axe ruleset --rgaav4, então aplique-o ao escanear com o indicador --custom. Veja Conjuntos de Regras Personalizadas e o Referência CLI.

axe ruleset --rgaav4          # generates rgaav4.json
axe <url> --custom rgaav4.json

Em segundo lugar, você pode registrar o conjunto de regras nos metadados de --format universal produzido ao passar --universal-ruleset rgaav4 (consulte Referência CLI e Testes de Página), ou definir o parâmetro ruleset da ação analyze para rgaav4 em especificações de fluxo de trabalho.

RGAA em Resultados e Tags

Quando você executa o conjunto de regras RGAA, os resultados carregam o marcador de conjunto de regras global RGAAv4 junto com marcadores por critério na forma RGAA-x.x.x (por exemplo, RGAA-3.2.1). Esses marcadores aparecem ao lado dos equivalentes da WCAG e outros marcadores padrão em cada resultado. Por exemplo, uma constatação de color-contrast pode incluir as seguintes tags:

cat.color, wcag2aa, wcag143, TTv5, TT13.c, EN-301-549, EN-9.1.4.3, ACT, RGAAv4, RGAA-3.2.1

Observe a distinção entre os dois identificadores: o ID do conjunto de regras que você passa para as APIs e CLI é a string minúscula rgaav4, enquanto a string do marcador que aparece nos resultados é a capitalizada RGAAv4. Como o axe-core abrange apenas o subconjunto testável por máquina dos critérios do RGAA, a presença de marcadores RGAA nos seus resultados indica as verificações automáticas que foram realizadas, mas não a conformidade total com o RGAA.