Glossário

a11y

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. É baseado em uma instância Artifactory. Através do Agora, os usuários podem baixar componentes do Axe DevTools Linter e o binário do Connector.

Chave de API

Uma chave de API autoriza o uso do serviço de linting SaaS hospedado pela Deque ou o linting local. Você gerencia suas chaves de API através Configurações de Conta do Axe. Veja Obtendo uma Chave de API SaaS do Axe DevTools Linter para mais informações.

ARIA

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

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. Apesar de não estarem incluídas oficialmente em nenhum conjunto de regras de acessibilidade estabelecido, seguir as melhores práticas da Deque pode melhorar a acessibilidade e a qualidade geral do código que você escreve. É importante 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.

CI/CD

CI/CD significa integração contínua e entrega contínua (ou implantação contínua). Refere-se a pipelines automatizados que constroem, testam e liberam software. O Conector do Axe DevTools Linter e o GitHub Action integram-se aos pipelines CI/CD para detectar problemas de acessibilidade antes de o código ser mesclado ou implantado.

Biblioteca de Componentes

Uma biblioteca de componentes é uma coleção de componentes de UI reutilizáveis. O Axe DevTools Linter possui suporte integrado para várias bibliotecas de componentes populares, incluindo @mui/material, @deque/cauldron-react e react-native, e pode verificar seus componentes como se fossem elementos HTML nativos. Veja Bibliotecas de Componentes Pré-configuradas para mais informações.

Conector

O conector (formalmente o Conector do Axe DevTools Linter) é uma ferramenta de linha de comando para Linux, macOS e Windows que fornece uma interface de linha de comando para verificar seus arquivos. Você pode usá-lo para scripts e pipelines CI/CD. Veja Usando o Conector do Axe DevTools Linter para mais informações.

Componente Customizado

Um componente customizado é um componente de UI que você define ou importa de uma biblioteca de terceiros que não corresponde diretamente a um elemento HTML nativo. O Axe DevTools Linter pode verificar componentes customizados mapeando-os para elementos HTML nativos em sua configuração, permitindo aplicar regras padrão de acessibilidade aos seus componentes. Veja Verificando Componentes Customizados para mais informações.

Diretiva Inline

Uma diretiva inline é um comentário especialmente formatado adicionado diretamente ao código fonte que suprime uma ou mais regras do Axe DevTools Linter para uma linha específica, intervalo de linhas ou o restante de um arquivo. As diretivas inline permitem que você reconheça violações conhecidas sem modificar sua configuração global. Veja Supressão de Regras de Verificação com Diretivas Inline para mais informações.

Chave de Licença

Uma chave de licença é uma alternativa a uma chave de API para autenticar verificação local com o Conector. Diferente de uma chave de API, uma chave de licença não requer autenticação remota e não relata informações de uso. Você deve solicitar uma chave de licença ao Help Desk da Deque. Usar uma chave de licença requer a opção --local do Conector.

Linter

Um linter é uma ferramenta que analisa automaticamente o código-fonte para encontrar problemas, incluindo erros de sintaxe, inconsistências estilísticas e possíveis bugs, sem executar o código. O Axe DevTools Linter é um linter de acessibilidade: ele encontra padrões no código-fonte que podem causar problemas de acessibilidade. Veja Sobre o Axe DevTools Linter.

Verificação de Código

Verificação de Código é o processo automatizado de usar uma ferramenta de verificação para analisar o código-fonte em busca de problemas. O Axe DevTools Linter realiza a verificação de acessibilidade: ele verifica seus arquivos de origem em relação às regras de acessibilidade da Deque e relata qualquer padrão que possa causar barreiras de acessibilidade. Veja Sobre o Axe DevTools Linter.

Verificação Local

Verificação Local é uma opção para o Conector que realiza a análise de acessibilidade na máquina que executa o Conector, em vez de enviar seus arquivos para um servidor. A verificação local é mais rápida e evita dependências de rede. Ela requer uma chave de API ou uma chave de licença. Veja Verificação Local para mais informações.

Implantação Local

Implantação Local (também local) refere-se à execução do servidor Axe DevTools Linter dentro da sua própria infraestrutura, em vez de usar o servidor SaaS hospedado na nuvem da Deque. Uma instalação local oferece controle total sobre o servidor e mantém o conteúdo dos arquivos dentro da sua rede. Veja Instalação e Segurança para mais informações.

Regra

Uma regra é uma verificação de acessibilidade individual que o Axe DevTools Linter aplica aos seus arquivos de origem. Cada regra corresponde a um ou mais critérios de diretrizes de acessibilidade e é identificada por um ID de regra único (por exemplo, image-alt ou label). As regras podem ser ativadas, desativadas ou configuradas para reportar avisos através da sua configuração. Veja Regras de Acessibilidade para a lista completa de regras.

SaaS

SaaS (Software como Serviço) refere-se ao servidor Axe DevTools Linter hospedado na nuvem pela Deque. Quando você usa o servidor SaaS, seus arquivos são enviados para o servidor da Deque para análise. O uso do SaaS requer uma chave de API. Veja Obtendo uma Chave de API SaaS do Axe DevTools Linter para mais informações.

Seção 508

Uma emenda à Lei de Reabilitação dos Estados Unidos de 1973 que exige que as agências federais tornem sua tecnologia eletrônica e de informação acessível a pessoas com deficiências. Ela compreende dezesseis provisões baseadas em diretrizes de acesso desenvolvidas pelas Diretrizes de Acessibilidade de Conteúdo da Web (WCAG) desenvolvidas pelo World Wide Web Consortium (W3C), mas não são idênticas aos padrões WCAG 1.0 ou 2.0.

Análise Estática

Análise Estática é o exame do código-fonte sem executá-lo. O Axe DevTools Linter usa a análise estática para detectar questões de acessibilidade cedo no desenvolvimento, antes que o código seja compilado, mesclado ou implantado. Como a análise estática não executa a sua aplicação, ela não pode detectar todos os problemas de acessibilidade; alguns problemas exigem testes baseados em navegador ou manuais.

Tag

Uma tag é um rótulo que agrupa regras com base no padrão de acessibilidade ao qual correspondem (por exemplo, wcag2a ou best-practice). Você pode usar tags na sua configuração para ativar ou desativar todo um grupo de regras de uma vez. Veja Tags para a lista completa de tags suportadas.

Violação

Uma violação é uma questão de acessibilidade que o Axe DevTools Linter detectou no seu código-fonte — especificamente, um padrão que não está em conformidade com uma ou mais das regras verificadas pelo Axe DevTools Linter. As violações são relatadas com o ID da regra, uma descrição e a localização do arquivo.

WCAG

As WCAG, ou Diretrizes de Acessibilidade de Conteúdo da Web, foram desenvolvidas pelo World Wide Web Consortium (W3C) e explicam como tornar o conteúdo da Web mais acessível para pessoas com deficiências. O WCAG 1.0 foi publicado em maio de 1999. O WCAG 2.0 foi publicado em dezembro de 2008. O WCAG 2.1 foi publicado em junho de 2018. O WCAG 2.2, a iteração mais recente das diretrizes, foi publicado em 2023 e oferece nove novos critérios de sucesso em relação ao WCAG 2.1.