Cores OKLCH
OKLCH é um espaço de cor perceptualmente uniforme onde luminosidade, croma e matiz são controles de design úteis. Use-o quando o projeto já utiliza OKLCH, ao criar um novo sistema de cores, ou quando o usuário solicitar conversão ou trabalho com paletas. Caso contrário, preserve os tokens e a notação estabelecidos do projeto: um sistema consistente de tokens hex ou RGB é melhor do que introduzir uma segunda representação de cor para uma correção isolada. Para explorar interativamente, visite oklch.fyi.
Referência Rápida
| Categoria | Quando usar | Referência |
|---|---|---|
| Conversão | Hex/rgb/hsl para oklch | color-conversion.md |
| Paletas | Gerar escalas, multi-matiz, modo escuro | palette-generation.md |
| Contraste | Verificações APCA/WCAG, relatar falhas, corrigir quando solicitado | accessibility-contrast.md |
| Gama e Tailwind | Fallbacks P3, escalas @theme, limitação de gama | gamut-and-tailwind.md |
| Uso | Tokens semânticos, um significado por cor, ênfase em ação primária, variantes de aparência | color-usage.md |
Princípios Fundamentais
1. Use um Espaço de Cor Perceptual
- Respeite o sistema existente. Não converta notação apenas porque esta skill foi carregada. Reutilize os tokens semânticos e o formato de autoria do projeto, a menos que a tarefa inclua uma migração de sistema de cores.
- Uniformidade perceptual. Passos iguais em L = brilho igual.
oklch(0.5 ...)é visualmente médio. Alightness: 50%do HSL varia drasticamente conforme o matiz. - Matiz estável. O azul do HSL tende ao roxo conforme a luminosidade muda. O matiz do OKLCH permanece constante em toda a faixa de luminosidade.
- Croma independente. Croma é uma medida absoluta de colorido que não depende da luminosidade. A saturação do HSL depende.
- Gama finito. Nem todo valor oklch mapeia para uma cor sRGB exibível. Valores de croma alto em certos matizes serão cortados; é necessário ter consciência de gama.
2. Escreva e Formate OKLCH de Forma Consistente
oklch(L C H)
oklch(L C H / alpha)
| Canal | Faixa | Descrição |
|---|---|---|
| L (Luminosidade) | 0–1 | 0 = preto, 1 = branco. Perceptualmente uniforme. |
| C (Croma) | 0–~0.4 | Colorido. 0 = cinza. Máximo depende de L e H. |
| H (Matiz) | 0–360 | Ângulo do matiz em graus. |
| alpha | 0–1 | Transparência opcional. Sintaxe com barra. |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
Use três casas decimais para L e C e até três para H. Elimine zeros à direita e formate -0 como 0. OKLCH é Baseline 2023; quando os requisitos de suporte forem excepcionalmente amplos, verifique a matriz de navegadores do projeto alvo em vez de confiar em uma porcentagem fixa de cobertura global.
3. Meça Contraste, Gama e Comportamento de Paleta
| Regra | Valor |
|---|---|
| Limite claro/escuro | L > 0.73 = fundo claro → texto escuro; abaixo disso, texto claro ainda pontua mais |
| Diferença de luminosidade (fundo claro) | L do primeiro plano < 0.35 quando L do fundo > 0.9 |
| Diferença de luminosidade (fundo escuro) | L do primeiro plano > 0.9 quando L do fundo < 0.25 |
| Limite de drift de matiz | > 10° de dispersão entre os passos da paleta = drift visível |
| APCA texto corpo | |Lc| >= 75 mínimo, >= 90 preferido |
| APCA texto não corpo | |Lc| >= 60 mínimo |
| WCAG 2 texto normal | 4.5:1 AA, 7:1 AAA |
| Correção de contraste (apenas quando solicitado) | Ajuste L primeiro; preserve C e H quando possível, meça novamente o par renderizado |
Erros Comuns
| Problema | Correção |
|---|---|
| Cor bruta ignora o sistema de tokens semânticos do projeto | Reutilize ou adicione o token de função correto na notação existente do projeto |
| Valor OKLCH isolado introduzido em uma base de código hex/RGB | Preserve a notação estabelecida, a menos que a tarefa inclua uma migração de sistema de cores |
| Rampa de paleta HSL com drift de matiz | Reconstrua com matiz oklch constante |
| Contraste insuficiente (verifique o primeiro plano contra seu fundo usando APCA) | Relate o par, seu Lc medido e o limite que ele não atinge; altere cores apenas quando solicitado (então ajuste L, mantenha C e H) |
| Croma alto sem verificação de gama | Limite ao croma máximo para o L/H em sRGB |
| Mesmo C absoluto em matizes diferentes | Use a mesma % de C (percentual do máximo) para vividez consistente |
| Cor P3 sem fallback sRGB | Adicione o padrão @media (color-gamut: p3) |
| Modo escuro criado invertendo mecanicamente a paleta clara | Use a paleta clara como ponto de partida, depois ajuste croma e luminosidade e verifique novamente cada par primeiro plano/fundo |
Hex no @theme do Tailwind v4 | Converta para valores oklch |
| Alfa com sintaxe de vírgula | Use barra: oklch(L C H / alpha) |
| Mesmo matiz significa duas coisas diferentes (cor de link reutilizada decorativamente) | Uma cor, um significado; dê ao segundo uso um neutro |
| Token semântico usado fora de sua função (separador como texto) | Adicione um token para a função ausente; nunca pegue emprestado por valor |
| Vários fundos de controle coloridos em uma visualização | Preencha apenas a única ação primária; secundários permanecem neutros |
| Paleta verificada apenas no modo claro | Verifique novamente cada par primeiro plano/fundo em ambas as aparências |
Formato de Saída de Revisão
Use este formato apenas quando o usuário solicitar uma revisão de cor independente. Quando better-interface orquestrar a revisão, forneça evidências de domínio e descobertas para essa skill e deixe seu formato de saída, escala de gravidade, regras de consolidação, limite e veredito terem precedência.
Apresente a revisão independente em duas partes.
Descobertas
Agrupe todas as descobertas confirmadas por princípio. Use uma tabela markdown com as colunas Gravidade, Localização, Antes, Depois e Porquê. Nunca use linhas separadas "Antes:" / "Depois:".
- Gravidade:
ALTAtorna o conteúdo ilegível ou atribui uma cor semântica enganosa;MÉDIAcria uma falha perceptível de tema, gama ou consistência;BAIXAé um polimento isolado. - Localização: cite
caminho/para/arquivo:linha. Se o artefato não tiver arquivos fonte, cite a tela e o componente exatos. - Antes / Depois: mostre o valor ou token atual e a substituição exata.
- Porquê: nomeie o princípio violado e inclua evidências de contraste ou gama medidas quando relevante.
Consolide um problema sistêmico repetido em uma linha e liste cada localização afetada. Omita princípios sem descobertas.
| Gravidade | Localização | Antes | Depois | Porquê |
|---|---|---|---|---|
| MÉDIA | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | Novas cores do projeto usam tokens OKLCH |
| MÉDIA | src/palette.ts:31 | Mesmo C absoluto entre matizes | Mesma % de C do croma máximo de cada matiz | Valores de croma iguais não parecem igualmente vívidos entre matizes |
| ALTA | src/theme.css:52 | Cor P3 sem fallback | Adicione um fallback sRGB antes de @media (color-gamut: p3) | A cor falha em monitores não P3 |
Verificação e Veredito
Após as descobertas:
- Verificação: liste as verificações exatas realizadas e seus resultados observados, incluindo medições de contraste, verificações de gama e ambas as aparências clara e escura quando aplicável. Se uma verificação não foi realizada, declare o que ainda precisa ser verificado.
- Veredito:
Bloqueiose alguma descobertaALTApermanecer,Necessita alteraçõesse apenas descobertasMÉDIAouBAIXApermanecerem, eAprovarapenas quando nenhuma descoberta acionável permanecer.
Quando não houver descobertas, omita a tabela, declare "Nenhuma descoberta de cor acionável", relate a verificação e termine com Aprovar.