Cor

Guia de contraste de cores: WCAG, razões AA/AAA e transparência

·

Um verificador de contraste de cores compara a luminância relativa das cores de primeiro plano e de fundo. O ToolMellow calcula a razão de contraste sRGB das WCAG 2.2 e mostra cinco resultados para texto normal, texto grande e informação não textual essencial. Edite Cor do texto, Cor de fundo ou Tela atrás da transparência; o resultado é recalculado imediatamente no navegador.

O resultado descreve o par de cores sólidas informado após a composição de transparência da ferramenta. Use-o para escolher e documentar cores, depois examine conteúdo real, tipografia, superfícies adjacentes e estados de interação. Um par aprovado é parte da evidência de acessibilidade, não uma auditoria completa do site nem uma garantia de leitura confortável para todas as pessoas.

Verificador de contraste de cores

Como verificar um par de texto e fundo

Informe os valores reais de texto e fundo. Cor do texto começa em #294C39, enquanto Cor de fundo e Tela atrás da transparência começam em #FFFFFF. Nomes CSS, HEX, RGB/RGBA e HSL/HSLA são aceitos dentro da gramática compatível. A sintaxe dos valores continua sendo CSS quando o idioma da interface muda.

Leia a razão e a linha correspondente ao uso pretendido. Editar cores ou a tela recalcula imediatamente; um valor inválido mostra erro e oculta relatório e pré-visualização até voltar a ser válido. Texto da pré-visualização, Tamanho do texto (px) e Texto em negrito ajudam a examinar o exemplo. Copiar relatório e Baixar relatório preservam um retrato do cálculo naquele momento.

  • Use as cores aplicadas ao elemento e à superfície reais, incluindo tema e estado relevantes.
  • Para transparência, identifique a superfície opaca abaixo em vez de presumir uma página branca.
  • Salve o par e o resultado completo e examine o componente real antes de alterar tokens compartilhados.

Cinco resultados: texto normal, texto grande e gráficos essenciais

A tabela apresenta os mínimos inclusivos comparados pela ferramenta: a razão sem arredondamento deve alcançar o valor indicado. Texto normal e grande têm linhas AA e AAA. A linha de interface e gráficos essenciais compara com 3:1, associado ao contraste não textual; decidir se uma parte ou um estado específico está coberto ainda exige seu contexto real.

As cinco linhas continuam visíveis quando o tamanho ou peso da pré-visualização muda. A mensagem de texto normal/grande não substitui a tabela nem aumenta a razão numérica. Aprovar AA para texto normal não satisfaz automaticamente AAA para texto normal, e uma aprovação de texto grande não deve ser usada para texto de corpo menor.

Cinco resultados: texto normal, texto grande e gráficos essenciais
UsoRazão mínimaIndicador do relatório
Texto normal · AA4.5:1normalAA
Texto normal · AAA7:1normalAAA
Texto grande · AA3:1largeAA
Texto grande · AAA4.5:1largeAAA
Interface e gráficos essenciais · AA3:1nonTextAA

W3C WCAG 2.2: Critérios, texto grande, luminância relativa e razão de contrasteW3C Understanding 1.4.3: Contraste (mínimo)W3C Understanding 1.4.6: Contraste (aprimorado)W3C Understanding 1.4.11: Contraste não textual

O que a razão mede e por que o arredondamento importa

Para cada canal sRGB efetivo, defina c = channel / 255. A ferramenta usa c / 12.92 quando c <= 0.04045; caso contrário, ((c + 0.055) / 1.055) ^ 2.4, obtendo o valor linear. A luminância relativa é L = 0.2126R + 0.7152G + 0.0722B com esses valores lineares R/G/B. O contraste é (Llighter + 0.05) / (Ldarker + 0.05). A razão vai de 1:1 para luminâncias iguais a 21:1 para preto e branco; não é a diferença entre strings HEX ou nomes de matizes.

