Skip to content

accessibleColorContrast ​

accessibleColorContrast verifica se um par de cores de primeiro plano/fundo atende às diretrizes de contraste WCAG.

AssinaturaaccessibleColorContrast(fg: Color, bg: Color): boolean
tyrus
import { Color, accessibleColorContrast } from "tyrus:os";

const black: Color = { r: 0, g: 0, b: 0 };
const white: Color = { r: 255, g: 255, b: 255 };
print(accessibleColorContrast(black, white)); // true, 21:1

Retorna se fg/bg atingem a proporção de contraste WCAG 2.x de 4.5:1, o limiar AA para texto de tamanho normal. A proporção é calculada a partir da luminância relativa de cada cor ((L1 + 0.05) / (L2 + 0.05), L1 sendo a mais clara das duas), então qual argumento é primeiro plano versus fundo não muda o resultado.

Campos de Color ​

CampoTipoSignificado
ru8O canal vermelho, de 0 a 255.
gu8O canal verde, de 0 a 255.
bu8O canal azul, de 0 a 255.

Só o limiar AA de texto normal

Isto verifica um único limiar fixo (4.5:1). O WCAG define outros limiares para texto grande (3:1) e o nível AAA mais estrito (7:1/4.5:1) que esta função não expõe diretamente, calcule a proporção você mesmo a partir da mesma fórmula de luminância relativa se precisar de um desses.