• 原文地址：It’s Time To Start Using CSS Custom Properties
• 作者：Serg Hospodarets
• 翻译：shen

浏览器支持

在今天，css预加载已经成为了前端开发的一个标准。预加载的一个主要优势就是可以让你使用变量。它可以让你避免复制黏贴你的代码，并且简化了开发和重构。

我们用预加载来存储颜色、字体偏好，布局的细节——几乎是我们在css里面用到的所有东西。

但是预加载的变量有一些使用上的限制。

• 你不能动态的改变他们。
• 他们不能认出DOM结构
• 他们不能用JavaScript读取和改变。

为了解决这样或那样的问题，社区发明了CSS自定义属性。本质上这看上去和实现起来就像CSS变量。并且他们的实现方式就像他们的名字一样。

自定义属性为前端开发打开了新的大门。

深入阅读

• A Detailed Introduction To Custom Elements
• Houdini: Maybe The Most Exciting Development In CSS You’ve Never Heard Of
• Turn Your AMP Up To 11: Everything You Need To Know About Google’s Accelerated Mobile Pages
• A Better iOS Architecture: A Deep Look At The Model-View-Controller Pattern

申明和使用自定义属性的语法

在你开始学习心得预处理器或者框架的使用通常的问题是你必须学习新的语法。

每一种预处理器都使用不同的方法申明变量。通常使用一个保留字符作为开始——举个例子，Sass的$、LESS的@。

CSS自定义属性同样也是用保留字符 --来引入声明。但是好处是你只需要学一遍语法就能在所有浏览器上使用。

你可能会问，“为什么不使用已经有的语法？”

这是有原因的。简单来说这提供了一种在任何预处理器中使用自定义属性的方式。在这种方式下我们可以使用自定义属性，预处理器也不会编译他们，所以这些属性会直接输出到编译后的CSS中。并且你也可以重复使用预处理器变量在源文件中，这个我稍后会细说。

（关于这个名字：因为他们的想法和目标非常相似，有些时候自定义属性被叫做CSS变量，尽管正确名称叫CSS自定义属性，往下读你就会明白为什么这个名字是最正确的。）

所以要声明一个变量来代替常用的CSS属性，就像color或者padding，用--连接一个自定义名称属性就可以：

.box{
  --box-color: #4d4e53;
  --box-padding: 0 10px;
}

属性的值可以是任何有效的CSS值：颜色、字符串、布局甚至是表达式。

这里是有效的自定义属性的例子：

:root{
  --main-color: #4d4e53;
  --main-bg: rgb(255, 255, 255);
  --logo-border-color: rebeccapurple;

  --header-height: 68px;
  --content-padding: 10px 20px;

  --base-line-height: 1.428571429;
  --transition-duration: .35s;
  --external-link: "external link";
  --margin-top: calc(2vh + 20px);

  /* Valid CSS custom properties can be reused later in, say, JavaScript. */
  --foo: if(x > 5) this.width = 10;
}

以防万一你不知道什么是:root匹配，在HTML里他就等同与html标签，但是具有更高的特异性。

自定义属性和其他的CSS属性一样是动态的、级联的。这意味着他们能在任何时候被改变是由浏览器来进行的。

为了使用自定义的变量，你需要使用var()CSS函数，并且提供属性参数。

.box{
  --box-color:#4d4e53;
  --box-padding: 0 10px;

  padding: var(--box-padding);
}

.box div{
  color: var(--box-color);
}

声明和用例

var()函数有一个非常便利的提供默认值的方法。如果你不确信自定义属性已经被定义并且需要一个默认值，函数的第二个参数用来作为默认值的。

.box{
  --box-color:#4d4e53;
  --box-padding: 0 10px;

  /* 10px is used because --box-margin is not defined. */
  margin: var(--box-margin, 10px);
}

你可能会希望在声明新的变量的时候能重复使用已有的变量值：

.box{
  /* The --main-padding variable is used if --box-padding is not defined. */
  padding: var(--box-padding, var(--main-padding));

  --box-text: 'This is my box';

  /* Equal to --box-highlight-text:'This is my box with highlight'; */
  --box-highlight-text: var(--box-text)' with highlight';
}

运算：+，-，*，/

既然我们习惯使用预处理器和其他语言，我们也希望在处理变量的时候能使用基本运算。为了达到这个目的，CSS提供了calc()函数，作用当自定义属性的值被改变的时候浏览器会重新计算表达式：

