Skip to main content

custom-property-empty-line-before

Require or disallow an empty line before custom properties.

a {
  top: 10px;
                          /* ← */
  --foo: pink;            /* ↑ */
}                         /* ↑ */
/**                          ↑
 *                   This line */

The fix option can automatically fix all of the problems reported by this rule.

Options​

"always"​

{
  "custom-property-empty-line-before": "always"
}

The following patterns are considered problems:

a {
  top: 10px;
  --foo: pink;
  --bar: red;
}

The following patterns are not considered problems:

a {
  top: 10px;

  --foo: pink;

  --bar: red;
}

"never"​

{
  "custom-property-empty-line-before": "never"
}

The following patterns are considered problems:

a {
  top: 10px;

  --foo: pink;

  --bar: red;
}
a {

  --foo: pink;
  --bar: red;
}

The following patterns are not considered problems:

a {
  top: 10px;
  --foo: pink;
  --bar: red;
}
a {
  --foo: pink;
  --bar: red;
}

Optional secondary options​

except​

{ "except": ["array", "of", "options"] }

"after-comment"​

Reverse the primary option for custom properties that follow a comment.

Shared-line comments do not trigger this option.

Given:

{
  "custom-property-empty-line-before": [
    "always",
    { "except": ["after-comment"] }
  ]
}

The following patterns are considered problems:

a {

  --foo: pink;
  /* comment */

  --bar: red;
}
a {

  --foo: pink; /* comment */
  --bar: red;
}

The following patterns are not considered problems:

a {

  --foo: pink;
  /* comment */
  --bar: red;
}
a {

  --foo: pink; /* comment */

  --bar: red;
}

"after-custom-property"​

Reverse the primary option for custom properties that follow another custom property.

Shared-line comments do not affect this option.

Given:

{
  "custom-property-empty-line-before": [
    "always",
    { "except": ["after-custom-property"] }
  ]
}

The following patterns are considered problems:

a {

  --foo: pink;

  --bar: red;
}
a {

  --foo: pink; /* comment */

  --bar: red;
}

The following patterns are not considered problems:

a {

  --foo: pink;
  --bar: red;
}
a {

  --foo: pink; /* comment */
  --bar: red;
}

"first-nested"​

Reverse the primary option for custom properties that are nested and the first child of their parent node.

Given:

{
  "custom-property-empty-line-before": [
    "always",
    { "except": ["first-nested"] }
  ]
}

The following patterns are considered problems:

a {

  --foo: pink;

  --bar: red;
}

The following patterns are not considered problems:

a {
  --foo: pink;

  --bar: red;
}

ignore​

{ "ignore": ["array", "of", "options"] }

"after-comment"​

Ignore custom properties that follow a comment.

Given:

{
  "custom-property-empty-line-before": [
    "always",
    { "except": ["after-comment"] }
  ]
}

The following patterns are not considered problems:

a {
  /* comment */
  --foo: pink;
}

"first-nested"​

Ignore custom properties that are nested and the first child of their parent node.

Given:

{
  "custom-property-empty-line-before": [
    "always",
    { "except": ["first-nested"] }
  ]
}

The following patterns are not considered problems:

a {
  --foo: pink;

  --bar: red;
}

"inside-single-line-block"​

Ignore custom properties that are inside single-line blocks.

Given:

{
  "custom-property-empty-line-before": [
    "always",
    { "except": ["inside-single-line-block"] }
  ]
}

The following patterns are not considered problems:

a { --foo: pink; --bar: red; }