Glossário

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

Terminologia utilizada pelo axe DevTools para Web

Not for use with personal data

Uma abreviação para acessibilidade: interpretada como a letra a seguida por 11 caracteres e depois a letra y.

Agora

Agora é o repositório interno de artefatos da Deque. Ele é baseado em uma instância de Artifactory. Através do Agora, os usuários podem baixar componentes do axe DevTools, gerenciar e distribuir conjuntos de regras personalizadas, e mais.

ARIA

Accessible Rich Internet Applications (ARIA) é uma especificação técnica publicada pelo World Wide Web Consortium, ou W3C, que define maneiras de aumentar a acessibilidade de páginas web, em particular, conteúdos dinâmicos e componentes de interface de usuário desenvolvidos com Ajax, HTML, JavaScript e tecnologias relacionadas.

Tecnologia Assistiva

Algumas pessoas com deficiência podem não conseguir interagir com softwares e sites por conta própria. Essas pessoas necessitam de tecnologia assistiva para usar a internet de forma equitativa. Uma forma muito comum de tecnologia assistiva é um leitor de tela. Esses dispositivos leem o texto na tela em voz alta para indivíduos com baixa visão ou cegos. Existem muitos leitores de telas diferentes, dependendo da plataforma. Alguns exemplos são NVDA ou JAWS em PC, VoiceOver em Mac, ou TalkBack em Android.

Melhores Práticas

As melhores práticas da Deque são técnicas testadas ao longo do tempo que fornecem resultados de acessibilidade desejados quando métodos formais específicos estão em falta ou são insuficientes. Embora não sejam oficialmente incluídas em nenhum conjunto de regras de acessibilidade estabelecidas, seguir as melhores práticas da Deque pode aumentar a acessibilidade e a qualidade geral da página web 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 de especialista para considerar a adequação no contexto de aplicação, site ou metas da 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.

Plataforma de Automação de Navegador

Para o axe Watcher, uma plataforma de automação de navegador é uma estrutura que você usa para automatizar o teste de seu site. As plataformas incluem Cypress, Playwright, Puppeteer, WebdriverIO e WebDriverJS. Para mais informações, veja

Ponto de Verificação

Um método comprovado para testar os requisitos de acessibilidade criado pela equipe de especialistas em a11y da Deque, que aumenta a consistência e a precisão dos resultados dos testes. Baseados nos Critérios de Sucesso do WCAG, eles fornecem uma categorização e interpretação mais explícitas dessas diretrizes, nas quais as falhas são tipicamente separadas por tipo de conteúdo. Os Pontos de Verificação da Deque ajudam os revisores a produzir resultados de teste consistentes e precisos durante as avaliações de acessibilidade. Um ponto de verificação refere-se à seção mais relevante e aplicável da listagem mestre dos Pontos de Verificação da Deque (e seus requisitos) que são uma parte importante do Caminho Deque para a igualdade digital.

Teste de Componente

Com Cypress ou Playwright e axe Watcher, você pode testar componentes individuais (como componentes React) isoladamente. Contraste isso com Teste e2e, que testa toda a aplicação web em sua implementação real. O Axe Developer Hub pode detectar problemas de acessibilidade em cenários end-to-end e pode testar componentes isoladamente com Cypress. Veja Teste e2e.

Sobrescrição de Configuração

Uma sobrescrição de configuração permite que você personalize configurações para execuções de teste específicas através da propriedade configurationOverrides (JavaScript/TypeScript) ou Classe ConfigurationOverrides (Java) em sua configuração de teste. Essas sobrescrições devem cumprir as configurações de configuração global da sua organização e podem incluir mudanças nos padrões de acessibilidade, melhores práticas, regras experimentais e versões do axe-core.

Conjunto de Regras Personalizado

Um conjunto de regras personalizado é construído a partir de um arquivo JSON contendo dados de regras (regras e verificações) passados para os componentes axe DevTools para adicionar novas regras, alterar a severidade/impacto de uma regra ou remover uma regra do teste.

Duplicado

Um duplicado é o mesmo problema de acessibilidade visto no mesmo nó do modelo de objeto do documento (DOM) em múltiplos estados da página. Se você corrigir um problema com duplicatas, todas as suas duplicatas desaparecerão porque todos eles são o mesmo problema.

Teste e2e

Testes end-to-end, ou e2e, referem-se a testar a funcionalidade de toda a aplicação web por meio de sua implementação real. Com o axe Developer Hub, você pode testar cenários e2e para problemas de acessibilidade e pode testar componentes individuais isoladamente com Cypress. Veja também Teste de Componente.

Evento

Para rastrear o uso de API ou CLI, a biblioteca de métricas cria eventos e os envia para o serviço de uso. Eventos contêm informações sobre o uso, como o número de regras de acessibilidade violadas durante uma varredura de página web e a data e hora em que uma varredura de acessibilidade foi concluída.

Regras Experimentais