A interface mostra duas casas decimais conforme o idioma selecionado, mas Aprovado/Reprovado compara a razão calculada completa. Um valor logo abaixo de 4.5 pode aparecer como 4.50:1 e ainda reprovar AA para texto normal. Compare o número do relatório com seu limite em vez de arredondar o valor mostrado para cima. O HEX do fundo efetivo também é arredondado para exibição, enquanto o cálculo mantém os canais compostos fracionários.

W3C WCAG 2.2: Critérios, texto grande, luminância relativa e razão de contrasteW3C Understanding 1.4.3: Contraste (mínimo)

Texto grande: pontos, pixels CSS e indicador da pré-visualização

A definição WCAG de texto grande inclui 18 pontos ou 14 pontos em negrito, com condições para tamanhos equivalentes CJK e fontes finas ou incomuns. Unidades absolutas CSS estabelecem 96 pixels e 72 pontos por polegada: 18 pontos correspondem a 24 pixels CSS, e 14 pontos a cerca de 18.67 pixels CSS. Pixels físicos da tela e a densidade configurada em um editor de imagens não são intercambiáveis com esses tamanhos CSS.

A pré-visualização começa em 16 pixels CSS e peso normal. Tamanho do texto (px) fica limitado a 10–72, e Texto em negrito usa peso 700 em vez de 400. O indicador de texto grande exige tamanho de pelo menos 24 ou negrito com tamanho de pelo menos 18.6666666667. É uma regra de pré-visualização, não detecção automática das métricas reais da fonte ou do tamanho equivalente de cada sistema de escrita. Avalie separadamente a tipografia e o conteúdo reais.

Texto grande: pontos, pixels CSS e indicador da pré-visualização
Pré-visualizaçãoClassificaçãoMudança só por tamanho/peso
16 px, normalTexto normalNenhuma
24 px, normalTexto grandeNenhuma
18.66 px, negritoTexto normal pelo corte da ferramentaNenhuma
18.67 px, negritoTexto grandeNenhuma

W3C WCAG 2.2: Critérios, texto grande, luminância relativa e razão de contrasteW3C CSS Values and Units 4: Comprimentos absolutos

Exemplos com cores sRGB opacas

Use os valores exatos de primeiro plano e fundo abaixo sobre uma tela branca opaca. As razões da tabela usam a notação inglesa de duas casas decimais; os indicadores vêm do cálculo completo. Os exemplos cinza mostram como uma pequena alteração de canal pode cruzar um limite sem parecer uma grande diferença visual.

Estes são cálculos de pares, não paletas universais recomendadas. Alterar um token compartilhado pode afetar outros elementos, temas e estados. Preto opaco sobre branco dá a razão máxima, enquanto branco sobre o mesmo branco dá 1:1. O par verde padrão alcança os cinco limites numéricos, mas seu uso em um componente real ainda precisa de contexto.

Exemplos com cores sRGB opacas
Cor do textoCor de fundoRazão exibidaNormal AA / AAA
#000000#FFFFFF21.00:1Aprovado / Aprovado
#FFFFFF#FFFFFF1.00:1Reprovado / Reprovado
#777777#FFFFFF4.48:1Reprovado / Reprovado
#767676#FFFFFF4.54:1Aprovado / Reprovado
#294C39#FFFFFF9.60:1Aprovado / Aprovado

W3C WCAG 2.2: Critérios, texto grande, luminância relativa e razão de contraste

Transparência: compor o fundo primeiro, depois o texto

Tela atrás da transparência é um seletor HEX opaco. Primeiro a ferramenta compõe Cor de fundo sobre essa tela; depois, Cor do texto sobre o fundo efetivo. Só após essas duas etapas calcula luminância relativa e contraste. O alfa decimal é preservado; os canais compostos fracionários não são arredondados antes desse cálculo.