:root{
  --indent-size: 10px;

  --indent-xl: calc(2*var(--indent-size));
  --indent-l: calc(var(--indent-size) + 2px);
  --indent-s: calc(var(--indent-size) - 2px);
  --indent-xs: calc(var(--indent-size)/2);
}

特别是当你想用一个没有单位的值得时候，就需要使用calc()函数

:root{
  --gap: 10;
}

.box{
  padding: var(--spacer)px 0; /* DOESN'T work */
  padding: calc(var(--spacer)*1px) 0; /* WORKS */
}

作用域和继承

在讨论CSS自定义属性的作用域之前，我们先来回顾一下JavaScript和预处理器的作用域。这样就能更好的认识他们之间的区别。

我们知道在JavaScript中如果在函数中使用var关键字声明变量，那么他的作用域就在函数里面。

同样的我们可以使用let和const关键字，但他们的作用域相对于变量的块作用域(We have a similar situation with let and const, but they are block-scope local variables.)

在JavaScript中闭包(closure)是一个可以访问外部函数变量的函数——作用域链。闭包有三个作用域链：

• 它自己的作用域（即 变量定义在大括号中）
• 外部函数的变量
• 全局变量

预处理器也是相同的，让我们用Sass来举个例子。因为这大概是今天最流行的预处理器了。

在Sass中有两种类型的变量：当前作用域变量(local) 和 全局变量。

一个全局变量能被申明在选择器和构造器（比如mixin）外，其他的变量就是当前作用域变量

这意味着在Sass中变量的作用域完全依赖代码的嵌套结构。

然而CSS自定义属性完全和其他的CSS属性一样使用级联方式默认继承。

当然你也不能在CSS中定义一个在选择器外的属于全局的自定义属性变量，因为这不是有效的CSS。自定义属性的全局作用域实际上就是:root的作用域，这里面定义的属性就是全局的。

让我们用已知的语法知识和Sass的例子来创建一个使用原生的CSS自定义属性的例子，首先是HTML：

global
<div class="enclosing">
  enclosing
  <div class="closure">
    closure
  </div>
</div>

CSS:

:root {
  --globalVar: 10px;
}

.enclosing {
  --enclosingVar: 20px;
}

.enclosing .closure {
  --closureVar: 30px;

  font-size: calc(var(--closureVar) + var(--enclosingVar) + var(--globalVar));
  /* 60px for now */
}

到目前为止我们还没有看出他和Sass变量有什么区别。然而让我们重新给变量赋值：

在Sass中，是无效的。

.closure {
  $closureVar: 30px; // local variable
  font-size: $closureVar +$enclosingVar+ $globalVar;
  // 60px, $closureVar: 30px is used

  $closureVar: 50px; // local variable
}

但是在CSS中计算的值改变了。因为font-size的值因为--closureVar值得改变重新计算了。

.enclosing .closure {
  --closureVar: 30px;

  font-size: calc(var(--closureVar) + var(--enclosingVar) + var(--globalVar));
  /* 80px for now, --closureVar: 50px is used */

  --closureVar: 50px;
}

这是第一个非常大的区别：如果你对自定义属性重新赋值，浏览器会重新计算所有的变量和calc()表达式。【会不会有性能问题？】

预处理器不能识别DOM结构

假如我们想在除了class是highlighted的div上使用默认的font-size

HTML:

<div class="default">
  default
</div>

<div class="default highlighted">
  default highlighted
</div>

CSS:

.highlighted {
  --highlighted-size: 30px;
}

.default {
  --default-size: 10px;

  /* Use default-size, except when highlighted-size is provided. */
  font-size: var(--highlighted-size, var(--default-size));
}

因为第二个div元素使用了highlighted类，在highlighted类上的属性就提供给这个元素了。

在这里就意味着，--hightlighted-size: 30px被提供了。是的font-size的属性被重新赋值了。

一切都是这么直截了当的运行

接下来让我们尝试使用Sass来实现同样的例子

.highlighted {
  $highlighted-size: 30px;
}

.default {
  $default-size: 10px;

  /* Use default-size, except when highlighted-size is provided. */
  @if variable-exists(highlighted-size) {
    font-size: $highlighted-size;
  }
  @else {
    font-size: $default-size;
  }
}

结果显示他们都使用默认字体大小

这是因为所有的Sass的计算和进程都发生在编译过程中，所以理所当然的他不知道DOM结构，所以依赖代码结构。

如你所见自定义属性在变量作用域和通常的css级联样式上具有优势。并且能够识别DOM结构。和普通的CSS属性使用相同的语法规则。

第二个例外是CSS自定义属性能动态的识别DOM结构

CSS关键字和all属性

