notes/node_modules/stylelint/lib/rules/declaration-empty-line-before/README.md

2.9 KiB

declaration-empty-line-before

Require or disallow an empty line before declarations.

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

Options

string: "always"|"never"

"always"

The following patterns are considered warnings:

a {
  --foo: pink;
  top: 5px;
}
a {
  bottom: 15px;
  top: 5px;
}

The following patterns are not considered warnings:

a {
  --foo: pink;

  top: 5px;
}
a {

  bottom: 15px;

  top: 5px;
}

"never"

The following patterns are considered warnings:

a {
  --foo: pink;

  bottom: 15px;
}
a {

  bottom: 15px;

  top: 5px;
}

The following patterns are not considered warnings:

a {
  --foo: pink;
  bottom: 15px;
}
a {
  bottom: 15px;
  top: 5px;
}

Optional secondary options

except: ["after-comment", "after-declaration", "first-nested"]

"after-comment"

Reverse the primary option for declarations that come after a comment.

For example, with "always":

The following patterns are considered warnings:

a {
  /* comment */

  top: 5px;
}

The following patterns are not considered warnings:

a {
  /* comment */
  top: 5px;
}

"after-declaration"

Reverse the primary option for declarations that come after another declaration.

For example, with "always":

The following patterns are considered warnings:

a {

  bottom: 15px;

  top: 5px;
}

The following patterns are not considered warnings:

a {

  bottom: 15px;
  top: 5px;
}

"first-nested"

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

For example, with "always":

The following patterns are considered warnings:

a {

  bottom: 15px;

  top: 5px;
}

The following patterns are not considered warnings:

a {
  bottom: 15px;

  top: 5px;
}

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

"after-comment"

Ignore declarations that are preceded by comments.

For example, with "always":

The following patterns are not considered warnings:

a {
  /* comment */
  bottom: 15px;
}

"after-declaration"

Ignore declarations that are preceded by declarations, to allow for multiple declaration sets in the same block.

For example, with "always":

The following patterns are not considered warnings:

a {

  bottom: 15px;
  top: 15px;
}
a {

  bottom: 15px;

  top: 15px;
}
a {

  color: orange;
  text-decoration: none;

  bottom: 15px;
  top: 15px;
}

"inside-single-line-block"

Ignore declarations that are inside single-line blocks.

For example, with "always":

The following patterns are not considered warnings:

a { bottom: 15px; top: 5px; }