Para preto com metade da opacidade sobre branco opaco, os canais efetivos do texto são 127.5 e a razão exibida é 3.98:1. Com fundo branco de meia opacidade sobre preto, o fundo efetivo passa a 127.5 e o mesmo texto preto de meia opacidade passa a 63.75, dando 2.62:1. As mudanças vêm da pilha real de superfícies, não do tamanho da fonte.

Transparência: compor o fundo primeiro, depois o texto
Exemplo em camadasRGB efetivo do fundoRGB efetivo do primeiro planoRazão exibida
rgba(0,0,0,0.5) sobre #FFFFFF, tela branca255,255,255127.5,127.5,127.53.98:1
rgba(0,0,0,0.5) sobre rgba(255,255,255,0.5), tela preta127.5,127.5,127.563.75,63.75,63.752.62:1

W3C Compositing and Blending Level 1: Composição alfa simples

Trocar cores e escolher alfa decimal ou HEX

Trocar cores intercambia as entradas brutas de primeiro plano e fundo, mantendo a tela. Para cores opacas, a razão de luminância é simétrica e permanece igual. Com transparência, os papéis das camadas mudam e a razão pode mudar; teste o resultado trocado em vez de presumir a mesma pontuação.

O alfa HEX tem 8 bits. Por exemplo, #0008 se expande para #00000088 com alfa 136/255, diferente do alfa decimal 0.5 de rgba(0,0,0,0.5). Mantenha a representação exigida pela folha de estilo. Uma representação HEX arredondada de alfa ou cor composta não substitui necessariamente a entrada decimal original de forma exata.

W3C CSS Color 4: Nomes, sRGB e alfaW3C Compositing and Blending Level 1: Composição alfa simples

Sintaxe de cores aceita e quantização das entradas

O analisador aceita 148 nomes padrão CSS mais transparent, sem diferenciar maiúsculas e minúsculas; 3, 4, 6 ou 8 dígitos HEX com # inicial opcional; e funções numéricas RGB/RGBA ou HSL/HSLA. Aceita formas com vírgulas e com espaços/barra dentro de sua gramática. Saturação e luminosidade HSL exigem porcentagens, e o matiz pode usar graus, grados, radianos ou voltas.

Os canais RGB e os convertidos de HSL são arredondados a inteiros sRGB de 8 bits antes da composição, enquanto o alfa decimal continua uma fração numérica. Canais ou alfa fora da faixa são rejeitados em vez de seguir todas as regras de limitação CSS. Não são aceitos nomes dependentes do contexto, currentcolor, expressões de propriedades personalizadas, calc(), cores relativas nem funções Lab/Oklab ou de ampla gama. Use valores sRGB realmente aceitos; isto não é um avaliador CSS completo.

Sintaxe de cores aceita e quantização das entradas
FormaExemplo aceitoDistinção útil
Nome de corRebeccaPurplePalavra-chave CSS, não uma descrição traduzida
HEX#294C39Quatro/oito dígitos também codificam alfa de 8 bits
RGBA com vírgulasrgba(0,0,0,0.5)Alfa decimal preservado
RGB com espaços/barrargb(0 0 0 / 50%)Canais numéricos e alfa opcional
HSLhsl(120deg 100% 25%)Saturação/luminosidade em porcentagens; resultado sRGB quantizado

W3C CSS Color 4: Nomes, sRGB e alfa

Verifique fundo real, tipografia e estados de interação

Um par sólido modela as cores informadas. Imagens, gradientes, sobreposições, opacidade de ancestrais, modos de mistura e filtros podem gerar outras superfícies relevantes ou cores renderizadas. Examine a folha de estilo e o contexto visual reais, depois avalie os pares importantes em cada tema e estado. O verificador não busca páginas, não inspeciona seu DOM e não amostra imagens de fundo.

A suavização pode clarear pixels nas bordas dos glifos em relação à cor prevista do texto. A orientação WCAG direciona a avaliação às cores subjacentes de texto e fundo, em vez de usar um pixel suavizado da borda como cor do texto. Ainda assim, examine a legibilidade com a fonte real e deixe uma margem prática acima do limite quando apropriado; a razão não avalia todas as barreiras visuais ou de interação.

