Glossário do Hub de Desenvolvedores do axe

a11y

Abreviação baseada em números (ou numerônimo) para a palavra "acessibilidade", com "11" (onze) representando o número de caracteres entre o "a" inicial e o "y" final em acessibilidade. Pronuncia-se como ally.

Chave de API

Para autorização, você gerará uma chave de API em Configurações da Conta Axe. Você pode usar a mesma chave de API para vários projetos, embora deva usar uma chave de API do Hub de Desenvolvedores do Axe apenas para projetos web e uma chave de API do Axe DevTools Mobile apenas para projetos móveis.

Hub de Desenvolvedores do Axe

Hub de Desenvolvedores do Axe permite que você crie novos projetos de teste e exibe os resultados de suas execuções de teste de acessibilidade. Você pode criar quantos projetos precisar para visualizar e gerenciar a acessibilidade em seus sites e aplicativos móveis.

Melhores Práticas

As melhores práticas da Deque são técnicas testadas ao longo do tempo que oferecem resultados de acessibilidade desejados quando métodos formais específicos são inexistentes ou insuficientes. Embora não estejam oficialmente incluídas em nenhum conjunto de regras de acessibilidade estabelecido, seguir as melhores práticas da Deque pode melhorar a acessibilidade e a qualidade geral da página testada. Deve-se notar que a não conformidade com as diretrizes de melhores práticas da Deque não indica automaticamente uma falha. Além disso, é necessário julgamento especializado para considerar a adequação no contexto dos objetivos da aplicação, site ou página. Às vezes, a técnica de acessibilidade de melhores práticas não é aplicável ou prática para resolver um problema específico. Veja Melhores Práticas para as regras que compõem o conjunto de regras de melhores práticas.

ID de Build

O ID de build é gerado automaticamente como um UUID quando não fornecido pelo usuário, e é usado para vincular as varreduras como uma única sessão de teste. Ao executar uma suíte de testes em várias máquinas ou ambientes, fornecer um ID de build vinculará todas essas execuções juntas e será exibido como uma única sessão no Developer Hub.

Duplicado

Um duplicado é a mesma questão de acessibilidade vista no mesmo nó do modelo de objeto do documento (DOM) em múltiplos estados de página. Se você resolver um problema com duplicados, todos os duplicados desaparecerão porque são todos a mesma questão.

Teste e2e

Fim-a-fim, ou e2e, refere-se ao teste da funcionalidade completa da aplicação web testando sua implementação no mundo real. Com o Hub de Desenvolvedores do Axe, você pode testar cenários e2e para problemas de acessibilidade.

Regras Experimentais

Regras experimentais ainda estão sendo desenvolvidas e testadas para abordar novas tecnologias ou um entendimento e conscientização maior sobre questões de acessibilidade. Essas regras não devem ser usadas em ambientes de produção porque ainda estão em desenvolvimento e estão sujeitas a falsos positivos. Eventualmente, regras deste conjunto podem se tornar parte dos padrões de acessibilidade. As regras experimentais estão desativadas por padrão. Veja Regras Experimentais para as regras que compõem este conjunto de regras na versão mais recente do axe-core.

Git

Muitos projetos do Developer Hub têm suítes de teste que usam um repositório Git . Usar o Git permite associar defeitos de acessibilidade ao código em diferentes ramificações e commits específicos, ajudando na sua resolução.

Gitless

Gitless refere-se a um projeto do Developer Hub com uma suíte de testes que não usa um repositório Git. Embora não seja obrigatório, um repositório Git permite associar defeitos de acessibilidade a alterações específicas no código, auxiliando na sua resolução.

Impacto

Um nível de impacto é atribuído a cada violação de acessibilidade, categorizado em quatro níveis, do menos ao mais impactante: *leve*, *moderado*, *grave*, e *crítico*. Essa métrica ajuda a priorizar os esforços de remediação, e os especialistas em acessibilidade da Deque atribuem um nível de impacto a cada tipo de violação por padrão.

Defeitos com níveis de impacto *grave* ou *crítico* apresentam barreiras significativas ou intransponíveis para usuários com deficiência, com a mais alta responsabilidade legal. Embora questões *leves* e *moderadas* não sejam tão graves, ainda são cruciais para a conformidade e para atender às necessidades de pessoas com deficiência.

Os quatro níveis usados para categorizar o impacto dos problemas de acessibilidade são:

1. Leve: Problemas que afetam usuários com deficiência menos do que problemas moderados, mas ainda requerem resolução para conformidade total.

2. Moderado: Algumas barreiras existem para usuários com deficiência, mas não impediriam o acesso ao conteúdo básico ou fluxos. Estes problemas podem tornar sua organização vulnerável a ações legais e devem ser remediados antes de se atingir a conformidade total.

3. Grave: Usuários com deficiência enfrentarão barreiras significativas ao interagir com o site, causando frustração e dificuldade no acesso ao conteúdo relacionado. A remediação deve ser uma alta prioridade para evitar ações legais.

4. Crítico: Usuários com deficiência são completamente impedidos de acessar ou interagir com uma funcionalidade na página web, tornando o conteúdo inacessível e deixando sua organização altamente vulnerável a processos judiciais. A remediação de problemas críticos deve ser uma prioridade máxima.

Suíte de Teste Modificada

