@layer

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

CSS @规则 中的 @layer 声明了一个层叠层,同一层内的规则将级联在一起,这给予了开发者对层叠机制的更多控制。

css
@layer utilities {
  /* 创建一个名为 utilities 的层叠层 */
}

语法

@layer @规则可以通过三种方式其一来创建层叠层。第一种方法如上方代码所示,它创建了一个块级的 @规则,其中包含作用于该层内部的 CSS 规则。

css
@layer utilities {
  .padding-sm {
    padding: 0.5rem;
  }

  .padding-lg {
    padding: 0.8rem;
  }
}

一个层叠层同样可以通过 @import 来创建,规则存在于被引入的样式表内:

css
@import (utilities.css) layer(utilities);

你也可以创建带命名的层叠层,但不指定任何样式。例如,单一的命名层:

css
@layer utilities;

或者,多个命名层也可以被同时定义。例如:

css
@layer theme, layout, utilities;

这一做法很有用,因为层最初被指定的顺序决定了它是否有优先级。对于声明而言,如果同一声明在多个层叠层中被指定,最后一层中的将优先于其他层。因此,在上面的例子中,如果 theme 层和 utilities 层中存在冲突的规则,那么 utilities 层中的将优先被应用。

即使 utilities 层中规则的 优先级低于 theme 层中的,该规则仍会被应用。一旦层叠层顺序建立之后,优先级和出现顺序都会被忽略。这将使创建 CSS 选择器变得更加简单,因为你不需要确保每一个选择器都有足够高的优先级来覆盖其他冲突的规则,你只需要确保它们出现在一个顺序更靠后的层叠层中。

备注: 在已经声明层叠层的名字后,它们的顺序随即被确立,你可以重复声明某层叠层的名字来向其添加 CSS 规则。这些样式将被附加到该层的末尾,且层叠层之间的顺序不会改变。

其他不属于任何一层叠层的样式将被集中到同一匿名层,并置于所有层的后部,这意味着任何在层外声明的样式都会覆盖在层内声明的样式。

嵌套层

层叠层允许嵌套,例如:

css
@layer framework {
  @layer layout {
  }
}

framework 层内部的 layout 层附加规则,只需用 . 连接这两层。

css
@layer framework.layout {
  p {
    margin-block: 1rem;
  }
}

匿名层

如果创建了一个层叠层但并未指定名字,例如:

css
@layer {
  p {
    margin-block: 1rem;
  }
}

那么则称为创建了一个匿名层。除创建后无法向其添加规则外,该层和其他命名层功能一致。

形式语法

@layer = 
@layer <layer-name>? { <rule-list> } |
@layer <layer-name># ;

<layer-name> =
<ident> [ '.' <ident> ]*

示例

基本示例

下方的例子创建了两条 CSS 规则。其中一条为 type 层内部的 <p> 元素创建。另一条规则创建于层叠层外部,作用于 .box p

没有层叠层时,选择器 .box p 将会有最高的优先级,因此文字 Hello, world! 将被显示为绿色。当type层应用在匿名层创建之前时,文本将会是紫色的。

并且还要注意顺序,即使我们先声明了non-layered style,它仍然会应用在layer层级之后。

HTML

html
<div class="box">
  <p>Hello, world!</p>
</div>

CSS

css
p {
  color: rebeccapurple;
}

@layer type {
  .box p {
    font-weight: bold;
    font-size: 1.3em;
    color: green;
  }
}

结果

向已存在的层中添加规则

下方的例子创建了两个没有规则的层叠层,随后,CSS 规则被添加到这两层中。base 层定义了 color、border、font-size 和 padding。special 层定义了不同的 color 属性。因为 special 层在定义时排在最后,其中的 color 属性将被应用,文字的颜色将显示为rebeccapurplebase 层中的其他规则仍然有效。

HTML

html
<div class="item">
  我以 <code>color: rebeccapurple</code> 的样式显示,因为
  <code>special</code> 层定义在 <code>base</code>
  层之后。我的绿色边框、font-size 和内边距来自于
  <code>base</code> 层。
</div>

CSS

css
@layer base, special;

@layer special {
  .item {
    color: rebeccapurple;
  }
}

@layer base {
  .item {
    color: green;
    border: 5px solid green;
    font-size: 1.5em;
    padding: 0.5em;
  }
}

结果

规范

Specification
CSS Cascading and Inheritance Level 5
# layering

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
@layer

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

参见