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: { "屬性": ["/正規表示式/", /正規表示式/, "非正規表示式"]|/正規表示式/|/正規表示式/|"非正規表示式" }

忽略指定的屬性和值對。物件中的金鑰表示屬性名稱。如果物件中的字串以 "/" 包圍，它會被解釋為正規表示式。例如，"/.+/" 符合任何字串。

給定

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

以下模式不會被視為問題

a { top: unknown; }

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

a { padding: invalid; }

a { width: --unknown-value; }

propertiesSyntax: { 屬性: 語法 }

擴充或變更屬性語法字典。CSS 值定義語法用於定義值的語法。如果定義以 | 開頭，它會被新增至現有定義值（如果有的話）。

給定

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

以下模式不會被視為問題

a { size: 0; }

a { size: 10px }

typesSyntax: { 類型: 語法 }

延伸或變更類型語法字典。 CSS 值定義語法 用於定義值的語法。如果定義以 | 開頭，則會將其新增至 現有的定義值（如果有的話）。

類型類似於預設值，允許您在其他定義中重複使用定義。因此，在使用此選項時，您可能還想使用 propertiesSyntax 選項。

給定

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

以下模式不會被視為問題

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

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