pantoken / plugins/pantoken/colors/src / onColor

Fonksyon: onColor() ​

onColor(surface, threshold?): string

Beta

Tekst devan ki lizib — nwa oswa blan — pou kontni mete sou surface. Sa a se fòm CSS-sèl nan varyant *-on-color InstUI ki repete yo (yon bag fokus sou yon bouton mak, tèks yon bouton primary-inverse, yon ikon sou yon sifas koulè): olye de yon token inverse fiks, li chwazi kontrast la depi nan sifas la menm, konsa li rete kòrèk lè sifas la chanje.

Li li klète OKLCH sifas la atravè sentaks koulè relatif epi li kole li sou 0 (nwa) oswa 1 (blan) nan threshold lè l sèvi avèk astis calc(… * infinity) clamp — pa gen JS, pa gen hex fiks.

Paramèt ​

surface ​

string

Kontni koulè background la chita sou (literal, var(--token), oswa yon èd nwaye).

threshold? ​

number = 0.62

Klète OKLCH (0–1) anwo ki fè sifas la konte kòm "limyè" (pa defo 0.62).

Retounen ​

string

Yon ekspresyon oklch(from …) ki rezoud kòm nwa oswa blan.

Egzanp ​

ts
onColor("var(--instui-color-background-brand)"); // white on a dark brand surface, black on a light one
// → "oklch(from var(--…-brand) clamp(0, (0.62 - l) * infinity, 1) 0 0)"