跳至主要内容

custom-property-empty-line-before

要求或禁止在自定义属性之前使用空行。

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

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

选项​

string: "always"|"never"

"always"​

以下模式被视为问题

a {
  top: 10px;
  --foo: pink;
  --bar: red;
}

以下模式不被视为问题

a {
  top: 10px;

  --foo: pink;

  --bar: red;
}

"never"​

以下模式被视为问题

a {
  top: 10px;

  --foo: pink;

  --bar: red;
}
a {

  --foo: pink;
  --bar: red;
}

以下模式不被视为问题

a {
  top: 10px;
  --foo: pink;
  --bar: red;
}
a {
  --foo: pink;
  --bar: red;
}

可选的辅助选项​

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

"after-comment"​

对于在注释之后的自定义属性，反转主要选项。

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

例如，使用 "always"

以下模式被视为问题

a {

  --foo: pink;
  /* comment */

  --bar: red;
}
a {

  --foo: pink; /* comment */
  --bar: red;
}

以下模式不被视为问题

a {

  --foo: pink;
  /* comment */
  --bar: red;
}
a {

  --foo: pink; /* comment */

  --bar: red;
}

"after-custom-property"​

对于在另一个自定义属性之后的自定义属性，反转主要选项。

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

例如，使用 "always"

以下模式被视为问题

a {

  --foo: pink;

  --bar: red;
}
a {

  --foo: pink; /* comment */

  --bar: red;
}

以下模式不被视为问题

a {

  --foo: pink;
  --bar: red;
}
a {

  --foo: pink; /* comment */
  --bar: red;
}

"first-nested"​

对于嵌套且是其父节点的第一个子节点的自定义属性，反转主要选项。

例如，使用 "always"

以下模式被视为问题

a {

  --foo: pink;

  --bar: red;
}

以下模式不被视为问题

a {
  --foo: pink;

  --bar: red;
}

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

"after-comment"​

忽略在注释之后的自定义属性。

例如，使用 "always"

以下模式不被视为问题

a {
  /* comment */
  --foo: pink;
}

"first-nested"​

忽略嵌套且是其父节点的第一个子节点的自定义属性。

例如，使用 "always"

以下模式不被视为问题

a {
  --foo: pink;

  --bar: red;
}

"inside-single-line-block"​

忽略位于单行块内的自定义属性。

例如，使用 "always"

以下模式不被视为问题

a { --foo: pink; --bar: red; }