跳到主要内容

declaration-empty-line-before

Require or disallow an empty line before declarations.

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

This rule only applies to standard property declarations. Use the custom-property-empty-line-before rule for custom property declarations.

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

Options

string: "always"|"never"

"always"

The following patterns are considered problems:

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

The following patterns are not considered problems:

a {
--foo: pink;

top: 5px;
}
a {

bottom: 15px;

top: 5px;
}

"never"

The following patterns are considered problems:

a {
--foo: pink;

bottom: 15px;
}
a {

bottom: 15px;

top: 5px;
}

The following patterns are not considered problems:

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 follow a comment.

Shared-line comments do not trigger this option.

For example, with "always":

The following patterns are considered problems:

a {
/* comment */

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

The following patterns are not considered problems:

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

a {
bottom: 5px; /* comment */

top: 5px;
}

"after-declaration"

Reverse the primary option for declarations that follow another declaration.

Shared-line comments do not affect this option.

For example, with "always":

The following patterns are considered problems:

a {

bottom: 15px;

top: 5px;
}
a {

bottom: 15px; /* comment */

top: 5px;
}

The following patterns are not considered problems:

a {

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

bottom: 15px; /* comment */
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 problems:

a {

bottom: 15px;

top: 5px;
}

The following patterns are not considered problems:

a {
bottom: 15px;

top: 5px;
}

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

"after-comment"

Ignore declarations that follow a comment.

For example, with "always":

The following patterns are not considered problems:

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

"after-declaration"

Ignore declarations that follow another declaration.

For example, with "always":

The following patterns are not considered problems:

a {

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

bottom: 15px;

top: 15px;
}
a {

color: orange;
text-decoration: none;

bottom: 15px;
top: 15px;
}

"first-nested"

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

For example, with "always":

The following patterns are not considered problems:

a {
bottom: 15px;

top: 5px;
}

"inside-single-line-block"

Ignore declarations that are inside single-line blocks.

For example, with "always":

The following patterns are not considered problems:

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