结论先行:CSS if() 是第一个原生的「属性级条件分支」函数,它把 style()、media()、supports() 三种条件直接写进一条声明里,按顺序命中第一个为真的分支并返回对应值。该特性目前仍是实验性能力:自 Chrome 137(2025 年 5 月)起可用,截至 2026 年 11 月,Safari 与 Firefox 尚未在稳定版跟进,具体进度以官方为准。生产环境必须保留传统降级写法,把它当作渐进增强,而不是唯一实现。本文讲清语法、两个可复制的实战示例、边界陷阱与降级策略。
为什么 CSS 需要条件分支
从语言演进的角度看,if() 补齐的是「值层面的条件」这块空白。选择器解决「规则是否应用」,媒体查询解决「环境是否匹配」,自定义属性解决「值如何传递」,但「同一个属性在不同条件下取不同值」始终要靠前三者间接拼凑。if() 把这层逻辑显式化之后,样式表第一次可以在单行内完整表达一个属性的决策树,这对代码生成工具与设计系统的自动化尤其友好:工具只需要输出条件与取值,不再需要理解选择器优先级与规则顺序。
过去十几年,「根据条件应用不同样式」这件事在 CSS 里一直没有一等公民的解法。早期我们靠类名开关:状态变了就用 JavaScript 增删 className,样式表里堆满 .is-active、.is-error 之类的覆盖规则,维护起来像打补丁。后来有了自定义属性,可以把状态收敛成变量,但变量本身不会判断,真要分支还是得回到选择器或者预处理器。Sass 的 @if 看似解决了问题,可那是编译期逻辑,构建完成后就固定了,运行时的状态变化它一概不知。
CSS if() 改变的正是这一点:条件在浏览器渲染时求值,自定义属性一变、视口一变、特性支持情况一变,返回值立刻跟着变,全程不需要 JavaScript 介入。它不是要取代选择器——每个选择器本质上也是条件——而是把「多个条件决定同一个属性的取值」这种以前必须拆成多条规则、多个媒体查询块的逻辑,内聚到一行声明里。对大型设计系统来说,这意味着状态逻辑不再散落在文件各处,读一行就能看懂这个属性在所有情况下的表现。
基本语法与三种条件
if() 的形态是一串用分号分隔的「条件: 值」对,浏览器从上到下依次求值,返回第一个为真的分支的值;都不命中时走 else;连 else 都没有则返回空令牌流,相当于这条声明无效。三种条件包装函数各有分工:style() 查询自定义属性的值,media() 内联媒体查询,supports() 做特性检测。概念上它们分别对应样式查询、@media 和 @supports,只是从「匹配一个代码块」变成了「返回一个值」。
一个最小例子:padding: if(style(--theme: dark): 2rem; else: 3rem);。当 --theme 为 dark 时内边距是 2rem,否则 3rem。分支数量不限,但分支一多可读性会迅速下降,建议每个分支独占一行,并始终显式写出 else 兜底,避免「所有条件都不命中导致声明失效」这种隐蔽问题。
实战一:状态驱动的优惠券卡片
H5 活动页里最常见的场景是同一张优惠券卡片要呈现多种状态:可领取、已领取、已过期。传统做法是三个状态类加三套覆盖样式。用 if() 可以把状态收敛到一个自定义属性上,背景、文字色、按钮文案各自内聚判断。下面这段可以直接复制改造:
.coupon {
--status: available;
padding: 16px;
border-radius: 12px;
background: if(
style(--status: available): #f0edff;
style(--status: claimed): #f5f5f7;
style(--status: expired): #fafafa;
else: #f0edff
);
border: 1px solid if(
style(--status: available): #5b47ff;
else: #e5e5ea
);
}
.coupon[data-status='claimed'] { --status: claimed; }
.coupon[data-status='expired'] { --status: expired; }
.coupon .btn {
color: if(style(--status: available): #5b47ff; else: #999);
pointer-events: if(style(--status: available): auto; else: none);
}HTML 侧只需要维护 data-status 属性,样式层自己完成分支。注意 pointer-events 也能参与条件分支,这让「禁用态」不再依赖额外的 disabled 类。配合 attr() 的类型化读取(同样是较新的能力),还可以直接把 data 属性读成自定义属性,进一步减少中间类名,但 attr() 高级用法的支持面更窄,混用时请分别做特性检测。
实战二:内联媒体查询与特性检测
响应式样式以前散落在多个 @media 块里,同一个属性的取值要跳着看。media() 分支把它们收回一行。触屏设备需要更大的点击目标,这是活动页按钮的经典需求:
.action-btn {
min-height: if(media(any-pointer: coarse): 44px; else: 32px);
font-size: if(
media(width >= 1200px): 18px;
media(width >= 768px): 16px;
else: 14px
);
}
.glass-panel {
background: if(
supports(backdrop-filter: blur(10px)): rgb(255 255 255 / 0.6);
else: rgb(255 255 255 / 0.95)
);
backdrop-filter: if(
supports(backdrop-filter: blur(10px)): blur(10px);
else: none
);
}supports() 分支的价值在于「检测与取值写在一起」:支持毛玻璃就用半透明底加模糊,不支持就退回接近不透明的底色,降级逻辑不再需要单独维护一个 @supports 块。分支顺序即优先级,把更具体的条件放前面,宽泛条件放后面,最后永远留 else。
与样式查询、类名方案的关系
有人会问:容器样式查询 @container style() 不是已经能按自定义属性分支了吗?两者定位不同。样式查询匹配的是「容器」的状态,影响的是容器内一整块规则,适合组件级的主题切换;if() 作用在单个属性上,影响的是「这一个元素这一个属性」,粒度更细,也不需要元素恰好处于某个查询容器之内。实际项目里两者经常配合:外层用样式查询切换主题变量,内层用 if() 根据变量决定具体取值。至于传统的状态类方案,它并不会消失——在需要兼容旧浏览器的场景里,状态类仍然是最稳的基线,if() 只是把「新增一种状态」的成本从「改三处样式」降到「加一个分支」。团队落地时建议约定:状态一律先落到自定义属性或 data 属性上,样式层无论是类名方案还是 if() 方案都只读这个单一事实来源,避免两套状态互相打架。
另一个值得了解的配套能力是 revert-rule 关键字:它把属性重置为「当前规则未参与层叠时」的值,常与条件函数搭配,用来在条件不满足时干净地取消一条声明。它比 if() 更年轻,支持面更窄,同样属于以官方为准的演进中能力,了解即可,不建议现在写进生产基线。
边界与陷阱
第一,if() 是运行时求值,但条件种类目前只有三种,不能写任意表达式,也不能比较两个自定义属性的大小;范围比较(如 style(--w > 400px))属于规范演进中的部分,各引擎实现进度不一,以官方文档为准。第二,所有条件都不命中且没有 else 时,返回空令牌流会让整条声明在计算值阶段失效,属性回退到继承值或初始值,而不是「上一条声明」,这一点和手写降级时的直觉不同,务必显式写 else。第三,嵌套 if() 语法上可行,但可读性极差,复杂逻辑建议拆成多个自定义属性分层求值。第四,调试时开发者工具对新函数的展示仍在完善,遇到不生效先用 CSS.supports 检查条件函数本身是否被识别。
兼容现状与降级写法
再次强调:这是实验性特性。Chrome 137 起可用,Safari 与 Firefox 截至 2026 年 11 月尚未在稳定版提供,跟进时间表以官方发布为准。降级策略利用「无法解析的声明被丢弃」这一 CSS 基本行为:先写传统值,再写 if() 值,支持的浏览器后者覆盖前者,不支持的浏览器自动保留前者:
.coupon {
background: #f0edff;
background: if(
style(--status: claimed): #f5f5f7;
style(--status: expired): #fafafa;
else: #f0edff
);
}如果状态分支较多、降级值难以用一条静态声明表达,就保留原来的状态类方案作为基线,用 @supports (background: if(style(--x: 1): red; else: blue)) 包住 if() 增强层。面向大众的 C 端页面建议后者;内部工具、技术演示类项目可以大胆一些。无论哪种,都不要把关键交互(比如按钮是否可点)只寄托在 if() 上。
结合 api工厂:H5 活动页的状态样式
优惠券卡片的状态从哪来?在 api工厂(https://www.it120.cc/)这类开放 SaaS 平台上,优惠券的领取状态、商品库存、活动 Banner 都由现成管理后台维护,前端通过全开放接口或 SDK 拉取。纯 HTML 活动页引入 https://www.apifm.com/apifm.min.js 后,用全局 APIFM 初始化并请求数据,返回统一为 {code, data, msg},code 为 0 即成功;拿到状态后写进 data-status,上面的 if() 样式层自动完成视觉分支,JavaScript 只负责数据,不再负责样式开关。想先验证接口行为,可以在 Playground(https://www.it120.cc/playground.html)里直接调试,再落到页面里。这种「数据归 SDK、状态归属性、分支归 CSS」的分层,正是 if() 最舒服的落地姿势。
落地前的检查清单
把 if() 引入真实项目前,建议过一遍这份清单。其一,确认受众浏览器画像:如果主力用户在 Chrome 137 以上,增强层可以覆盖大多数人;如果 C 端流量里 Safari 占比高,就要接受「相当一部分用户永远走降级分支」的现实,降级分支的视觉必须完整可用,而不是「勉强能看」。其二,每条 if() 声明都显式写 else,并保证 else 的值与降级静态值一致,避免两套兜底互相矛盾。其三,分支超过四个时停下来想想:是不是该把状态下沉为更语义化的变量,比如把「会员等级加活动阶段」的组合先在数据层算成一个 --card-tone,样式层只判断 tone,而不是在 CSS 里做笛卡尔积。其四,把关键可交互性(禁用、隐藏、焦点)保留在 HTML 属性与常规 CSS 上,if() 只负责视觉取值,这样即使函数整体失效,页面功能也不受损。其五,在代码评审规范里写明:if() 属于增强层,必须能被整段删除而不影响基线体验。做到这五条,实验性特性也能安全地上生产。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。