custom-property-empty-line-before

Require or disallow an empty line before custom properties.

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

The --fix option on the command line can automatically fix all of the problems reported by this rule. We recommend to enable indentation rule for better autofixing results with this rule.

Options

string: "always"|"never"

"always"

The following patterns are considered violations:

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

The following patterns are not considered violations:

a {
  top: 10px;

  --foo: pink;

  --bar: red;
}

"never"

The following patterns are considered violations:

a {
  top: 10px;

  --foo: pink;

  --bar: red;
}

a {

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

The following patterns are not considered violations:

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

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

Optional secondary options

except: ["after-comment", "after-custom-property", "first-nested"]

"after-comment"

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

Shared-line comments do not trigger this option.

For example, with "always":

The following patterns are considered violations:

a {

  --foo: pink;
  /* comment */

  --bar: red;
}

a {

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

The following patterns are not considered violations:

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.

For example, with "always":

The following patterns are considered violations:

a {

  --foo: pink;

  --bar: red;
}

a {

  --foo: pink; /* comment */

  --bar: red;
}

The following patterns are not considered violations:

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.

For example, with "always":

The following patterns are considered violations:

a {

  --foo: pink;

  --bar: red;
}

The following patterns are not considered violations:

a {
  --foo: pink;

  --bar: red;
}

ignore: ["after-comment", "first-nested", "inside-single-line-block"]

"after-comment"

Ignore custom properties that follow a comment.

For example, with "always":

The following patterns are not considered violations:

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

"first-nested"

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

For example, with "always":

The following patterns are not considered violations:

a {
  --foo: pink;

  --bar: red;
}

"inside-single-line-block"

Ignore custom properties that are inside single-line blocks.

For example, with "always":

The following patterns are not considered violations:

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