Glossário do Axe Developer Hub

a11y

Abreviação numérica (ou numerônimo) para a palavra „acessibilidade“, com „11“ (onze) representando o número de caracteres entre o "a" inicial e "y" final em acessibilidade. Pronunciado como ally.

Chave API

Para autorização, você gerará uma chave de API nas Configurações de Conta do Axe. Você pode usar a mesma Chave de API para vários projetos, mas deve usar uma Chave de API do Axe Developer Hub apenas para projetos web e uma Chave de API do Axe DevTools Mobile apenas para projetos móveis.

Axe Developer Hub

Axe Developer Hub permite criar novos projetos de teste e mostrar os resultados de suas execuções de testes 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 com resultado comprovado que oferecem melhorias de acessibilidade desejadas quando métodos formais específicos são escassos ou insuficientes. Embora não sejam 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, o julgamento de um especialista é necessário 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 Construção

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

Duplicado

Um duplicado é o mesmo problema de acessibilidade visto no mesmo nó do modelo de objeto de documento (DOM) em vários estados de página. Se você resolver um problema com duplicados, todos os seus duplicados desaparecerão porque são todos o mesmo problema.

Teste e2e

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

Regras Experimentais

As regras experimentais ainda estão sendo desenvolvidas e testadas para abordar novas tecnologias ou maior compreensão e conscientização sobre questões de acessibilidade. Essas regras não devem ser utilizadas em ambientes de produção porque ainda estão em desenvolvimento e podem gerar falsos positivos. Eventualmente, as regras deste conjunto podem se tornar parte dos padrões de acessibilidade. 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 com o código em diferentes branches e em commits específicos, auxiliando na sua resolução.

Gitless

Gitless se refere a um projeto do Developer Hub com uma suíte de teste que não usa um repositório Git. Embora não seja necessário, um repositório Git permite associar defeitos de acessibilidade a mudanças específicas no código, auxiliando na sua resolução.

Impacto

Um nível de impacto é atribuído a cada violação de acessibilidade, categorizando-a em quatro níveis do menos ao mais impactante: leve, moderado, gravee 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 graves ou críticos apresentam barreiras significativas ou intransponíveis para usuários com deficiência, com a maior responsabilidade legal. Enquanto questões leves e moderadas não são tão severas, ainda são cruciais para conformidade e para atender às necessidades das pessoas com deficiência.

Os quatro níveis usados para categorizar o impacto das questões de acessibilidade são:

1. Leve: Questões que impactam os usuários com deficiência menos do que questões moderadas, mas ainda exigem resolução para total conformidade.

2. Moderado: Algumas barreiras existem para usuários com deficiência, mas não impediriam o acesso ao conteúdo ou fluxos básicos. Essas questões podem tornar sua organização vulnerável a ações legais e devem ser remediadas antes de alcançar conformidade total.

3. Grave: Usuários com deficiência enfrentarão barreiras significativas ao interagir com o site, causando frustração e dificuldade de 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 estão completamente bloqueados 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 questões críticas 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 teste permite que você adicione testes de acessibilidade à sua suíte de teste existente com mudanças mínimas na própria suíte de teste.

Administrador Organizacional

Um administrador organizacional (admin org) é um usuário com privilégios administrativos para toda a sua empresa na Conta Axe. Admins org podem visualizar todos os projetos em sua empresa e gerenciar membros e configurações de projetos, independentemente de serem membros de um projeto determinado. O status de admin org tem precedência sobre funções em nível de projeto. Admins org devem ter uma licença ativa do Axe Developer Hub ou do Axe DevTools para Mobile para criar novos projetos ou enviar resultados para o 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 de documento (DOM) de uma página da web em um momento específico. Visualizar diferentes estados de página é útil para sites complexos com telas de login ou interfaces dinâmicas, como aplicações de página única (SPAs). Exemplos de estado de DOM incluem:

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

Ao usar o Watcher, o pacote verifica novamente as páginas da 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 contém resultados de acessibilidade, informações de execução de teste e dados do Git (ramificações e commits). Você cria e nomeia um novo projeto no Developer Hub, que gera um ID de Projeto a ser usado em seus testes para identificar o projeto e associar os dados de resultados ao projeto.

Administrador do Projeto

Um administrador do projeto é um membro do projeto com permissões elevadas. Os administradores do 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 as funções dos membros. Ao usar o Axe Watcher, a chave de API de um administrador do projeto é necessária para executar testes em um pipeline.

ID do Projeto

Um ID do Projeto é gerado automaticamente quando você adiciona um novo projeto, para associar os dados dos seus resultados a esse projeto. Tanto um ID de Projeto quanto uma chave de API são necessários para enviar os resultados de acessibilidade para o Developer Hub. É uma prática recomendada mapear um ID de Projeto a um conjunto de testes/repositório, para rastrear 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 de forma única o commit. Este ID exclusivo é chamado de SHA (nomeado após os Algoritmos de Hash Seguro, um grupo de funções de hash criptográficas).

Tag

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

WCAG

WCAG, ou Diretrizes de Acessibilidade para Conteúdo da 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ências. Essas diretrizes fornecem um quadro para criar sites e conteúdos digitais acessíveis que podem ser usados por pessoas com uma ampla gama de deficiências.

Os três níveis de conformidade da 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 atendidos 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 exige conformidade com os critérios de sucesso dos níveis A e AA. A conformidade com os três níveis de critérios de sucesso (A, AA e AAA) é necessária para a conformidade com o nível AAA.

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

A WCAG 2.1 foi publicada em 2018. Ela se baseia nas versões anteriores e inclui novos critérios de sucesso para abordar questões de acessibilidade que surgiram desde o lançamento da WCAG 2.0. A 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.

A WCAG 2.2, a versão mais recente dessas diretrizes, foi publicada em 2023 e oferece nove novos critérios de sucesso em relação à WCAG 2.1. Ela 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ência em dispositivos móveis. Ela é compatível retroativamente com a WCAG 2.1.