PhpStorm 2021.3 Help

CSS 中的代码检查

本主题列出了 CSS 中可用的所有 PhpStorm 代码检查。

您可以在编辑器 |上切换特定检查或更改其严重性级别。IDE 设置的检查Ctrl+Alt+S页面。

可能的错误

检查

描述

默认严重性

选择器列表中缺少逗号

报告多行选择器。这很可能意味着实际上打算使用多个单行选择器,但在一行或多行的末尾缺少逗号。

例子:
input /* 逗号可能已经忘记了 */ .button { margin: 1px; }

警告 警告

缺少通用字体系列名称

验证该font-family属性是否包含通用字体系列名称作为备用选项。

通用字体系列名称为:serifsans-serifcursivefantasymonospace

警告 警告

非整数长度(以像素为单位)

以像素为单位报告非整数长度。

例子:
宽度:3.14 像素

弱警告 弱警告

代码质量工具

检查

描述

默认严重性

样式线

报告Stylelint linter检测到的差异。

突出显示基于Stylelint 配置文件中为每个单独规则指定的规则严重性。

已禁用

W3C CSS 验证器

报告W3C CSS Validator检测到的差异。

已禁用

代码风格问题

检查

描述

默认严重性

缺少分号

报告声明末尾缺少分号。

已禁用

冗余测量单元

报告一个零值的度量单位,其中单位不是规范要求的。

例子:
宽度:0px

警告 警告

无效元素

检查

描述

默认严重性

无效的功能

报告未知的CSS 函数或不正确的函数参数。

错误 错误

无效的媒体功能

报告未知的CSS 媒体功能或不正确的媒体功能值。

错误 错误

无效的属性值

报告不正确的 CSS 属性值。

错误 错误

无效的伪选择器

报告不正确的 CSS伪类 伪元素

错误 错误

无效的类型选择器

报告与未知 HTML 元素匹配的CSS类型选择器。

警告 警告

错误的@import

报告错位的@import陈述。

根据规范@import规则必须在所有其他类型的规则之前,除了@charset规则。

警告 警告

错位或不正确的@charset

报告错误@charset的 at-rule 或不正确的字符集值。

警告 警告

负属性值

报告不应小于零的 CSS 属性的负值,例如对象宽度或高度。

错误 错误

未知规则

报告未知的CSS at-rule

错误 错误

未知财产

报告未知的 CSS 属性或在错误上下文中使用的属性。

将未知属性添加到“自定义 CSS 属性”列表以跳过验证。

警告 警告

“撰写”规则中未解决的类

报告'composes'规则中的 CSS 类引用,该引用无法解析为任何有效目标。

例子:
.className {/* ... */} .otherClassName { 组成:className; }

错误 错误

未解决的自定义属性

报告函数参数中对自定义属性的未解析引用var()

错误 错误

未解决的文件引用

报告未解析的文件引用,例如,@import语句中的路径不正确。

错误 错误

其他检查

检查

描述

默认严重性

颜色可以替换为#-hex

报告rgb()hsl()或其他颜色函数。

建议用等效的十六进制表示法替换颜色函数。

例子:
RGB(12, 15, 255)

应用快速修复后:
#0c0fff
.

已禁用

颜色可以替换为 rgb()

报告hsl()hwb()颜色函数或十六进制颜色表示法。

建议用等效rgb()rgba()颜色函数替换此类颜色值。

例子:
#0c0fff

应用快速修复后:
RGB(12, 15, 255)
.

已禁用

被覆盖的属性

报告规则集中的重复 CSS 属性。尊重速记属性。

例子:
.foo { 边距底部:1px; 边距底部:1px;/* 复制margin-bottom */ margin: 0; /* 覆盖底部边距 */ }

警告 警告

属性可以安全地用简写代替

报告一组速记属性。建议用等效的速记形式替换一套完整的速记 CSS 属性。

例如,4 个属性:padding-toppadding-rightpadding-bottompadding-left可以安全地替换为单个padding属性。

请注意,如果速记属性集不完整(例如,规则集中只有 3 个属性),则不会显示此检查,padding-xxx因为切换到速记可能会改变结果。对于这种情况,请考虑“属性可能会被简写”检查。

弱警告 弱警告

属性可能会被简写代替

报告一组速记 CSS 属性并建议用速记形式替换一组不完整的速记 CSS 属性,但在这种情况下不是 100% 等效的。

例如,2 个属性:outline-colorandoutline-style可以替换为单个outline. 这种替换不是 100% 等效的,因为速记将所有省略的子值重置为其初始状态。在此示例中,切换到outline简写意味着outline-width也将其设置为其初始值,即medium.

此检查不处理全套速记属性(切换到速记时是 100% 安全的)。对于这种情况,请参阅“属性可以安全地替换为速记”检查。

信息没有高亮,只有修复

属性与所选浏览器不兼容

报告指定浏览器不支持的 CSS 属性。基于MDN 兼容性数据

已禁用

未使用的选择器

报告出现在选择器中但未在 HTML 中使用的 CSS 类或元素 ID。

请注意,只有通过 Code | 运行时才能获得完整的检查结果。检查代码或代码 | 分析代码 | 按名称运行检查。由于性能原因,不会动态检查样式表文件。

警告 警告

最后修改:2022 年 2 月 11 日