跳至主要内容

declaration-empty-line-before

要求或禁止在声明之前使用空行。

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

此规则仅适用于标准属性声明。对于自定义属性声明，请使用 custom-property-empty-line-before 规则。

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

选项​

string: "always"|"never"

"always"​

以下模式被视为问题

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

以下模式不被视为问题

a {
  --foo: pink;

  top: 5px;
}
a {

  bottom: 15px;

  top: 5px;
}

"never"​

以下模式被视为问题

a {
  --foo: pink;

  bottom: 15px;
}
a {

  bottom: 15px;

  top: 5px;
}

以下模式不被视为问题

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

可选的次要选项​

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

"after-comment"​

对于在注释之后声明的声明，反转主要选项。

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

例如，使用 "always"

以下模式被视为问题

a {
  /* comment */

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

以下模式不被视为问题

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

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

  top: 5px;
}

"after-declaration"​

对于在另一个声明之后声明的声明，反转主要选项。

共享行注释不会影响此选项。

例如，使用 "always"

以下模式被视为问题

a {

  bottom: 15px;

  top: 5px;
}
a {

  bottom: 15px; /* comment */

  top: 5px;
}

以下模式不被视为问题

a {

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

  bottom: 15px; /* comment */
  top: 5px;
}

"first-nested"​

对于嵌套且是其父节点的第一个子节点的声明，反转主要选项。

例如，使用 "always"

以下模式被视为问题

a {

  bottom: 15px;

  top: 5px;
}

以下模式不被视为问题

a {
  bottom: 15px;

  top: 5px;
}

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

"after-comment"​

忽略在注释之后声明的声明。

例如，使用 "always"

以下模式不被视为问题

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

"after-declaration"​

忽略在另一个声明之后声明的声明。

例如，使用 "always"

以下模式不被视为问题

a {

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

  bottom: 15px;

  top: 15px;
}
a {

  color: orange;
  text-decoration: none;

  bottom: 15px;
  top: 15px;
}

"first-nested"​

忽略嵌套且是其父节点的第一个子节点的声明。

例如，使用 "always"

以下模式不被视为问题

a {
  bottom: 15px;

  top: 5px;
}

"inside-single-line-block"​

忽略位于单行块内的声明。

例如，使用 "always"

以下模式不被视为问题

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