Calculadora de contraste APCA

Esta calculadora de contraste APCA recebe uma cor de texto e uma cor de fundo em códigos hex e devolve o Lc com sinal (contraste de luminosidade) produzido pelo Accessible Perceptual Contrast Algorithm, usado no trabalho de legibilidade do rascunho do WCAG 3. Diferente da razão de contraste WCAG 2.x mais antiga, o APCA é sensível à polaridade: texto escuro sobre superfície clara gera um Lc positivo, enquanto texto claro sobre superfície escura gera um Lc negativo de magnitude semelhante. Designers, desenvolvedores e especialistas em acessibilidade usam esse único número—junto com tabelas de tamanho e peso de fonte—para decidir se o corpo tipográfico, rótulos de interface e traços não textuais permanecem legíveis em telas autoiluminadas. O motor implementa as constantes públicas 0.0.98G-4g: linearização com potência 2.4, coeficientes Y de sRGB, soft-clamp do preto e escalonamento SAPC BoW/WoB. Os resultados são totalmente determinísticos, sem chamadas de rede, amostragem ou atalhos dependentes de data.

O que o Lc do APCA mede e como difere da razão WCAG 2

O APCA prevê o contraste perceptual de texto e conteúdo não textual em telas autoiluminadas modelando o gama do monitor, pretos suaves e a forma assimétrica com que a visão humana trata pares escuro-sobre-claro versus claro-sobre-escuro. A saída é um Lc com sinal que cobre aproximadamente mais ou menos cento e dez: por exemplo, texto de corpo quase preto sobre branco puro costuma ficar perto de Lc noventa ou mais, enquanto as mesmas cores invertidas produzem um Lc negativo grande.

O WCAG 2.x, em vez disso, informa uma única razão de contraste positiva a partir da luminância relativa com cortes fixos AA e AAA como 4.5 para 1 e 7 para 1; essa razão ignora a polaridade e tende a superestimar ou subestimar certos pares de tons médios que as pessoas realmente têm dificuldade de ler.

Esta calculadora sempre devolve o Lc com sinal, a magnitude absoluta, a etiqueta de polaridade BoW (black on white / texto escuro sobre claro) ou WoB (white on black / texto claro sobre escuro), o Y linearizado de cada cor e uma faixa grosseira de legibilidade derivada do Lc absoluto para triagem rápida.

Não há rastreamento de página, parsing de CSS, mistura de opacidade nem amostragem de degradês: você fornece duas cores hex explícitas e recebe um objeto reproduzível adequado a portões de tokens de design, tickets de acessibilidade e revisões automatizadas de paleta que precisam citar um Lc numérico em vez de uma opinião subjetiva sobre uma captura de tela.

Como as entradas hex são lidas e por que o caminho 0.0.98G-4g é determinístico

Ambos os valores devem ser hex: cerquilha inicial opcional, três dígitos que se expandem para seis ou seis dígitos completos, sem distinção de maiúsculas. Sufixos alfa, funções rgb(), funções hsl(), cores CSS nomeadas e inteiros soltos são rejeitados com uma mensagem que nomeia o campo e mostra o que foi recebido, para que um token ruim nunca se torne um fail-open silencioso. Cada cor tem limite de trinta e dois caracteres para manter a validação barata e bloquear colagens acidentais.

Após o parse, cada canal é elevado à potência 2.4 depois de dividir por duzentos e cinquenta e cinco, e combinado com os coeficientes sRGB do APCA 0.2126729, 0.7151522 e 0.0721750 para formar Y. Valores Y quase pretos em ou abaixo de 0.022 recebem o soft-clamp para não penalizar demais o preto puro.

Quando o Y do fundo é maior que o do texto, o ramo BoW aplica expoentes 0.56 e 0.57 com escala 1.14 e deslocamento 0.027; caso contrário o ramo WoB usa 0.65 e 0.62 e devolve um Lc negativo. Deltas de luminância extremamente pequenas são cortadas para zero.

Onde checagens APCA se encaixam em design systems, modo escuro e WCAG 3

Equipes de produto recorrem ao APCA quando uma paleta de marca que passou no WCAG 2 AA ainda parece turva no modo escuro, quando texto cinza médio em superfícies suaves falha testes humanos de legibilidade, ou quando partes interessadas pedem números Lc alinhados às discussões do rascunho do WCAG 3 em vez apenas da razão antiga.

Engenheiros conectam o mesmo contrato a checagens de pull request que bloqueiam uma mudança de token se o Lc absoluto das cores de corpo primárias cair abaixo de um limiar da equipe como sessenta, ou registram valores WoB para títulos hero do tema escuro que ficam de propósito mais perto da superfície. QA e especialistas em acessibilidade anexam Lc com sinal e polaridade a relatórios de bug para que os desenvolvedores corrijam o par exato em vez de adivinhar a partir de uma captura.

Equipes de conteúdo e marketing verificam se os códigos hex de campanha ainda superam as faixas mínimas de corpo quando colocados em fundos claros ou escuros do site. Combine com o verificador de razão WCAG 2 quando ainda precisar de documentação AA/AAA, e com ferramentas de conversão de cor quando precisar de intermediários RGB ou HSL antes de calcular o Lc.