CSS自定义属性遵守与常规CSS自定义属性相同的规则。这意味着您可以为其分配任何常见的CSS关键字：

• inherit

  此CSS关键字应用元素的父对象的值。

• initial

  这将应用CSS规范中定义的初始值（空值，或在某些CSS自定义属性的情况下）。

• unset

  在自定义属性中，如果属性是继承的，则应用继承的值，如果属性是初始化的值，则引用初始化值

• revert

  这会将该属性重置为用户代理样式表建立的默认值（在CSS自定义属性的情况下为空值）。

.common-values{
  --border: inherit;
  --bgcolor: initial;
  --padding: unset;
  --animation: revert;
}

我们来看另外一个例子。假设你想构建一个组件，并且想要确保没有其他样式或自定义属性被无意中应用（在这种情况下，通常会使用模块化的CSS解决方案）。

现在还有另一种方法：使用allCSS属性。这个简写将重置所有CSS属性。

与CSS关键字一起，我们可以执行以下操作:

.my-wonderful-clean-component{
  all: initial;
}

这会为我们的组件重置所有的样式

不幸的是，all关键字不会重置自定义属性。关于是否添加 - 前缀，这将重置所有CSS自定义属性，正在进行讨论。

所以在将来，一个完整的重置会是这样的：

.my-wonderful-clean-component{
  --: initial; /* reset all CSS custom properties */
  all: initial; /* reset all other CSS styles */
}

CSS自定义属性用例

有许多自定义属性使用的方式，在这里我会展示他们中最有趣的部分。

模拟不存在的CSS规则

这些CSS变量的名称是自定义属性，那为什么我们不能用它来模拟不存在的CSS属性？

有很多比如translateX/Y/Z,background-repeat-x/y(仍然不能跨浏览器兼容)，box-shadow-color

让我们试着模拟最后一个属性。在这个例子里当hover的时候我们改变box-shadow的颜色。我们只想遵循DRY规则（不要重复你自己），所以我们只是改变它的颜色，而不是在：hover部分重复box-shadow的整个值。（变量的改变会重新计算var()和calc()）

.test {
  --box-shadow-color: yellow;
  box-shadow: 0 0 30px var(--box-shadow-color);
}

.test:hover {
  --box-shadow-color: orange;
  /* Instead of: box-shadow: 0 0 30px orange; */
}

颜色主题

自定义属性有一个最常用的用例就是应用程序中的颜色主题。自定义属性就是用来解决这类问题的。所以，让我们为一个组件提供一个简单的颜色主题（应用程序可以遵循相同的步骤）。

这是button组件的代码

.btn {
  background-image: linear-gradient(to bottom, #3498db, #2980b9);
  text-shadow: 1px 1px 3px #777;
  box-shadow: 0px 1px 3px #777;
  border-radius: 28px;
  color: #ffffff;
  padding: 10px 20px 10px 20px;
}

我们假设要反转颜色主题。

第一步是将所有颜色变量扩展到CSS自定义属性并重写我们的组件。重写后的代码

.btn {
  --shadow-color: #777;
  --gradient-from-color: #3498db;
  --gradient-to-color: #2980b9;
  --color: #ffffff;

  background-image: linear-gradient(
    to bottom,
    var(--gradient-from-color),
    var(--gradient-to-color)
  );
  text-shadow: 1px 1px 3px var(--shadow-color);
  box-shadow: 0px 1px 3px var(--shadow-color);
  border-radius: 28px;
  color: var(--color);
  padding: 10px 20px 10px 20px;
}

这有我们需要的一切。使用它，我们可以将颜色变量重写为反转值，并在需要时应用它们。例如，我们可以添加全局inverted类（例如，body元素），并在应用颜色时更改颜色：

body.inverted .btn{
  --shadow-color: #888888;
  --gradient-from-color: #CB6724;
  --gradient-to-color: #D67F46;
  --color: #000000;
}

以下是一个演示，您可以在其中单击一个按钮来添加和删除全局类：demo

如果不重复代码，在CSS预处理器中无法实现此行为。使用预处理器，您将始终需要覆盖实际的值和规则，这往往会导致额外的CSS。

使用CSS自定义属性，解决方案可以尽可能的干净，复制黏贴是可以避免的。因为只需要对变量进行重新赋值。

在JavaScript中使用自定义属性

以前，要将数据从CSS发送到JavaScript，我们经常不得不采取技巧，通过CSS输出中的纯JSON编写CSS值，然后从JavaScript读取它.

现在，我们可以轻松地使用JavaScript中的CSS变量进行交互，使用众所周知的.getPropertyValue()和.setProperty()方法读取和写入它们，这些方法用于通常的CSS属性:

/**
* Gives a CSS custom property value applied at the element
* element {Element}
* varName {String} without '--'
*
* For example:
* readCssVar(document.querySelector('.box'), 'color');
*/
function readCssVar(element, varName){
  const elementStyles = window.getComputedStyle(element);
  return elementStyles.getPropertyValue(`--${varName}`).trim();
}

/**
* Writes a CSS custom property value at the element
* element {Element}
* varName {String} without '--'
*
* For example:
* readCssVar(document.querySelector('.box'), 'color', 'white');
*/
function writeCssVar(element, varName, value){
  return element.style.setProperty(`--${varName}`, value);
}

假设我们有一系列的媒体查询值

.breakpoints-data {
  --phone: 480px;
  --tablet: 800px;
}

因为我们只想在JavaScript中重用它们 - 例如，在Window.matchMedia()中，我们可以轻松地从CSS中获取它们

const breakpointsData = document.querySelector('.breakpoints-data');

// GET
const phoneBreakpoint = window.getComputedStyle(breakpointsData)
  .getPropertyValue('--phone');

为了展示如何从JavaScript分配自定义属性，我创建了一个交互式3D CSS 立方体demo，以响应用户操作。

这不是很难我们只需要添加一个简单的背景，然后放置五个立方体面与transform属性的相关值：translateZ（），translateY（），rotateX（）和rotateY（）。

#world{
  --translateZ:0;
  --rotateX:65;
  --rotateY:0;

  transform-style:preserve-3d;
  transform:
    translateZ(calc(var(--translateZ) * 1px))
    rotateX(calc(var(--rotateX) * 1deg))
    rotateY(calc(var(--rotateY) * 1deg));
}

