pantoken / plugins/pantoken/colors/src / overlayColors

函数: overlayColors() ​

overlayColors(base, overlay, percent?): string

Beta

将 overlay（在 percent% 强度下）平铺在一个不透明的 base 上 —— 这是对 ui-color-utils overlayColors 的纯 CSS 替代。该助手通过 source-over 将两个 RGBA 颜色合成为一个不透明的结果；常见情况（在实色表面上覆盖半透明色调）恰好是一个由两个颜色组成的 color-mix()。一般的 RGBA 覆盖 RGBA 的合成无法表示为单一的 CSS 颜色，所以此方法仅适用于不透明底的情况。

参数 ​

base ​

string

不透明的背景颜色。

overlay ​

string

覆盖在其上的颜色。

percent? ​

number = 50

有多少 overlay 能透出，范围 0–100（默认 50）。

返回值 ​

string

一个 color-mix() 表达式。

示例 ​

ts
overlayColors("var(--surface)", "var(--brand)", 12);
// "color-mix(in srgb, var(--brand) 12%, var(--surface))"