Uma suíte de teste modificada é uma suíte de teste que você alterou de acordo com as instruções fornecidas pelo Axe Developer Hub ao criar um novo projeto. Modificar sua suíte de testes permite adicionar testes de acessibilidade à sua suíte de testes existente com mudanças mínimas na própria suíte de testes.

Administrador Organizacional

Um administrador organizacional (admin org) é um usuário com privilégios administrativos para toda a sua empresa no Axe Account. Admins org podem visualizar todos os projetos da sua empresa e gerenciar membros e configurações do projeto, independentemente de serem membros de um determinado projeto. O status de admin org tem precedência sobre os papéis em nível de projeto. Admins org devem ter uma licença ativa do Axe Developer Hub ou Axe DevTools for Mobile para criar novos projetos ou enviar resultados ao Axe Developer Hub, mas podem gerenciar projetos existentes sem uma licença.

Estado da Página

O estado da página refere-se ao estado do modelo de objeto do documento (DOM) de uma página web em um momento específico. Visualizar diferentes estados da página é útil para sites complexos com telas de login ou interfaces de usuário dinâmicas, como aplicações de página única (SPAs). Exemplos de estado do DOM incluem:

• A visibilidade dos elementos
• O conteúdo dos elementos
• O estado de seleção dos botões de rádio e caixas de seleção

Ao usar o Watcher, o pacote verifica novamente as páginas web sempre que detecta alterações no DOM e salva um novo estado da página a cada vez.

Projeto

Um **projeto** no Axe Developer Hub armazena resultados de acessibilidade, informações sobre execuções de teste e dados do Git (ramificações e commits). Você cria e nomeia um novo projeto no Developer Hub, que cria um ID de Projeto a ser usado nos seus testes para identificar o projeto e associar dados de resultados ao projeto.

Administrador do Projeto

Um **administrador do projeto** é um membro do projeto com permissões elevadas. Os administradores de projeto podem fazer tudo que um membro do projeto pode, além de gerenciar as configurações do projeto, adicionar ou remover membros e alterar funções de membros. Ao usar o Axe Watcher, é necessário a chave de API de um administrador do projeto para executar testes em um pipeline.

ID do Projeto

Um **ID do Projeto** é gerado automaticamente quando você adiciona um novo projeto, para associar seus dados de resultados a esse projeto. Tanto um ID de Projeto quanto uma chave de API são necessários para enviar resultados de acessibilidade ao Developer Hub. É uma boa prática mapear um ID de Projeto para um conjunto de testes/repositório específico, para acompanhar mais precisamente o status de acessibilidade do seu projeto.

Membro do Projeto

Um **membro do projeto** é um usuário que foi adicionado a um projeto do Axe Developer Hub. Os membros do projeto podem executar testes e visualizar resultados dentro do projeto. Os membros devem ter uma licença ativa para acessar o projeto.

SHA

Quando você cria um commit com o Git, ele cria um ID para identificar exclusivamente o commit. Esse ID exclusivo é chamado de **SHA** (nomeado após os Algoritmos de Hash Seguro, um grupo de funções hash criptográficas).

Tag

Uma **tag** agrupa regras que pertencem a uma diretriz específica de acessibilidade, como WCAG. Para mais informações sobre as regras e as tags às quais essas regras pertencem, consulte Descrições de Regras do axe-core

WCAG

**WCAG**, ou _Diretrizes de Acessibilidade para Conteúdo Web_, são um conjunto de diretrizes desenvolvidas pelo World Wide Web Consortium (W3C) para ajudar a tornar o conteúdo da web mais acessível para pessoas com deficiência. Essas diretrizes fornecem um framework para criar sites e conteúdos digitais acessíveis que possam ser usados por pessoas com uma ampla gama de deficiências.

Os três níveis de conformidade do WCAG são definidos por um conjunto de critérios de sucesso que descrevem elementos específicos de conteúdo da web que devem ser cumpridos para alcançar esse nível de conformidade. O nível de conformidade A é o nível mínimo de conformidade, enquanto o nível de conformidade AAA é o mais rigoroso. O nível de conformidade AA requer conformidade com os critérios de sucesso de nível A e nível AA. A conformidade com todos os três níveis de critérios de sucesso (A, AA e AAA) é necessária para a conformidade com o nível AAA.

O WCAG 1.0 foi a primeira versão dessas diretrizes e foi publicado em 1999. O WCAG 2.0 foi publicado em 2008 e forneceu diretrizes mais abrangentes para tornar o conteúdo da web acessível para pessoas com uma variedade maior de deficiências.

O WCAG 2.1 foi publicado em 2018. Ele se baseia nas versões anteriores e inclui novos critérios de sucesso para abordar problemas de acessibilidade que surgiram desde o lançamento do WCAG 2.0. O WCAG 2.1 também fornece mais orientação sobre acessibilidade móvel, acessibilidade para baixa visão e deficiências cognitivas e de aprendizagem.

O WCAG 2.2, a iteração mais recente dessas diretrizes, foi publicado em 2023 e oferece nove novos critérios de sucesso em relação ao WCAG 2.1. Ele fornece orientação aprimorada para atender às necessidades de usuários com deficiências cognitivas ou de aprendizagem, usuários com baixa visão e usuários com deficiências em dispositivos móveis. É compatível retroativamente com o WCAG 2.1.