唯一缺少的是交互性。当鼠标移动时，演示应该更改X和Y视角（--rotateX和-rotateY），当鼠标滚动（--translateZ）时应该放大和缩小）。

这是JavaScript的诀窍：

// Events
onMouseMove(e) {
  this.worldXAngle = (.5 - (e.clientY / window.innerHeight)) * 180;
  this.worldYAngle = -(.5 - (e.clientX / window.innerWidth)) * 180;
  this.updateView();
};

onMouseWheel(e) {
  /*…*/

  this.worldZ += delta * 5;
  this.updateView();
};

// JavaScript -> CSS
updateView() {
  this.worldEl.style.setProperty('--translateZ', this.worldZ);
  this.worldEl.style.setProperty('--rotateX', this.worldXAngle);
  this.worldEl.style.setProperty('--rotateY', this.worldYAngle);
};

现在，当用户移动鼠标时，演示会更改视图。您可以通过移动鼠标并使用鼠标滚轮放大和缩小来检查：demo

基本上，我们只是更改了CSS自定义属性的值。其他（旋转和放大和缩小）都是由CSS完成的。

提示：调整CSS自定义属性值的最简单方法之一就是在CSS生成的内容中显示其内容（在简单的情况下，例如使用字符串），以便浏览器将自动显示当前应用的值：

body:after {
  content: '--screen-category : 'var(--screen-category);
}

您可以在纯CSS演示（无HTML或JavaScript）中查看。 （调整窗口大小，查看浏览器会自动反映更改后的CSS自定义属性值。）

:root {
    --screen-category: 'desktop';
}

@media screen and (max-width: 1024px) {
    :root {
        --screen-category: 'tablet';
    }
}

@media screen and (max-width: 640px) {
    :root {
        --screen-category: 'phone';
    }
}

body:after {
    content: '--screen-category : 'var(--screen-category);
}

浏览器支持

主流浏览器都支持了CSS自定义属性

这意味着你可以自己开始使用它们。

如果您需要支持旧版浏览器，您可以学习语法和使用示例，并考虑并行切换或使用CSS和预处理器变量的可能方法。

当然，我们需要能够检测CSS和JavaScript中的支持，以便提供回退或增强功能。

这很容易对于CSS，您可以使用带有虚拟功能查询的@supports条件：

@supports ( (--a: 0)) {
  /* supported */
}

@supports ( not (--a: 0)) {
  /* not supported */
}

在JavaScript中，您可以使用与CSS.supports（）静态方法相同的虚拟自定义属性：

const isSupported = window.CSS &&
    window.CSS.supports && window.CSS.supports('--a', 0);

if (isSupported) {
  /* supported */
} else {
  /* not supported */
}

我们看到，CSS自定义属性在每个浏览器中仍然不可用。知道这一点，您可以通过检查它们是否受支持来逐步增强您的应用程序。

