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

rule-nested-empty-line-before

Deprecated: instead use the rule-empty-line-before.

Require or disallow an empty line before nested rules.

@media {
       /* ← */
  a {} /* ↑ */
}      /* ↑ */
/**       ↑
 * This line */

Options

string: "always"|"never"|"always-multi-line"|"never-multi-line"

"always"

There must always be an empty line before rules.

The following patterns are considered warnings:

@media { a {} }

@media {
  a {}
}

The following patterns are not considered warnings:

@media {

  a {}
}

"never"

There must never be an empty line before rules.

The following patterns are considered warnings:

@media { a {} }

@media {

  a {}
}

The following patterns are not considered warnings:

@media {
  a {}
}

"always-multi-line"

There must always be an empty line before multi-line rules.

The following patterns are considered warnings:

@media {
  a {
    color: pink;
    top: 0;
  }
}

The following patterns are not considered warnings:

@media {

  a {
    color: pink;
    top: 0;
  }
}

"never-multi-line"

There must never be an empty line before multi-line rules.

The following patterns are considered warnings:

@media {

  a {
    color: pink;
    top: 0;
  }
}

The following patterns are not considered warnings:

@media {
  a {
    color: pink;
    top: 0;
  }
}

Optional secondary options

except: ["first-nested"]

Reverse the primary option if the rule is the first in a block.

For example, with "always":

The following patterns are considered warnings:

@media {

  a {}

  b {}

  c {}
}

The following patterns are not considered warnings:

@media {
  a {}

  b {}

  c {}
}

except: ["after-rule"]

Reverse the primary option if the rule comes after another rule.

For example, with "always":

The following patterns are considered warnings:

@media {
  color: red;
  a {}
  b {}
  c {}
}

The following patterns are not considered warnings:

@media {
  color: red;

  a {}
  b {}
  c {}
}

ignore: ["after-comment"]

Ignore rules that come after a comment.

The following patterns are not considered warnings:

@media {
  /* comment */
  a {}
}

@media {
  /* comment */

  a {}
}