Skip to main content

declaration-empty-line-before

要求或禁止声明前有空行。

¥Require or disallow an empty line before declarations.

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

 *      This line */

该规则仅适用于标准属性声明。使用 custom-property-empty-line-before 规则进行自定义属性声明。

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

fix 选项 可以自动修复此规则报告的所有问题。

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

选项​

¥Options

"always"​

{
  "declaration-empty-line-before": "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"​

{
  "declaration-empty-line-before": "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​

{ "except": ["array", "of", "options"] }

"after-comment"​

反转注释后面的声明的主要选项。

¥Reverse the primary option for declarations that follow a comment.

共享行注释不会触发此选项。

¥Shared-line comments do not trigger this option.

鉴于：

¥Given:

{
  "declaration-empty-line-before": ["always", { "except": ["after-comment"] }]
}

以下模式被视为问题：

¥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.

鉴于：

¥Given:

{
  "declaration-empty-line-before": [
    "always",
    { "except": ["after-declaration"] }
  ]
}

以下模式被视为问题：

¥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.

鉴于：

¥Given:

{
  "declaration-empty-line-before": ["always", { "except": ["first-nested"] }]
}

以下模式被视为问题：

¥The following patterns are considered problems:

a {

  bottom: 15px;

  top: 5px;
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

a {
  bottom: 15px;

  top: 5px;
}

ignore​

{ "ignore": ["array", "of", "options"] }

"after-comment"​

忽略注释后面的声明。

¥Ignore declarations that follow a comment.

鉴于：

¥Given:

{
  "declaration-empty-line-before": ["always", { "ignore": ["after-comment"] }]
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

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

"after-declaration"​

忽略另一个声明后面的声明。

¥Ignore declarations that follow another declaration.

鉴于：

¥Given:

{
  "declaration-empty-line-before": [
    "always",
    { "ignore": ["after-declaration"] }
  ]
}

以下模式不被视为问题：

¥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.

鉴于：

¥Given:

{
  "declaration-empty-line-before": ["always", { "ignore": ["first-nested"] }]
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

a {
  bottom: 15px;

  top: 5px;
}

"inside-single-line-block"​

忽略单行块内的声明。

¥Ignore declarations that are inside single-line blocks.

鉴于：

¥Given:

{
  "declaration-empty-line-before": [
    "always",
    { "ignore": ["inside-single-line-block"] }
  ]
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

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