Skip to main content

unit-disallowed-list

指定不允许的单位列表。

¥Specify a list of disallowed units.

a { width: 100px; }
/**           ↑

 *  These units */

message 次要选项 可以接受该规则的参数。

¥The message secondary option can accept the arguments of this rule.

选项​

¥Options

Array<string>​

["array", "of", "units"]

鉴于：

¥Given:

{
  "unit-disallowed-list": ["px", "em", "deg"]
}

以下模式被视为问题：

¥The following patterns are considered problems:

a { width: 100px; }
a { font-size: 10em; }
a { transform: rotate(30deg); }

以下模式不被视为问题：

¥The following patterns are not considered problems:

a { font-size: 1.2rem; }
a { line-height: 1.2; }
a { height: 100vmin; }
a { animation: animation-name 5s ease; }

可选的辅助选项​

¥Optional secondary options

ignoreProperties​

{ "ignoreProperties": { "unit": ["array", "of", "properties", "/regex/"] } }

忽略具有指定属性的声明值中的单位。

¥Ignore units in the values of declarations with the specified properties.

鉴于：

¥Given:

{
  "unit-disallowed-list": [
    ["px", "vmin"],
    {
      "ignoreProperties": {
        "px": ["font-size", "/^border/"],
        "vmin": "width"
      }
    }
  ]
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

a { font-size: 13px; }
a { border-bottom-width: 6px; }
a { width: 100vmin; }

以下模式被视为问题：

¥The following patterns are considered problems:

a { line-height: 12px; }
a { -moz-border-radius-topright: 40px; }
a { height: 100vmin; }

ignoreMediaFeatureNames​

{
  "ignoreMediaFeatureNames": {
    "unit": ["array", "of", "feature-names", "/regex/"]
  }
}

忽略特定功能名称的单位。

¥Ignore units for specific feature names.

鉴于：

¥Given:

{
  "unit-disallowed-list": [
    ["px", "dpi"],
    {
      "ignoreMediaFeatureNames": {
        "px": ["min-width", "/height$/"],
        "dpi": "resolution"
      }
    }
  ]
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

@media (min-width: 960px) {}
@media (max-height: 280px) {}
@media not (resolution: 300dpi) {}

以下模式被视为问题：

¥The following patterns are considered problems:

@media screen and (max-device-width: 500px) {}
@media all and (min-width: 500px) and (max-width: 200px) {}
@media print and (max-resolution: 100dpi) {}

ignoreFunctions​

{ "ignoreFunctions": { "unit": ["array", "of", "functions", "/regex/"] } }

忽略指定函数内部的单元。

¥Ignore units that are inside of the specified functions.

鉴于：

¥Given:

{
  "unit-disallowed-list": [
    ["px"],
    { "ignoreFunctions": ["calc", "/^translate/"] }
  ]
}

以下模式不被视为问题：

¥The following patterns are not considered problems:

a { margin: calc(50% - 100px) }
a { transform: translateX(100px) }