Regras experimentais ainda estão sendo desenvolvidas e testadas para atender às novas tecnologias ou ao aumento da 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 estão sujeitas a falsos positivos. Eventualmente, regras neste conjunto de regras 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 na versão mais recente do axe-core.

Flush

A função flush grava os resultados de teste do seu Watcher de axe no servidor Deque e é necessária para garantir que os resultados sejam registrados no axe Developer Hub. Você precisa chamar a função flush em sua suíte de testes.

Gitless

Gitless refere-se ao uso do pacote Watcher com uma suíte de testes que não utiliza um repositório Git. Você não é obrigado a utilizar um repositório Git, mas um repositório Git permite associar defeitos de acessibilidade a alterações específicas de código, ajudando na sua resolução.

Configuração Global

Configuração global é parte de Configuração do axe que permite a você definir várias opções em um só lugar para serem compartilhadas entre diferentes produtos Deque. Seu administrador pode permitir que certas configurações sejam alteradas por usuários.

Token de Identidade

Um Token de Identidade é um token de segurança emitido por JFrog que permite acesso ao repositório de artefatos Agora da Deque. Os Tokens de Identidade devem ser copiados no momento da criação porque essa é a única oportunidade de acessá-los. Eles expiram após um intervalo de tempo designado, geralmente um ano.

Impacto

Toda violação de acessibilidade é atribuída a um nível de impacto. O impacto é uma métrica útil ao priorizar esforços de remediação. Por padrão, cada tipo de violação recebe um nível de impacto dos especialistas em acessibilidade da Deque. Esses valores são generalizados para a maioria das situações, então os usuários podem usar seu julgamento para alterá-los como parte da personalização do conjunto de regras. Níveis de impacto sério ou crítico correlacionam-se a usuários com deficiência encontrando barreiras de uso significativas ou intransponíveis. Estes acarretam o maior grau de responsabilidade legal. Questões menores e moderadas não são tão sérias, mas ainda representam questões importantes para usuários com deficiência e precisam ser abordadas para que a página esteja totalmente em conformidade. Os seguintes quatro níveis são usados para categorizar o impacto dos problemas de acessibilidade detectados:

Crítico: Este nível de impacto significa que usuários com deficiência estarão completamente impedidos de acessar ou interagir com um recurso na página web. Até que uma solução seja implementada, o conteúdo estará totalmente inacessível. Isso torna sua organização altamente vulnerável a processos judiciais. A remediação de problemas críticos deve ser uma prioridade máxima.
Sério: Este nível de impacto significa que usuários com deficiência enfrentarão barreiras sérias ao interagir com o site. Esses usuários experimentarão uma frustração significativa ao tentar acessar o conteúdo relacionado. Até que uma solução seja implementada, algum conteúdo será difícil ou impossível de acessar, tornando sua organização vulnerável a ações legais. A remediação deve ser uma alta prioridade.
Moderado: Este nível de impacto significa que algumas barreiras existem para usuários com deficiência, mas não os impediriam de acessar fluxos ou conteúdo básicos. Questões com impacto a este nível podem tornar sua organização vulnerável a ações legais. Elas requerem resolução antes que uma página esteja totalmente em conformidade e devem ser remediadas.
Menor: Um problema que causa menos impacto para usuários com deficiência do que um problema moderado. O problema pode constituir uma prioridade mais baixa do que questões moderadas, sérias e críticas, mas ainda requer resolução para que uma página esteja totalmente em conformidade.

Teste Orientado Inteligente (IGT)

O Teste Orientado Inteligente (IGT) é um componente interativo de teste de acessibilidade das extensões do navegador web axe DevTools, projetado para encontrar erros de acessibilidade que não podem ser detectados em testes automatizados. O IGT faz perguntas simples ao usuário sobre a página em teste e usa esse feedback para localizar mais erros de acessibilidade do que seria possível apenas com o teste automatizado. Para saber mais sobre os Testes Orientados Inteligentes, visite o documentação de Testes Orientados Inteligentes.

Problema

Uma violação das diretrizes de acessibilidade (como definido por padrões como WCAG 1.0, WCAG 2.0, Seção 508 e WAI-ARIA) identificada no código de uma página web ou aplicação web.

Resultados de Acessibilidade JSON

Ao testar um site para problemas de acessibilidade usando as APIs ou CLI do axe DevTools, seus resultados são salvos como um arquivo JSON que é referido na documentação como um arquivo de resultados de acessibilidade JSON. Você pode fazer upload deste arquivo para o axe Reports (que permite monitorar a acessibilidade do seu site ao longo do tempo através do site axe Reports). Você também pode filtrar e converter o arquivo de resultados de acessibilidade JSON localmente para .csv, .xml ou .html usando a CLI. Veja Relatórios com a CLI para mais informações. Alternativamente, as APIs também permitem que você converta arquivos de resultados de acessibilidade JSON em relatórios durante uma execução de teste (veja Relatórios abaixo para mais informações).

Modo Manual

