declaration-property-value-no-unknown

禁止在声明中使用未知属性值。

a { top: unknown; }
/** ↑    ↑
 * property and value pairs like these */

此规则认为在 CSS 规范中定义的属性值是已知的。您可以使用 `propertiesSyntax` 和 `typesSyntax` 次要选项来扩展语法。

此规则仅适用于 CSS。您不应将其用于类似 CSS 的语言，例如 Sass 或 Less，因为它们有自己的语法。

此规则处于实验阶段，存在一些误报，我们将在次要版本中修复。

它有时会与

• color-no-invalid-hex
• function-no-unknown
• string-no-newline
• unit-no-unknown

如果标记了重复问题，您可以关闭相应的规则。

选项

true

以下模式被视为问题

a { top: red; }

a { top: unknown; }

以下模式不被视为问题

a { top: 0; }

a { top: var(--foo); }

可选的次要选项

ignoreProperties: { "property": ["/regex/", /regex/, "non-regex"]|"/regex/"|/regex/|"non-regex" }

忽略指定的属性和值对。对象中的键表示属性名称。如果对象中的字符串用 `"/"` 包围，则将其解释为正则表达式。例如，`"/.+/"` 匹配任何字符串。

给定

{
  "top": ["unknown"],
  "/^margin-/": "/^--foo/",
  "padding": "/.+/",
  "/.+/": "--unknown-value"
}

以下模式不被视为问题

a { top: unknown; }

a { margin-top: --foo-bar; }

a { padding: invalid; }

a { width: --unknown-value; }

propertiesSyntax: { property: syntax }

扩展或更改属性语法字典。 CSS 值定义语法 用于定义值的语法。如果定义以 `|` 开头，则将其添加到 现有定义值（如果有）。

给定

{ "size": "<length-percentage>" }

以下模式不被视为问题

a { size: 0; }

a { size: 10px }

typesSyntax: { type: syntax }

扩展或更改类型语法字典。 CSS 值定义语法 用于定义值的语法。如果定义以 `|` 开头，则将其添加到 现有定义值（如果有）。

类型类似于预设，允许您在其他定义中重复使用定义。因此，在使用此选项时，您可能还需要使用 `propertiesSyntax` 选项。

给定

{
  "propertiesSyntax": { "top": "| <--foo()>" },
  "typesSyntax": { "--foo()": "--foo( <length-percentage> )" }
}

以下模式不被视为问题

a { top: --foo(0); }

a { top: --foo(10px); }