例如，您可以生成两个主要的CSS文件：一个具有CSS自定义属性，另一个没有它们，其中属性是内联的（我们将在稍后讨论一些方法）。

默认加载第二个。然后，如果支持自定义属性，只需检查JavaScript并切换到增强版本即可:

<!-- HTML -->
<link href="without-css-custom-properties.css"
    rel="stylesheet" type="text/css" media="all" />

// JavaScript
if(isSupported){
  removeCss('without-css-custom-properties.css');
  loadCss('css-custom-properties.css');
  // + conditionally apply some application enhancements
  // using the custom properties
}

这只是一个例子。往下看，有更好的选择。

如何开始使用它们

针对最近的一项调查，Sass已经成为了开发社区中预处理器的最佳选择。

所以，让我们考虑开始使用CSS自定义属性或使用Sass为他们做准备的方法。

我们有一些观点

1.手动检查代码支持

手动检查代码中自定义属性是否支持的方法的一个优点是如果它可行我们就可以直接用它（不要忘记我们已经切换到Sass）：

$color: red;
:root {
  --color: red;
}

.box {
  @supports ( (--a: 0)) {
    color: var(--color);
  }
  @supports ( not (--a: 0)) {
    color: $color;
  }
}

这种方法确实有许多缺点，其中不仅仅是代码变得复杂，而且复制和粘贴变得很难维护。

2.使用自动转换CSS的插件

PostCSS生态系统今天提供了几十个插件。它们中的几个在生成的CSS输出中处理自定义属性（内联值），并使它们工作，假设您仅提供全局变量（即，您只声明或更改：根选择器中的CSS自定义属性），因此它们的值可以轻松内联。

其中一个例子就是postcss-custom-properties

这个插件提供了几个优点：它使语法工作;它与PostCSS的所有基础设施兼容;并且不需要太多的配置。

但是有一些缺点。该插件需要您使用CSS自定义属性，因此您没有准备项目以从Sass变量切换的路径。此外，您将无法对转换进行很多控制，因为在Sass被编译为CSS之后完成。最后，插件不提供很多调试信息。

3. CSS-VARS MIXIN

我开始在我大多数项目里使用CSS自定义属性并且尝试了很多策略：

• 用cssnext从Sass切换到PostCSS
• 从Sass变量切换到纯CSS自定义属性
• 在Sass中使用CSS变量来检测是否支持它们。

通过这些经验，我开始寻找一个可以满足我的标准的解决方案：

• 它应该很容配合Sass来使用
• 应该直接使用，并且语法必须尽可能接近原生的CSS自定义属性。
• 将CSS输出从内联值切换到CSS变量应该很容易。
• 熟悉CSS自定义属性的团队成员将能够使用该解决方案。
• 应该有一种方法有使用变量的调试信息。

因此，我创建了css-vars，一个Sass mixin，可以在Github上找到。使用它，你就可以使用CSS自定义属性语法。

使用 css-vars Mixin

声明变量，使用的mixin如下：

$white-color: #fff;
$base-font-size: 10px;

@include css-vars((
  --main-color: #000,
  --main-bg: $white-color,
  --main-font-size: 1.5*$base-font-size,
  --padding-top: calc(2vh + 20px)
));

使用这些变量，用var()函数：

body {
  color: var(--main-color);
  background: var(--main-bg, #f00);
  font-size: var(--main-font-size);
  padding: var(--padding-top) 0 10px;
}

这为您提供了一种从一个地方（从Sass）控制所有CSS输出并开始熟悉语法的方法。此外，您可以使用mixin重用Sass变量和逻辑。

当您想要支持的所有浏览器都使用CSS变量时，您需要做的就是添加：

$css-vars-use-native: true;

而不是调整生成的CSS中的变量属性，mixin将开始注册自定义属性，并且var()实例将转到生成的CSS而不进行任何转换。这意味着您将完全切换到CSS自定义属性，并具有我们讨论的所有优点。

如果你想打开有用的调试信息，如下：

$css-vars-debug-log: true;

这会给你

• 当变量没有被定义却被使用的日志
• 变量被重复定义的日志
• 当默认值代替了未定义变量值的日志

结束语

现在你对CSS自定义属性有了更多的了解，包括语法、优势、一些有用的例子还有如何在JavaScript中进行交互

你需要知道如何确认他们是否被支持，他们和CSS预处理器的变量有什么区别，以及如何在浏览器支持之前开始使用原生的CSS变量。

这是开始使用CSS自定义属性并为浏览器支持做准备的最佳时机。