RUNTIME THEMING · 演示

一次换肤,要搬动整栈颜色

下面四个是完整主题:背景、表面、正文、次要文字、发丝线、强调色一起换。旁边的色相选择器只是强调色,不是主题,这两件事必须分开实现,也不能混着讲。

命名主题(整栈)

2 个浅色寄存器 + 2 个深色寄存器

判定标准:切换后页面整体观感必须变。如果只有高亮色变了、底色和文字没动,那不是四个主题,是同一个主题的四种强调色。

强调色(只改 accent)

随当前寄存器自动取该色相的浅色或深色变体

applyTheme(name) 只碰 accent 三兄弟,applyMode(dark) 负责整栈翻转。两者各自持久化,互不覆盖。

实时预览

渐变蒙版与 canvas 都跟随当前主题

Editorial 纸本浅色 · 铁红强调
1,284本月新增+18.4%
96.2%可用率
4.1s中位响应
发丝线只做分隔与三级装饰--dim / --line
真实次要文字走 --muted,切换后仍可读--muted

对比度自检

每次换肤后按当前实际计算值重算,不是写死的数字

已检查 4 项
用途前景 / 背景对比度门槛结果

门槛取 WCAG AA:正文 4.5,大字与图形 3.0。发丝线是装饰,只要求 1.3 以上可见。

token 契约

换肤时不允许任何硬编码颜色逃逸

/* 每个主题都要同时给出这七项,缺一项就会在某个寄存器里翻车 */
[data-theme="quiet"]{
  --bg:#F0F0EE;      /* 页面底 */
  --surface:#F7F7F4;   /* 卡片面 */
  --ink:#14171A;       /* 正文,与 --bg 概念互换但同名 */
  --muted:#565B58;     /* 次要文字,两个寄存器都要可读 */
  --dim:#CBCDC7;       /* 只给发丝线,绝不做正文 */
  --line:rgba(20,23,26,.11); /* 由 --ink 推导,不写死 rgba(255,255,255,.07) */
  --accent:#2D5A3D;    --on-accent:#F7F7F4; /* 每个主题单独给,不全局写死 */
}

/* 渐变蒙版必须混到当前 --bg,而不是第一版主题的底 */
.scrim{ background:linear-gradient(180deg,transparent,
        color-mix(in srgb,var(--bg) 92%,transparent)); }