W3C Understanding 1.4.3: Contraste (mínimo)W3C WCAG 2.2: Critérios, texto grande, luminância relativa e razão de contraste

Use a linha não textual para as cores adjacentes relevantes

O critério 1.4.11 trata da informação visual necessária para identificar controles, estados e objetos gráficos cobertos em relação às cores adjacentes. Uma linha genérica de 3:1 não escolhe esses pares por você. Em um botão, o contraste do texto do rótulo e a informação visual que identifica o componente ou estado podem exigir comparações diferentes.

O critério prevê exceções dependentes do contexto, incluindo componentes inativos e certas aparências não modificadas do agente de usuário ou apresentações essenciais. Indicadores de foco também exigem avaliação pelos critérios de foco aplicáveis; nonTextAA não é uma avaliação completa de foco. Decida que informação visual é necessária antes de tratar um número isolado como evidência.

W3C Understanding 1.4.11: Contraste não textualW3C Understanding 2.4.13: Aparência do foco

Melhore um par reprovado e teste os usos afetados

Ajuste primeiro plano, fundo ou opacidade de propósito e observe o recálculo. Escurecer o primeiro plano sobre superfície clara, clareá-lo sobre superfície escura ou reduzir transparência indesejada pode ajudar; confira o resultado real em vez de confiar no nome da cor ou só na luminosidade HSL. A ferramenta relata suas edições; não escolhe uma substituição automática.

Depois de escolher um par aprovado, reveja onde cada token é usado. Mudar uma cor de destaque pode melhorar um rótulo e reduzir o contraste em outra superfície. Teste texto de corpo, links e estados relevantes sobre seus fundos reais, mantendo hierarquia e sinais não baseados em cor significativos.

  • Escolha a linha para tamanho/peso reais ou informação gráfica essencial.
  • Verifique cada tema e estado relevantes em vez de só a pré-visualização padrão.
  • Registre os valores e examine-os no componente real antes de uma mudança ampla de paleta.

Copie ou baixe o relatório JSON com precisão completa

Copiar relatório grava JSON na área de transferência quando permissão e navegador permitem. Se falhar, use Baixar relatório, que salva application/json como toolmellow-contrast.json. O relatório preserva entradas brutas de primeiro plano, fundo e tela; razão; cinco limites; RGB efetivos e indicadores; tamanho/negrito/largeText da pré-visualização; e método de cálculo.

Chaves JSON e números são dados técnicos e mantêm a forma legível por máquina em todos os idiomas. O Texto da pré-visualização personalizado não é incluído no objeto exportado. Copie ou baixe novamente após editar: arquivo e área de transferência são retratos daquele momento, e a atualização da página não reescreve um export anterior. O JSON fornece evidência do cálculo do par, não um certificado de conformidade ou histórico automático de auditoria.

Limites, valores inválidos e estado local

Cor do texto e Cor de fundo aceitam no máximo 200 unidades UTF-16; Texto da pré-visualização aceita 300. A tela é um controle nativo de cor opaca, e o tamanho da pré-visualização fica limitado a 10–72 pixels CSS. Sintaxe inválida ou faixas não aceitas geram erro e ocultam relatório e controles de exportação. Corrija a entrada para restaurar o cálculo; as opções de pré-visualização permanecem no estado da página.

O processamento das cores e o cálculo da razão são síncronos nesta página, sem enviar o par ou texto da pré-visualização a um servidor de cálculo. Atualizar ou sair descarta o estado em memória; relatórios baixados e a área de transferência ficam fora dele. O site público continua fazendo solicitações comuns de hospedagem e análise. Cálculo local não significa anonimato nem ausência de registros de infraestrutura.

Incorpore o verificador com seu backlink

Use a seção de integração abaixo do espaço de trabalho para copiar ou baixar o HTML localizado fornecido. Cole-o em uma plataforma que permita iframe e script de dimensionamento, mantendo o backlink visível para a página correspondente do ToolMellow. O link de crédito inclui nofollow e noopener.

