CSSLayerStatementRule

{{APIRef("CSSOM")}}

The CSSLayerStatementRule represents a {{cssxref("@layer")}} statement rule. Unlike {{domxref("CSSLayerBlockRule")}}, it doesn't contain other rules and merely defines one or several layers by providing their names.

This rule allows to explicitly declare the ordering layer that is in an apparent way at the beginning of a CSS file: the layer order is defined by the order of first occurrence of each layer name. Declaring them with a statement allows the reader to understand the layer order. It also allows inline and imported layers to be interleaved, which is not possible when using the CSSLayerBlockRule syntax.

{{InheritanceDiagram}}

Instance properties

Also inherits properties from its parent interface, {{DOMxRef("CSSRule")}}.

• {{DOMxRef("CSSLayerStatementRule.nameList")}} {{ReadOnlyInline}}
  • An array of strings, that represent the name of each cascade layer by the rule

Examples

HTML

<p></p>

CSS

@layer layerName, layerName2;

JavaScript

const item = document.getElementsByTagName("p")[0];
const rules = document.getElementById("css-output").sheet.cssRules;

const layer = rules[0]; // A CSSLayerStatementRule

item.textContent = `The CSS @layer statement declares the following layers: ${layer.nameList.join(
  ", ",
)}.`;

Result

{{EmbedLiveSample("Examples")}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{cssxref("@layer")}}
• The @layer statement at-rule for named layers
• {{DOMxRef("CSSLayerBlockRule")}}