pantoken / plugins/pantoken/colors/src / onColor

Fungsi: onColor() ​

onColor(surface, threshold?): string

Beta

Foreground yang mudah dibaca — hitam atau putih — untuk kandungan yang diletakkan pada surface. Ini ialah bentuk hanya-CSS bagi varian *-on-color InstUI yang berulang (cincin fokus pada butang jenama, teks butang primary-inverse, ikon pada permukaan berwarna): bukannya token inverse tetap, ia memilih kontras dari permukaan itu sendiri, jadi ia kekal betul apabila permukaan berubah.

Ia membaca kecerahan OKLCH permukaan melalui sintaks warna relatif dan menentukannya kepada 0 (hitam) atau 1 (putih) pada threshold menggunakan helah clamp calc(… * infinity) — tiada JS, tiada hex tetap.

Parameter ​

surface ​

string

Warna latar belakang yang menempatkan kandungan (literal, var(--token), atau pembantu bersarang).

threshold? ​

number = 0.62

Kecerahan OKLCH (0–1) di atas mana permukaan dikira sebagai "cerah" (lalai 0.62).

Mengembalikan ​

string

Satu ungkapan oklch(from …) yang menyelesaikan kepada hitam atau putih.

Contoh ​

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