Por padrão, o axe Developer Hub analisa automaticamente cada uma de suas páginas da web e reanalisa as páginas sempre que detecta um novo estado da página. Você pode desativar esse comportamento automático configurando

(JavaScript/TypeScript) Definindo a propriedade autoAnalyze no objeto de configuração do axe para false.
(Java) Chamando o método setAutoAnalyze() com false.

Você também pode substituir o comportamento de análise automática configurando

(JavaScript/TypeScript) Chamando o método stop().
(Java) Chamando o método AxeWatcherController.stop().

Em qualquer dos casos, isso coloca o Watcher em modo manual. No modo manual, as páginas são analisadas apenas quando você chama o método analyze().

Biblioteca de Métricas

Uma biblioteca interna usada pelas APIs e CLI da Deque para relatar informações de uso ao serviço de uso.

Suíte de Testes Modificada

Uma suíte de testes modificada é uma suíte de testes 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.

Precisa de Revisão

Um problema requer inspeção por um humano para determinar se o problema é uma violação real dos padrões de acessibilidade.

Estado da Página

O estado da página de uma página web refere-se ao estado do modelo de objeto do documento (DOM) em um momento específico. Os estados de página são úteis para sites complexos com telas de login ou interfaces 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 marcado de botões de rádio e caixas de seleção

O pacote Watcher reescaneia páginas web quando detecta mudanças 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 testes e dados do Git (ramificações e commits). A associação entre essas informações e o projeto é feita através do ID do ID do projeto. Quando você cria e nomeia um novo projeto no axe Developer Hub, ele gera um ID de projeto que você utiliza com seus testes para identificar o projeto.

Relatórios

Relatórios referem-se ao upload de um arquivo resultados de acessibilidade JSON para o axe Reports ou à conversão local para um relatório (um arquivo .csv, .xml ou .html) para uso em outro aplicativo.

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. Baseia-se amplamente no WCAG 2.1 e fornece critérios técnicos específicos para avaliar a acessibilidade do conteúdo web. A versão atualmente suportada é a RGAA 4, identificada pelo ID de conjunto de regras rgaav4.

Regra

Uma regra corresponde a um critério de sucesso de diretrizes de acessibilidade. Elas são definidas por arquivos de objeto JSON e contêm um id, descrição e metadados de ajuda, além de uma ou mais verificações e parâmetros opcionais.

Seção 508

É uma emenda ao Ato de Reabilitação dos Estados Unidos de 1973 que exige que agências federais tornem sua tecnologia eletrônica e de informação acessível a pessoas com deficiência. Compreende dezesseis disposições baseadas em diretrizes de acessibilidade desenvolvidas pelas Diretrizes de Acessibilidade para Conteúdo Web (WCAG) desenvolvidas pelo Consórcio World Wide Web (W3C), mas não são idênticas às normas WCAG 1.0 ou 2.0.

SHA

Quando você cria um commit Git, ele gera um ID que identifica unicamente o commit. O ID único é chamado de SHA (um acrônimo para Secure Hash Algorithms, um grupo de funções de hash criptográficas).

Serviço de Uso

Um serviço web REST que registra métricas de uso do axe DevTools para Web (APIs e a CLI). Pode ser o serviço público fornecido pela Deque ou seu próprio serviço. Para mais informações, veja o axe DevTools para Serviço de Uso Web.

Violação

Um problema identificado pelo axe DevTools que viola um ou mais padrões de acessibilidade.

Watcher

O componente de código que você integra em sua suíte de testes é chamado de Watcher. Deque oferece várias edições do pacote para os idiomas e frameworks de teste suportados. Você integra o pacote Watcher em sua suíte de testes de site para analisar páginas web e reportar os resultados ao axe Developer Hub, onde você pode visualizar os resultados. O pacote Watcher também escaneia o commit e a ramificação Git atual e associa execuções de testes a eles.

WCAG

WCAG, ou Diretrizes de Acessibilidade para Conteúdo Web, foram desenvolvidas pelo Consórcio World Wide Web (W3C) e explicam como tornar o conteúdo da Web mais acessível a pessoas com deficiência. WCAG 1.0 foi publicado em maio de 1999. WCAG 2.0 foi publicado em dezembro de 2008. WCAG 2.0 aplica-se amplamente a tecnologias mais avançadas e é mais precisamente testável com testes automatizados e avaliação humana. WCAG 2.1 foi publicado em junho de 2018. Estas diretrizes contêm critérios de sucesso que definem critérios testáveis para elementos específicos. WCAG 2.2, a iteração mais recente das diretrizes, foi publicada em 2023 e oferece nove novos critérios de sucesso em relação ao WCAG 2.1.

Embrulho

Embrulho refere-se à modificação de uma plataforma de automação de navegador (como Cypress) para chamar código de teste de acessibilidade (no pacote Watcher) sempre que uma função da plataforma de automação de navegador for chamada. Embrulho permite integrar testes de acessibilidade em suas suítes de testes existentes com mínimas alterações no seu código.