Teste a incorporação em tela estreita e a área de transferência nesse contexto. O iframe mantém o mesmo cálculo ao vivo do par, entradas e limites. As mensagens de altura dimensionam o espaço de trabalho; não são uma API para examinar estilos da página hospedeira ou enviar lotes de solicitações de contraste.

Perguntas frequentes

Como verificar o contraste de cores?

Informe Cor do texto e Cor de fundo reais, escolha a tela opaca sob a transparência e leia a razão atualizada automaticamente e a linha correta. Use o contexto do componente real.

Que razões WCAG AA e AAA exigem para texto?

Texto normal é comparado a 4.5:1 para AA e 7:1 para AAA; texto grande a 3:1 para AA e 4.5:1 para AAA. São comparações inclusivas sem arredondamento; avalie separadamente a aplicabilidade do critério.

Por que 4.50:1 exibido pode reprovar?

A exibição tem duas casas decimais, mas a decisão usa a razão completa. Um valor calculado logo abaixo de 4.5 pode aparecer como 4.50 e ainda reprovar AA para texto normal. Examine o número no JSON.

O que conta como texto grande nesta pré-visualização?

O indicador exige pelo menos 24 pixels CSS ou negrito com pelo menos 18.6666666667 pixels CSS. As condições WCAG sobre pontos, tamanhos equivalentes e fontes ainda precisam ser avaliadas na tipografia real.

Texto em negrito aumenta a razão?

Não. Muda o peso da pré-visualização e pode mudar sua classificação normal/grande; o par informado determina a razão. As cinco linhas continuam visíveis.

Como texto transparente afeta o contraste?

Primeiro o fundo é composto sobre a tela opaca selecionada; depois o texto sobre esse fundo efetivo. A razão usa as cores resultantes, mantendo canais compostos fracionários.

Por que Trocar cores altera a razão de um par transparente?

Troca os papéis de primeiro plano/fundo e mantém a tela. A transparência torna importante a ordem de composição. Razões opacas são simétricas; confira resultados transparentes trocados.

#0008 e preto com meia transparência são idênticos?

Não. #0008 tem alfa 136/255; o alfa decimal RGBA 0.5 é exatamente metade. O alfa HEX tem 8 bits e pode diferir de uma entrada decimal.

Posso informar qualquer expressão de cor CSS?

Não. O analisador cobre nomes sRGB, HEX e formas numéricas RGB/HSL. Rejeita expressões contextuais incompatíveis, variáveis, cálculos, cores relativas e funções de espaços mais amplos.

Uma aprovação comprova WCAG na página inteira?

Não. Verifica uma comparação numérica do par informado. Tamanho real, cores adjacentes, estados e outros critérios aplicáveis exigem revisão; não examina URL nem DOM.

Serve para texto sobre gradiente ou imagem?

Calcula um par sólido sem analisar imagem ou gradiente. Identifique à parte os fundos reais e contextos relevantes antes de decidir que comparações demonstram o requisito.

Por que calculadoras de contraste divergem?

Verifique métrica, valores analisados, quantização RGB/HSL, alfa, tela subjacente, composição e arredondamento. A ferramenta usa a razão sRGB das WCAG 2.2, não APCA nem outra métrica.

O JSON inclui minha frase de pré-visualização?

Não. Inclui cores, razão, limites, RGB efetivos/indicadores, tamanho/negrito/largeText e método. Baixar relatório salva toolmellow-contrast.json; exporte novamente após editar.

Posso incorporar o verificador na minha página?

Use seu HTML localizado abaixo do espaço de trabalho, mantenha o backlink ToolMellow visível e teste iframe/script/área de transferência. Continua um espaço de cálculo de pares, não um scanner da página hospedeira ou API de auditoria.

Fontes e leituras adicionais

Coloque em prática.

Guias relacionados