A acessibilidade em design system não é sobre interfaces feias. É sobre garantir que cada cor, cada borda e cada estado de foco visível cumpram um contrato de legibilidade antes de qualquer discussão estética. Eu costumo dizer que a acessibilidade começa quando números substituem gosto pessoal.
Muita gente acredita que cuidar de contraste e foco engessa a marca, mas a experiência mostra o oposto: quando esses elementos são tratados como componentes de primeira classe, o produto fica mais preciso e confiável. O problema não é o limite de cor, é a ausência de números.
Este artigo explora por que um sistema acessível começa na arquitetura de tokens, passa pelo cálculo de luminância e termina em um pipeline que reprova automaticamente qualquer par de cor inadequado.
- As WCAG 2.2 do W3C definem como critérios centrais para design systems o contraste mínimo de texto (4,5:1 para texto normal e 3:1 para texto grande) e contraste não textual (3:1 para bordas e ícones funcionais).
- O foco visível exige indicador com contraste de pelo menos 3:1 contra cores adjacentes e não pode ficar totalmente obscurecido por elementos fixos ou sobrepostos (critérios 2.4.7, 2.4.11 e 2.4.13).
- A arquitetura de tokens em camadas primitiva, semântica e componente é a base para documentar pares de cores aprovados e reprovados, evitando decisões de cor fora do sistema.
- Testes automatizados de acessibilidade, como axe-core integrado ao pipeline, reduzem o retrabalho de correção de contraste e foco em comparação com validação apenas no QA.
A seguir, você verá como transformar contraste e foco em contratos do sistema de design, com valores concretos e um checklist simples para aplicar antes de publicar.
A camada invisível que decide se um componente passa ou reprova
Quando um botão perde o foco no teclado, não é só um detalhe estético: é a quebra de um contrato de navegação. A pessoa que não usa mouse fica sem saber onde está.
O sistema de design que você constrói hoje herda dez anos de práticas visuais que ignoravam isso. Cada cor que parece boa em um fundo branco pode se desmontar em um banner colorido ou em tema escuro.
A pressão por consistência muitas vezes esconde a ausência de um critério numérico. Sem números, o debate vira opinião e o retrabalho aparece tarde.
Antes de publicar qualquer componente, troque o mouse pelo teclado e percorra a tela com Tab. Se você não enxergar exatamente onde o foco está em cada elemento interativo, o sistema de design já falhou.
Design system acessível: contraste e foco como contrato de engenharia
Um sistema de design acessível é um conjunto de padrões, componentes e tokens que já nasce cumprindo requisitos de legibilidade e navegação por teclado, sem depender de correções manuais no fim do projeto. Não se trata de uma camada adicional de estética, mas de uma propriedade estrutural da arquitetura de cor, tipografia e foco.
Ele funciona como um contrato entre quem projeta, quem codifica e quem usa. Define quais combinações de cores têm contraste suficiente, quais estados de foco são obrigatórios em cada componente e como esses padrões se mantêm em tema claro, escuro e modo de alto contraste.
O que muda quando acessibilidade deixa de ser verniz estético
Quando contraste e foco são tratados como atributos de engenharia, cada componente herda garantias de legibilidade desde o primeiro commit. A cor deixa de ser escolhida por sensação e passa a ser calculada com luminância relativa. O foco deixa de ser um outline padrão do navegador e vira um elemento de interface desenhado com espessura, offset e cor definidos por tokens.
- Textos passam a ter pares de foreground e background validados antes de entrar no código.
- Estados de foco são especificados por componente, não deixados ao acaso.
- A equipe consegue responder com número quando alguém pergunta se aquele cinza claro funciona.
- Mudanças de tema não quebram a legibilidade, porque os tokens são ancorados em relações de contraste e não em valores absolutos.
WCAG 2.2, LBI e ABNT NBR 17225: a base normativa do seu sistema
As Diretrizes de Acessibilidade para Conteúdo da Web do W3C (WCAG 2.2) são a referência técnica internacional, com tradução oficial em português mantida pelo Ceweb.br e NIC.br. Os critérios que mais impactam um sistema de design estão listados abaixo.
- 1.4.3 Contraste Mínimo: 4,5:1 para texto normal e 3:1 para texto grande.
- 1.4.11 Contraste Não Textual: 3:1 para bordas de componentes e ícones com função.
- 2.4.7 Foco Visível: qualquer elemento interativo recebendo foco por teclado deve ter indicador visível.
- 2.4.11 Foco Não Obscurecido: o indicador de foco não pode ficar escondido atrás de banners fixos ou cookies (nível AA).
- 2.4.13 Aparência do Foco: o indicador precisa ter área e contraste mínimos contra cores adjacentes (nível AAA, mas recomendável).
No Brasil, a Lei Brasileira de Inclusão (Lei 13.146/2015) torna a acessibilidade digital uma obrigação legal, o eMAG orienta portais governamentais e a ABNT NBR 17225 estabelece requisitos para conteúdo web. Ou seja, seu sistema de design não está apenas seguindo boas práticas; está evitando exposição jurídica e retrabalho. Na minha leitura, essas normas não são burocracia; elas poupam retrabalho e evitam que a equipe discuta opinião quando deveria seguir número.
Por que corrigir no QA custa de 3 a 5 vezes mais
Quando o contraste e o foco são verificados apenas no final, cada componente já foi desenhado, codificado e testado. A correção de um par de cores pode afetar todo o tema, exigindo novas rodadas de validação visual, testes manuais e ajustes em documentação. Times que validam pares de tokens no sistema de design desde o início evitam esse ciclo.
Esse número não é retórica: em projetos reais, o custo de corrigir acessibilidade na fase de QA costuma ser de três a cinco vezes maior em horas de trabalho do que validar na origem. E o pior é que a falha frequentemente não é técnica, mas de processo: falta um lugar único para registrar quais combinações são permitidas.
Contraste de cor como contrato de tokens, não escolha de última hora
Contraste não é sobre cores claras ou escuras, é sobre a diferença de luminância entre dois objetos. No contexto de sistemas de design, isso significa que cada par de cor de texto e fundo precisa ser calculado e aprovado, e o resultado vira um token semântico que outros componentes só podem consumir.
A fórmula da razão de contraste explicada com luminância relativa sRGB
A razão de contraste segue a fórmula (L1 + 0,05) / (L2 + 0,05), onde L1 é a luminância relativa da cor mais clara e L2 a da mais escura. A luminância relativa sRGB é calculada a partir dos canais R, G e B com uma transformação não linear. O resultado varia de 1:1 (sem contraste) a 21:1 (preto sobre branco).
Na prática, você não precisa fazer a conta manualmente, mas entender a lógica evita decisões erradas: cores saturadas podem parecer contrastadas, mas ter luminâncias próximas. O valor final precisa atender aos pisos da WCAG.
4,5:1 para texto normal, 3:1 para texto grande: mapeando os níveis AA e AAA
| Elemento | Nível AA | Nível AAA |
|---|---|---|
| Texto normal (menor que 18pt ou 14pt negrito) | 4,5:1 | 7:1 |
| Texto grande (18pt ou 14pt negrito) | 3:1 | 4,5:1 |
| Componentes de interface e gráficos informativos | 3:1 | 3:1 (não muda) |
Esses valores não são arbitrários: partem da necessidade de pessoas com baixa visão ou sensibilidade reduzida a contraste conseguirem ler sem esforço. Para a maior parte dos produtos, o nível AA é o alvo realista e legalmente aceitável, enquanto o AAA fica reservado para textos editoriais longos ou situações críticas.
Contraste não textual: bordas, ícones funcionais e estados com 3:1
Muitos times se concentram no texto e esquecem que botões com borda, campos de formulário, ícones de ações e indicadores de seleção também precisam de contraste mínimo. A WCAG 2.2 exige 3:1 entre esses elementos e o fundo adjacente, para que a forma seja percebida sem depender da cor.
Se um botão desabilitado ainda precisa ser identificado como botão, ele deve manter contraste de pelo menos 3:1 na borda ou no fundo. Sumir com o elemento não é acessível.
- Bordas de inputs, checkboxes e radios precisam de 3:1 contra o fundo.
- Ícones que carregam significado (como lixo, editar, menu) seguem a mesma regra.
- Estados como hover, selecionado e foco também devem atender ao contraste quando mudam a aparência.
Foco visível de primeira classe: projetando :focus antes do :hover
O foco visível é o indicador que mostra qual elemento está ativo para quem navega por teclado ou leitor de tela. Em um sistema de design maduro, esse estado é desenhado antes do hover, porque ele é essencial para a operação, enquanto o hover é apenas uma conveniência.
:focus e :focus-visible: a diferença que evita outline indesejado
O seletor :focus aplica o estilo sempre que um elemento recebe foco, inclusive quando o usuário clica com o mouse. O :focus-visible só aplica quando o navegador detecta que o foco veio do teclado ou de uma interação que exige indicação visual. Isso permite remover o outline do clique de mouse sem comprometer a acessibilidade, desde que você forneça um estilo equivalente para :focus-visible.
Nunca faça outline: none no :focus sem substituir por outra indicação visível. Isso é reprovação imediata no critério 2.4.7.
Anel de foco tokenizado: espessura, offset e cor contra qualquer fundo
Um anel de foco robusto usa tokens para espessura, offset e cor, garantindo contraste de 3:1 contra qualquer fundo adjacente. Defina variáveis como –focus-ring-width: 2px, –focus-ring-offset: 2px e –focus-ring-color. O anel externo precisa de 3:1 contra o fundo imediato, e um anel interno claro garante separação quando o componente já tem borda escura. Eu prefiro definir esses tokens já na primeira implementação do componente; depois que o padrão se espalha, mudar fica caro.
Regra de aceite: o anel externo do foco deve ter pelo menos 3:1 de contraste contra a cor de fundo atrás dele, em todos os temas. Se você não consegue medir isso, o token está incompleto.
Foco não obscurecido: headers fixos e banners de cookie que reprovam no AA
O critério 2.4.11 (nível AA) exige que o indicador de foco não fique totalmente escondido por elementos fixos ou sobrepostos. Se um header fixo cobre a parte superior da página e o usuário tabula até um link atrás dele, o foco precisa continuar visível, seja por deslocamento da página, por margem extra ou por garantir que o elemento fixo não se sobreponha.
Banners de cookie, barras de ajuda e modais sem fundo são os maiores vilões. O sistema de design precisa prever esses casos e definir regras de scroll-margin ou z-index para que o foco nunca desapareça.
Arquitetura de tokens acessíveis em camadas primitiva, semântica e componente
Tokens primitivos são valores brutos, como hexadecimais. Tokens semânticos são aliases com significado, como color-text-primary ou color-border-input. Tokens de componente aplicam os semânticos a contextos específicos, como o fundo de um botão primário. Essa separação permite trocar a paleta da marca sem reescrever cada componente.
Alias semântico: separando decisão
O alias semântico permite que uma decisão de acessibilidade seja registrada uma vez e herdada por todos os componentes. Por exemplo, você define color-text-on-primary como branco porque o contraste contra o token color-bg-primary atinge pelo menos 4,5:1. Se um dia a marca mudar o azul primário, o sistema calcula novamente o par e atualiza a documentação, sem quebrar a regra.
- Camada primitiva: valores brutos de cor, tipografia e espaço.
- Camada semântica: papéis claros como texto, fundo, borda e suas relações de contraste.
- Camada de componente: aplicação específica a botões, inputs, cards.
Documente pares de tokens aprovados e reprovados. Um par reprovado deve ser bloqueado por linter ou por design review, não apenas mencionado em uma página.
Depois de acompanhar dezenas de auditorias, eu percebi que a maior resistência não vem da falta de conhecimento técnico, mas do medo de perder a identidade visual. Muitos designers me dizem que o anel de foco grosso ou o texto mais escuro vão estragar a estética refinada da marca. O que eles não percebem é que a inconsistência de contraste e foco já corrói a confiança do usuário mesmo quando ele não sabe nomear o problema. Uma interface que some com o foco ou que tem texto cinza claro transmite fragilidade, não elegância. Quando eu mostro um sistema de design que trata esses estados como parte do vocabulário visual, a reação muda: percebem que é possível ter cara moderna e acessível. A armadilha é achar que acessibilidade é um estilo, quando na verdade é um requisito de engenharia que melhora a qualidade para todo mundo.
Como manter contraste e foco no dia a dia sem virar burocracia
Na rotina de manutenção de um sistema de design, a acessibilidade de contraste e foco aparece em decisões pequenas e repetidas: um novo par de cores para um alerta, um estado de hover em um card, um componente que precisa caber em um banner fixo. Eu vejo que o maior vilão é a pressa em entregar o componente sem revisar o estado de foco. O que separa um sistema saudável de um que acumula dívida não é o heroísmo pontual, mas a presença de critérios claros e automatizáveis.
Erros comuns e como evitá-los
- Remover o outline do navegador sem substituição: alguns times fazem isso por estética, mas o resultado é que ninguém navega por teclado. Sempre ofereça um anel de foco tokenizado com contraste de pelo menos 3:1.
- Tratar contraste como responsabilidade do QA: quando a verificação acontece apenas no final, cada componente já foi construído sobre premissas erradas. Inclua validação de pares de tokens no processo de design review.
- Ignorar superfícies coloridas: um texto branco sobre azul pode passar em um fundo neutro e falhar em um banner com gradiente ou imagem. Crie tokens de superfície que considerem essas variações.
- Focar apenas no tema claro: o tema escuro tem requisitos diferentes de luminância. Um par aprovado no claro pode não funcionar no escuro. Documente tabelas de pares para ambos os temas, incluindo o caso de alto contraste.
- Não testar foco obscurecido: cabeçalhos fixos, barras de progresso e modais sem fundo podem esconder o indicador de foco. Use scroll-margin e verifique manualmente em telas de tamanhos diferentes.
Antes de aprovar um componente, passe por ele usando apenas Tab e Shift+Tab em um navegador sem mouse. Se você não conseguir dizer onde está, o componente não está pronto.
Dúvidas comuns, mitos e limites do contraste e foco
Existem limitações importantes no uso exclusivo da razão de contraste de luminância. A WCAG 2.2 ainda é o padrão para auditoria formal, mas ela não captura completamente a percepção humana em fontes finas, fundos com gradientes ou sobre imagens com ruído. Por isso, times maduros usam o APCA como métrica complementar em prototipação, sem abandonar a exigência dos números WCAG.
Muitas pessoas acreditam que componentes desabilitados não precisam de contraste, mas a recomendação é manter uma relação mínima de 3:1 para que o elemento ainda seja percebido como parte da interface. Outra crença é que o modo de alto contraste do sistema operacional substitui as preocupações de design, mas ele apenas altera as cores do sistema; seu layout e semântica continuam responsáveis pela legibilidade.
- Mito: acessibilidade deixa o design sem personalidade. Fato: sistemas maduros provam que é possível manter marca forte com contraste e foco bem resolvidos.
- Mito: testar acessibilidade é caro e demorado. Fato: a automatização com axe-core no pipeline reduz drasticamente o esforço contínuo, desde que os critérios estejam documentados.
- Diferença crucial: foco visível não é apenas uma borda colorida; é um estado com área mínima e contraste contra o fundo imediato, conforme o critério 2.4.13.
A história do foco visível remonta aos primeiros navegadores, que já desenhavam um outline pontilhado por padrão. Com o tempo, muitos designers removeram esse outline por considerá-lo feio, sem oferecer alternativa, criando uma dívida de acessibilidade que só agora é cobrada com mais rigor. O sistema de design moderno resgata esse padrão, mas com controle tipográfico e de cor.
Três passos para transformar acessibilidade em rotina visual
Resumo Prático
- 01A Escolha Certa: Priorize tokens semânticos com pares de contraste validados. Cada componente herda a acessibilidade em vez de decidir por conta própria.
- 02Ponto de Atenção: Não confie apenas em testes manuais no final. O foco pode estar obscurecido por um banner fixo sem você perceber.
- 03Na Prática: Escolha três componentes piloto, calcule os contrastes, desenhe o anel de foco tokenizado e publique a tabela de pares aprovados e reprovados no repositório.
Se eu tivesse que resumir, diria: se você não consegue medir, não consegue garantir. Quando contraste e foco viram tokens e testes automatizados, a revisão de acessibilidade deixa de ser uma checagem manual no fim do processo e vira parte da definição de pronto. A interface não fica menos bonita; ela fica mais honesta, porque a hierarquia visual nasce de critérios claros e não de truques.
Comece pequeno: escolha um componente, ajuste o anel de foco e valide o contraste. A partir daí, o padrão se espalha. A dívida visual diminui a cada sprint.

