pantoken / plugins/pantoken/colors/src / onColor

Swyddogaeth: onColor() ​

onColor(surface, threshold?): string

Bêta

Y blaen darllenadwy — du neu wyn — ar gyfer cynnwys a osodir ar surface. Dyma ffurf sy'n gweithio gydag CSS yn unig o amrywiadau adlewyrchol *-on-color InstUI (cylch ffocws ar fotwm brand, testun botwm cwbl-ffrâm, eicon ar wyneb lliw): yn hytrach na thocyn gwrthfelin sefydlog, mae'n dewis y gwrthgyferbyniad o'r wyneb ei hun, felly mae'n aros yn gywir wrth i'r wyneb newid.

Mae'n darllen goleuedd OKLCH y wyneb drwy sintacs lliw perthynol ac yn ei gynnig i 0 (du) neu 1 (wyn) yn threshold gan ddefnyddio triciwn clamp calc(… * infinity) — dim JS, dim hex sefydlog.

Paramedrau ​

surface ​

string

Y lliw cefndir y mae cynnwys yn gorwedd arno (llythrennol, var(--token), neu gynorthwyydd mewnol).

threshold? ​

number = 0.62

Goleuedd OKLCH (0–1) uwch na hynny y mae'r wyneb yn cael ei ystyried yn “golau” (diofyn 0.62).

Yn dychwelyd ​

string

Mynegiad oklch(from …) sy'n dadfoddi i du neu wyn.

Enghraifft ​

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)"