DeviceManager/node_modules/stylelint-scss/src/rules/double-slash-comment-empty-line-before/README.md

double-slash-comment-empty-line-before

Require or disallow an empty line before //-comments.

a {}
           /* ← */
// comment /* ↑ */
/**           ↑
*     This line */

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

This rule only works with SCSS-like single-line comments and ignores:

• comments that are the very first nodes in a file;
• CSS comments (/* */);
• comments that are on the same line as some non-comment code (inline comments).

Options

string: "always"|"never"

"always"

There must always be an empty line before //-comments.

The following patterns are considered warnings:

a {}
// comment

The following patterns are not considered warnings:

a {}

// comment

a {} // comment

"never"

There must never be an empty line before //-comments.

The following patterns are considered warnings:

a {}

// comment

The following patterns are not considered warnings:

a {}
// comment

a {} // comment

Optional options

except: ["first-nested", "inside-block"]

"first-nested"

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

For example, with "always":

The following patterns are considered warnings:

a {

  // comment
  color: pink;
}

The following patterns are not considered warnings:

a {
  // comment
  color: pink;
}

"inside-block"

Reverse the primary option for //-comments that are inside a block.

For example, with "always":

The following patterns are considered warnings:

a {
  background: pink;

  // comment
  color: pink;
}

The following patterns are not considered warnings:

a {
  background: pink;
  // comment
  color: pink;
}

ignore: ["between-comments", "stylelint-commands", "inside-block"]

"between-comments"

Don't require an empty line before //-comments that are placed after other //-comments or CSS comments.

For example, with "always":

The following patterns are not considered warnings:

a {
  background: pink;

  // comment
  // comment
  color: #eee;
}

a {
  background: pink;

  /* comment */
  // comment
  color: #eee;
}

"stylelint-commands"

Ignore //-comments that deliver commands to stylelint, e.g. // stylelint-disable color-no-hex.

For example, with "always":

The following patterns are considered warnings:

a {
  background: pink;
  // not a stylelint command
  color: #eee;
}

The following patterns are not considered warnings:

a {
  background: pink;
  // stylelint-disable color-no-hex
  color: pink;
}

"inside-block"

Ignore //-comments that are inside a block.

For example, the following patterns are not considered warnings:

a {
  background: pink;
  // comment
  color: pink;
}

a {
  background: pink;

  // comment
  color: pink;
}