品牌换色,主色从深绿改成砖红。打开样式表一搜,这个色值出现四十多次,散在按钮、链接、边框、图标底、悬停态里,还有几个写在行内样式里。手动替换一遍,漏了两处,上线后页面上出现两种红。这活本来不该花半小时,如果颜色一开始就集中定义,改一行就能完成。
近几年的 CSS 新增了不少东西,值得用的和只是热闹的,分得清更重要。下面挑自定义属性、颜色函数、逻辑伪类、原生嵌套、容器查询、逻辑属性、能力检测来讲,重点不在罗列语法,而在每样东西解决什么问题、到什么规模开始难维护、兼容性怎么判断。读完你应该能把颜色和间距集中管理、做出明暗主题,在组件级别做适配,并对一个新特性能不能上生产有个稳定的判断流程。
自定义属性:先把重复的值收拢
自定义属性以 -- 开头,用 var() 取值。它和 Sass 那种预处理器变量最大的区别是运行时存在:预处理器变量在编译时就被替换成字面量,CSS 变量留在浏览器里,能被继承、能在切主题时动态改、也能被 JavaScript 读写。
:root {
--brand: #2f6f4e;
--text: #24312c;
--surface: #f7f5ef;
--space-2: 8px;
--space-4: 16px;
}
.button {
background: var(--brand);
padding: var(--space-2) var(--space-4);
}
写在 :root 相当于全站可见,写在某个组件上只影响它和它的子树。这个继承是双刃剑:给暗色区块设一套变量,里面的按钮卡片自动换色,不用逐个改选择器;但子元素也会继承祖先的所有变量,重名时后设的覆盖先设的,排查「这个颜色到底从哪来」得顺着继承链往上找。
var() 可以带第二个参数做回退:变量没定义就用回退值;变量有定义、但在当前属性上无效,也会回退。第二种情况最容易踩:变量存的是字符串,浏览器到使用处才校验,--gap: 16 少了单位,gap: var(--gap) 整条声明失效,页面上就是「间距没生效」,定义处却毫无提示。
脚本读写也很直接,取值用 getPropertyValue("--brand"),设值用 style.setProperty("--brand", "#b23a2a")。这个站的主题切换就是给根元素设主题属性,再用 CSS 覆盖变量,而不是准备两套完整样式表。
更进一步的写法是 @property,给自定义属性声明类型和初始值,比如 syntax: "<length>"、inherits: false、initial-value: 0px。注册过的变量会按类型校验,写错单位直接无效,而不是在使用处悄悄让整条声明失效,也能参与过渡。这是较新的能力,支持范围待确认,做设计系统或变量动画时才值得引入。
场景走查:明暗主题切换改了四版
那个文档站要加明暗切换,需求三句话:默认跟随系统;用户手动选过就记住;刷新时不能先白闪一下再变黑。听着简单,我改了四版。
第一版只在 CSS 里写 @media (prefers-color-scheme: dark) 覆盖变量。跟随系统做到了,但按钮没地方下手:用户系统是浅色、自己想用深色,页面不会听;系统切了主题,页面也跟着变,用户没法固定。这只能算「响应系统」,不算「主题切换」。
第二版加主题属性和 localStorage,脚本放在 body 末尾。功能通了,刷新却先亮后暗。原因是首帧已经用默认浅色画完,脚本才执行改属性。把读存储、定主题的几行脚本内联到 head,放在样式表之后、body 之前,让它同步跑完,闪一下基本消失。能不能在所有浏览器上做到零闪烁,我没有把握,彻底的做法是服务端渲染时就把属性输出到 HTML,这一点待确认。
第三版同时保留媒体查询和主题属性两套规则,结果打架:系统是深色、用户手动选了浅色,媒体查询的深色规则仍然命中,把用户的选择盖掉。后来改成 CSS 只认主题属性,head 脚本负责「没有存储值时读系统偏好并写进属性」。媒体查询只出现在脚本里,颜色规则只有一个来源,优先级问题自然消失。
第四版处理观感。一开始给全局加了背景色和文字色的过渡,切换时整页元素一起渐变,低端机上直接掉帧,滚动条和输入框却还是旧配色。改成只给页面底色和少数容器加 120 毫秒过渡,同时在根上声明 color-scheme,让系统控件和滚动条跟着变。这一步不做,深色主题永远像半成品。
最后清残留。深色下有一张卡片仍是白底,因为背景写死 #fff;次要文字用 rgba(0,0,0,.55),压在深色面上几乎看不见。只能全局搜硬编码颜色,逐个换成语义变量。漏掉的地方在浅色下完全正常,只有切到深色才暴露,这是主题功能最花时间的地方,远比写那几行脚本费事。
变量的命名与分层
变量名要按用途起,不按颜色起。叫 --green 的变量,品牌换成砖红之后名字就成了谎话;叫 --brand、--surface、--text-muted,换色时不用改名。
我习惯分两层:底层是色板,比如 --green-600、--red-500,只在一处定义;上层是语义,--brand 指向某个色板值,组件只消费语义层。这样换品牌色只改一行映射,不用碰组件。
但语义层也会膨胀。做到三四十个 token 时,新来的人分不清 --text-soft 和 --text-muted,每加一个样式都要先讨论用哪个。控制在十几到二十个核心 token,其余用局部变量在组件内部算,是更现实的做法。
局部变量作用域小,适合组件内部的临时计算;但别在组件里重定义全局同名的变量,那会把整棵子树带偏,后面的人得查很久才知道颜色为什么不一致。
颜色函数:从十六进制到可计算的颜色
CSS 早就不只支持十六进制和 rgb(),现在常用的几类各有用处:
| 写法 | 特点 | 适用场景 |
|---|---|---|
hsl(150 30% 30%) | 按色相、饱和度、亮度描述,调深浅直观 | 快速做同色系变化 |
oklch(0.55 0.08 150) | 感知均匀,亮度变化接近人眼感受 | 设计系统的均匀色阶 |
color-mix(in srgb, red 40%, blue) | 按比例混合两种颜色 | 悬停色、叠加色 |
rgb(0 0 0 / 40%) | 带透明度的现代写法 | 遮罩、阴影、玻璃效果 |
hsl 的亮度不等于人眼感受到的亮度,同样的 L 值在不同色相上看起来轻重不一。oklch 的感知均匀,做一整套从浅到深的色阶时不会突然跳档,设计系统里更值得用。color-mix 则省掉开设计工具取中间色:按钮悬停想比主色深一点,混一点黑色就行。
.button:hover {
background: #285f43;
background: color-mix(in srgb, var(--brand) 85%, black);
}
「先写旧值、再写新值」是渐进增强的标准顺序,不认识的浏览器丢掉后一条,认识的用后一条;写反了就把回退覆盖掉,等于没兜底。另外,换了颜色一定要重新检查对比度:oklch 的 L 值看着均匀,不代表文字和背景的对比度达标,WCAG 的比值还是得单独算,别凭肉眼判断。
逻辑伪类与原生嵌套
:is()、:where()、:has() 解决的是「一组选择器共用样式」和「根据后代状态反选祖先」两类需求。前两个的差别在优先级::is() 取参数里最高的那个,:where() 恒为 0,所以重置样式用 :where() 最方便,后面随便写一条就能覆盖。
:where(h1, h2, h3) { margin-top: 1.5em; }
.form-row:has(input:invalid) {
border-color: #b23a2a;
}
:has() 让 CSS 第一次能根据后代选祖先,以前这种需求只能靠脚本加类名。它适合表单错误状态、卡片里有图片时调整布局。但它有实打实的样式计算成本,匹配范围写得越宽越明显,支持也属于较新的一档,具体范围待确认。用在小组件里稳妥,别拿它当全站布局的核心逻辑。
原生嵌套减少父选择器重复:.card 里直接写标题、价格、悬停态,不用把父选择器抄三遍。规则和 Sass 不完全一样,嵌套里的选择器默认相对父级,涉及元素选择器时加 & 更明确;层级套深了最终选择器变长、优先级变高,覆盖起来更费劲。一层两层可以,五层就该拆组件。
容器查询:按组件有多宽来适配
媒体查询看的是整个视口。同一个卡片,可能出现在宽的主栏,也可能出现在窄的侧栏;视口很宽时侧栏里的卡片仍然很窄,媒体查询却认为「屏幕够宽,用大布局」,卡片就被挤坏。
.card-wrap {
container-type: inline-size;
container-name: card;
}
@container card (min-width: 420px) {
.card { display: grid; grid-template-columns: 120px 1fr; }
}
用法分两步:先给父元素声明 container-type,让它成为查询容器;再用 @container 写条件。命名可选,多个容器时建议命名,避免在嵌套容器里搞不清在查谁。
容器查询还配有一套长度单位,cqi 表示容器行内尺寸的百分之一。用它做组件内的字号或间距,会随容器宽窄连续变化;但它和 vw 一样有放大文字的隐患,字号为主时还是 rem 更稳。
代价是 inline-size 这一档会给容器加上行内方向的尺寸约束,容器不再被内容撑开,某些依赖内容决定宽度的布局会变样。加在专门的包裹层上,比直接加在业务容器上安全。另外,老浏览器不认 @container,里面的规则整块被忽略,所以默认样式必须写成「没有容器查询也能用」的窄布局,查询只做增强;顺序写反,不支持的环境会看到一坨没排版的卡片。
逻辑属性与自适应尺寸
逻辑属性用「开始、结束、块、行内」代替上下左右,跟随书写方向。margin-inline-start 对应从左到右语言里的左边,换成从右到左的语言会自动变成右边。做国际化时这个能力很有价值。
只做中文站点的话,收益主要是语义清晰,不必强行全改。半改的项目反而难读:同一份样式里 margin-left 和 margin-inline-start 混着,读的人要在脑子里换算。要改就按文件改完,别留一半。
clamp() 让间距连续变化,能减少断点;aspect-ratio 固定宽高比,配 object-fit 管图片,是日常最实用的两个尺寸工具。间距的变化幅度要克制,同一屏里几个间距按各自比例缩放,布局会显得飘,关键结构还是用固定值或断点控制更稳。
新特性能不能用:看目标环境
判断顺序固定:先看项目的目标浏览器范围,是只支持现代浏览器,还是要兼容几年前的版本;再查该特性在范围内的支持情况;最后决定直接用、加回退,还是暂缓。热度高不等于能直接用,博客示例通常假设最新浏览器。
@supports (display: grid) {
.layout { display: grid; }
}
@supports not (color: oklch(0.5 0.1 150)) {
.tag { background: #2f6f4e; }
}
@supports 在 CSS 里做能力检测,适合「增强」类需求:支持就用更好的写法,不支持也不影响可用。如果是「不支持整块布局就废」的核心能力,还是老实写兼容方案,或者调整设计。这个取舍没有统一答案,取决于用户构成和产品要求。
还有个常见误解:以为构建工具会把所有新语法降级。Autoprefixer 只加前缀,容器查询、oklch、原生嵌套这些语义级能力,PostCSS 插件也只能做部分转换,转不干净的部分还是得自己写回退。上线前在目标浏览器里真跑一遍,比看兼容表可靠。
错误现象对照
这些现象在引入变量和主题功能后特别常见,排查顺序基本固定。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 主题切换后颜色没变 | 属性设在了错误的元素上,或组件内同名变量覆盖了根上的值 | 看属性挂在哪个元素,再看该元素上变量的解析值和继承来源 |
| 变量写了,间距却没生效 | 变量值缺单位,使用处整条声明失效 | Computed 面板看该属性是否被划掉,检查变量字符串有没有 px 或 rem |
| 刷新时先白一下再变深色 | 主题脚本在 body 末尾,首帧已经用默认主题画完 | 查脚本位置是否在 head 且同步执行 |
| 卡片在侧栏被挤坏,媒体查询却按大屏处理 | 媒体查询看视口,不看卡片所在容器 | 量组件父容器的实际宽度,再考虑要不要上容器查询 |
| 加了 container-type 后内容溢出或高度塌了 | 行内尺寸约束改变了元素的尺寸计算 | 查容器是否靠内容撑宽,换成外层包裹再试 |
| 悬停色在部分浏览器里整条失效 | 用了 color-mix 但没有旧值兜底 | 看声明是否被丢弃,补一条具体色写在前面 |
边界与代价
变量不是越多越好。token 一旦膨胀到几十个,命名和约定本身的成本就超过它省下的重复;跨团队时还会出现「同一种灰有两个名字」。一般项目十几个核心 token 足够,剩下的在组件内部用局部变量解决。
主题切换的成本也不只在 CSS。图片、第三方组件、图表配色、代码高亮、嵌入内容都要各自处理一遍;深色下白底 logo 像一块贴纸,要么准备两套图,要么用滤镜凑,两种都有维护代价。对比度还要重新审查,尤其是浅色文字压在主色按钮上。
容器查询不能替代媒体查询。页面级的栏数、横竖屏、打印样式仍然要看视口;容器查询解决的是组件在局部空间里的自适应。两者混用时要清楚自己在问「窗口多宽」还是「这个盒子多宽」。
颜色函数也有协作成本。oklch 的数值设计师不熟,交接时说不清「这个 0.55 到底有多亮」,需要额外维护色板文档。逻辑属性和原生嵌套同理,迁移一半比不迁移更难读。老项目和邮件模板对变量、嵌套的支持有限,跨端复用的样式要单独确认。
如果优先级已经乱到靠 !important 打架,与其继续加选择器权重,不如考虑 @layer:把重置、基础组件、业务样式分层,层与层的顺序由声明决定,业务样式天然能覆盖组件默认值。但它同样有兼容门槛,不支持的浏览器会把整块分层声明丢掉,关键样式上线前要确认目标环境,或者只在不影响可用的增强部分使用。
最后是调试难度。变量让最终值多了一层间接,DevTools 里看到的是解析后的颜色,改一处变量影响哪些组件要靠经验判断。项目里最好保留一份「谁在消费这个 token」的说明,或者至少命名足够清楚。
小结、练习与下一步
最值得现在就用的是自定义属性:颜色、间距、圆角集中管理,主题切换和品牌换色会轻松很多。颜色函数、容器查询、:has()、原生嵌套属于「好用但要确认兼容」的一档,用的时候配好回退。逻辑属性在中文项目里不是必需,但能帮你读懂别人的代码。
当天可以自己验证的几件事:
- 挑一个组件,把写死的色值全部换成语义变量,再改一次变量值,确认只改一处就能生效。
- 做一个最小主题切换,把脚本分别放在 head 和 body 末尾,对比刷新时是否闪白。
- 用
color-mix生成悬停色,在 DevTools 里禁用后一条声明,模拟不支持的浏览器看回退。 - 给一个卡片容器加
container-type,把它分别放进宽主栏和窄侧栏,观察同一组件的变化。 - 用
@supports包住一段oklch写法,检查不支持时页面是否仍然可用。
这一组到这篇结束。回看这几篇,主线其实是一条:先搞清楚浏览器怎么选规则,再搞清楚盒子怎么占空间,然后怎么排、怎么动,最后是怎么组织。主题切换里的脚本和状态管理已经碰到 JavaScript,下一篇可以从事件与交互接着读,那里讲监听、冒泡和性能,正好补上切换按钮背后的部分。
如果主题切换的过渡让你觉得眼熟,可以回看过渡与动画里的减少动效,主题切换和动效都要尊重系统偏好。变量和层叠的优先级关系,则可以在层叠与优先级里补齐。