大家好，很高兴又见面了，我是"高级前端进阶"，由我带着大家一起关注前端前沿、深入前端底层技术，大家一起进步，也欢迎大家关注、点赞、收藏、转发！

1. 什么是 CSS 自定义属性

CSS 自定义属性 (Custom Properties) 可用于定义复杂的值，从而在样式表中重复使用，例如：监听文档变化、媒体查询等，因此非常灵活且响应迅速。

:root {--color: blue;}
div {--color: green;}
#alert {--color: red;}
* {color: var(--color); }
// 这里的 * 对所有的元素取值

I inherited blue from the root element!
I got green set directly on me!

  While I got red set directly on me!
  I’m red too, because of inheritance!

但是，自定义属性值在定义时是固定的，除非完全覆盖其先前的定义，否则无法更改，例如：--shadow: 2px 2px var(--shadow-color) 从声明它的元素中获取其 --shadow-color 值，并且在后代元素上对 --shadow-color 的更改不会改变 --shadow 值，即继续使用在 --shadow 定义处定义的阴影颜色。因此，对于大量使用此类复合变量的开发者来说，是一个常见的混淆来源。

自定义属性使用的一个典型示例是将字符串与其使用位置分离，以实现国际化。变量声明甚至可以保存在单独的文件中，以使翻译更简单。

:root,
:root:lang(en) {--external-link: "external link";}
:root:lang(el) {--external-link: "εξωτερικ σνδεσμο";}
a[href^="http"]::after {content: "(" var(--external-link) ")"}

而自定义函数 (Custom Functions) 允许开发者使用与自定义属性相同的功能，但采用参数化方式。因此具有与自定义属性相同的灵活性，其在使用时从其他自定义属性（或参数）获取值。

例如：开发者可以下面定义的 --shadow() 函数来代替 --shadow 自定义属性：

@function --shadow(--shadow-color  : inherit) {
  /* If --shadow-color argument isn't passed,
     or doesn't successfully parse as a ,
     try to use the --shadow-color *property*
     from the element instead */
  /* var(--shadow-color) refers to the --shadow-color parameter,
     rather than a custom property,
     but can still use a fallback value as normal */
  result: 2px 2px var(--shadow-color, black);
}

.foo {
  --shadow-color: blue;
  box-shadow: --shadow();
  box-shadow: --shadow(blue);
  // 以上两种方式定义蓝色 shadow
}

需要特别注意的是， CSS 标准不会为自定义属性定义额外的意义或行为，其意义完全取决于开发者如何在项目中使用和定义。

2. 使用自定义函数替换自定义属性

自定义函数可以看作是一种高级自定义属性，其不是用单个固定值替换，而是根据函数参数和调用时自定义属性的值计算其替换值。

自定义函数不是通过自定义属性用于替换值的 var() 语法，而是通过语法调用，允许将其他值作为参数传递。

例如：用于取反值的简单自定义函数可以定义如下：

@function --negative(--value) {
  result: calc(-1 * var(--value));
}

然后，可以在某些声明中使用 --negative() 引用该函数：

html {
  --gap: 1em;
  padding: --negative(var(--gap));
  /* or by passing the value explicitly, like: */
  padding: --negative(1em);
}

支持嵌套任意替换函数，如 var()，其出现在属性值中会导致在解析时默认该属性值有效，并且仅在发生替换后在计算时解析和执行。

个人对自定义函数功能的推出非常期待，因为其将带来更多可能性。

例如：light-dark() CSS 函数可以为属性设置两种颜色，其通过检测用户是否设置了浅色或深色配色或用户是否请求了浅色或深色主题来确定最终颜色。

:root {
  color-scheme: light dark;
  // 为了支持 light-dark() 颜色函数，color-scheme 必须有 light dark 的值
  // 通常设置在: root 伪类上
}
body {
  color: light-dark(#333b3c, #efefec);
  background-color: light-dark(#efedea, #223a2c);
}

但是，该函数的一个限制是其仅适用于值，而借助于自定义函数，开发者可以编写自己的 --light-dark()，从而允许其与任何值一起使用。

@function --light-dark(--light, --dark) {
	result: var(--light);
    //  Preferreds-color-scheme CSS 媒体功能用于检测浅色或深色主题
    // 用户通过操作系统设置或用户代理设置来设置偏好
	@media (prefers-color-scheme: dark) {
		result: var(--dark);
	}
}

此时，如果在暗黑模式下访问网站，则将返回 --dark 值。否则将返回 --light 值。开发者甚至还可以使用 --light-dark() 来获得不同的字体粗细：

:root {
	color-scheme: light dark;
    font-family: "Literata", serif;
	color: light-dark(#333, #e4e4e4);
	background-color: light-dark(aliceblue, #333);
	font-weight: --light-dark(500, 300);
    // 用于设置 font-weight，而不仅仅是颜色
}

需要注意的是，自定义的 --light-dark() 并不是 light-dark() 的准确副本。内置的 light-dark() 可以根据元素使用的 color-scheme 返回不同的值，而 --light-dark() 则依赖于全局的 light/dark 设置。

同时注意，@function 本身并未涵盖响应使用的值的功能，为此还需要 CSS if() 函数，该函数规范也还在考虑中。

3. 浏览器支持情况

Chrome Canary 是 Chrome 的实验性早期版本，专为高级测试和开发而设计。其经常更新新功能和修复程序，因此稳定性不如常规 Chrome 浏览器，主要面向开发者和有兴趣测试新功能的用户。

而 CSS 自定义函数功能 (CSS Custom Functions) 目前正在 Chrome Canary 中进行原型设计，开发者可以在启用 “实验性 Web 平台功能” 标志的 Chrome Canary 中进行测试。

参考资料

https://drafts.csswg.org/css-mixins-1/

https://www.bram.us/2025/02/09/css-custom-functions-teaser/

https://css-tricks.com/dark-mode-and-variable-fonts/

https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme

https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/light-dark

https://app.daily.dev/posts/css-function-css-if--fuv7zixoe

前军教程网

中小站长与DIV+CSS网页布局开发技术人员的首选CSS学习平台

2025 年 CSS 终于要支持强大的自定义函数了?

1. 什么是 CSS 自定义属性

2. 使用自定义函数替换自定义属性

3. 浏览器支持情况

参考资料