Skip to content

accessibleColorContrast ​

accessibleColorContrast verifica si un par de colores de primer plano/fondo cumple las directrices de contraste WCAG.

FirmaaccessibleColorContrast(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

Devuelve si fg/bg alcanzan la proporción de contraste WCAG 2.x de 4.5:1, el umbral AA para texto de tamaño normal. La proporción se calcula a partir de la luminancia relativa de cada color ((L1 + 0.05) / (L2 + 0.05), siendo L1 el más claro de los dos), así que cuál argumento es primer plano frente a fondo no cambia el resultado.

Campos de Color ​

CampoTipoSignificado
ru8El canal rojo, de 0 a 255.
gu8El canal verde, de 0 a 255.
bu8El canal azul, de 0 a 255.

Solo el umbral AA de texto normal

Esto verifica un único umbral fijo (4.5:1). WCAG define otros umbrales para texto grande (3:1) y el nivel AAA más estricto (7:1/4.5:1) que esta función no expone directamente, calcula la proporción tú mismo con la misma fórmula de luminancia relativa si necesitas uno de esos.