stylelint 规则 | Rules 详解
以下是 stylelint 的所有规则,并参照css vocabulary进行分类。
颜色
color-hex-case: 指定十六进制颜色大小写 。color-hex-length: 指定十六进制颜色是否使用缩写 。color-named: 要求 (可能的情况下) 或 禁止使用命名的颜色。color-no-hex: 禁止使用十六进制颜色。color-no-invalid-hex: 禁止使用无效的十六进制颜色。
字体系列
font-family-name-quotes:指定字体名称是否需要使用引号引起来。font-family-no-duplicate-names: 禁止使用重复的字体名称。
字体重量
font-weight-notation:要求使用数字或命名的 (可能的情况下)font-weight值。
功能
function-blacklist:指定一个禁用的函数的黑名单。function-calc-no-unspaced-operator:禁止在calc函数内使用不加空格的操作符。function-comma-newline-after:在函数的逗号之后要求有一个换行符或禁止有空白。function-comma-newline-before:在函数的逗号之前要求有一个换行符或禁止有空白。function-comma-space-after:在函数的逗号之后要求有一个空格或禁止有空白。function-comma-space-before:在函数的逗号之前要求有一个空格或禁止有空白。function-linear-gradient-no-nonstandard-direction:根据标准语法,禁止linear-gradient()中无效的方向值。function-max-empty-lines:限制函数中相邻的空行数量。function-name-case:指定函数名称的大小写。function-parentheses-newline-inside:在函数的括号内要求有一个换行符或禁止有空白。function-parentheses-space-inside:在函数的括号内要有一个空格或禁止有空白。function-url-data-uris:要求或禁止在 url 中使用 data URI。function-url-no-scheme-relative:禁止使用相对协议的链接。function-url-quotes:要求或禁止 url 使用引号。function-url-scheme-whitelist:指定一个允许的 url 协议的白名单。function-whitelist:指定一个允许的函数的白名单。function-whitespace-after:要求或禁止在函数之后有空白。
数
number-leading-zero:要求或禁止小于 1 的小数的前导 0 。number-max-precision:限制小数位数。number-no-trailing-zeros:禁止数字中的拖尾 0 。
字符串
string-no-newline:禁止在字符串中使用(非转义的)换行符。string-quotes:指定字符串使用单引号还是双引号 。
长度
length-zero-no-unit: 长度为0时,禁止使用单位 。
时间
time-no-imperceptible:禁止animation和transition小于或等于 100ms。
单元
unit-blacklist:指定一个禁止使用的单位的黑名单。unit-case:指定单位的大小写。- known units.
unit-no-unknown:禁止使用未知单位。unit-whitelist:指定一个所允许的单位的白名单。
值
value-keyword-case:指定关键字的值的大小写。value-no-vendor-prefix:禁止给值添加浏览器引擎前缀。
值清单
value-list-comma-newline-after:在值列表的逗号之后要求有一个换行符或禁止有空白。value-list-comma-newline-before:在值列表的逗号之前要求有一个换行符或禁止有空白。value-list-comma-space-after:在值列表的逗号之后要求有一个空格或禁止有空白。value-list-comma-space-before:在值列表的逗号之前要求有一个空格或禁止有空白。value-list-max-empty-lines:限制值列表中相邻空行数量。
Custom property
custom-property-empty-line-before:要求或禁止在自定义属性之前有一行空行。custom-property-no-outside-root:禁止在:root规则之外使用自定义属性。custom-property-pattern:为自定义属性指定一个匹配模式。
Shorthand property
shorthand-property-no-redundant-values:禁止在简写属性中使用冗余值 。
Property
property-blacklist:指定一个禁止使用的属性的黑名单。property-case:指定属性的大小写。property-no-unknown:禁止使用未知属性。property-no-vendor-prefix:禁止属性使用浏览器引擎前缀。property-whitelist:指定一个允许使用的属性的白名单。
关键帧声明
keyframe-declaration-no-important:禁止在 keyframe 声明中使用!important。
声明
declaration-bang-space-after:在感叹号之后要求有一个空格或禁止有空白。declaration-bang-space-before:在感叹号之前要求有一个空格或禁止有空白。declaration-colon-newline-after:在冒号之后要求有一个换行符或禁止有空白。declaration-colon-space-after:在冒号之后要求有一个空格或禁止有空白 。declaration-colon-space-before:在冒号之前要求有一个空格或禁止有空白 。declaration-empty-line-before:要求或禁止在声明语句之前有空行。declaration-no-important:禁止在声明中使用!important。declaration-property-unit-blacklist:指定一个在声明中禁止使用的属性和单位的黑名单。declaration-property-unit-whitelist:指定一个在声明中允许使用的属性和单位的白名单。declaration-property-value-blacklist:指定一个在声明中禁止使用的属性和值的黑名单。declaration-property-value-whitelist:指定一个在声明中允许使用的属性和值的白名单。
声明块
declaration-block-no-duplicate-properties:在声明的块中中禁止出现重复的属性。declaration-block-no-ignored-properties:禁止使用由于其他属性的原因而被忽略的属性。declaration-block-no-redundant-longhand-properties:禁止使用可以缩写却不缩写的属性。declaration-block-no-shorthand-property-overrides:禁止缩写属性覆盖相关普通写法属性。declaration-block-properties-order:指定声明块中的属性顺序 。待调整declaration-block-semicolon-newline-after:在声明块的分号之后要求有一个换行符或禁止有空白。declaration-block-semicolon-newline-before:在声明块的分号之前要求有一个换行符或禁止有空白。declaration-block-semicolon-space-after:在声明块的分号之后要求有一个空格或禁止有空白。declaration-block-semicolon-space-before:在声明块的分号之后前要求有一个空格或禁止有空白。declaration-block-single-line-max-declarations:限制单行声明块中声明的数量。declaration-block-trailing-semicolon:要求或禁止在声明块中使用拖尾分号。
块
block-closing-brace-empty-line-before:要求或禁止在闭括号之前有空行。block-closing-brace-newline-after:在闭括号之后要求有一个换行符或禁止有空白 。block-closing-brace-newline-before:在闭括号之前要求有一个换行符或禁止有空白 。block-closing-brace-space-after:在闭括号之后要求有一个空格或禁止有空格。block-closing-brace-space-before:在闭括号之前要求有一个空格或禁止有空格。block-no-empty:禁止出现空块。block-no-single-line:禁止出现单行块。block-opening-brace-newline-after:在开括号之后要求有一个换行符 。block-opening-brace-newline-before:在括开号之前要求有一个换行符或禁止有空白 。block-opening-brace-space-after:在开括号之后要求有一个空格或禁止有空白 。block-opening-brace-space-before:在开括号之前要求有一个空格或禁止有空白 。
选择
selector-attribute-brackets-space-inside:在特性选择器的方括号内要求有空格或禁止有空白。selector-attribute-operator-blacklist:指定一个禁止使用的特性(attribute)操作符的黑名单。selector-attribute-operator-space-after:在特性选择器的操作符之后要求有一个空格或禁止有空白。selector-attribute-operator-space-before:在特性选择器的操作符之前要求有一个空格或禁止有空白。selector-attribute-operator-whitelist:指定允许使用的特性(attribute)操作符的白名单。selector-attribute-quotes:要求或禁止特性值使用引号。selector-class-pattern:为类选择器指定一个匹配模式。selector-combinator-space-after:在关系选择符之后要求有一个空格或禁止有空白 。selector-combinator-space-before:在关系选择符之前要求有一个空格或禁止有空白 。selector-descendant-combinator-no-non-space:禁止包含选择符出现非空格字符。selector-id-pattern:指定一个 id 选择器的匹配模式。selector-max-compound-selectors:限制复合选择器的数量。selector-max-specificity:限制选择器的优先级。selector-nested-pattern:指定一个嵌套选择器的匹配模式。selector-no-attribute:禁用特性选择器。selector-no-combinator:禁用关系选择符。selector-no-empty:禁止出现空选择器。selector-no-id:禁用 id 选择器。selector-no-qualifying-type:禁止使用类型对选择器进行限制。selector-no-type:禁用类型选择器。selector-no-universal:禁用通配符选择器。selector-no-vendor-prefix:禁止使用浏览器引擎前缀。selector-pseudo-class-blacklist:指定一个禁止使用的伪类选择器的黑名单。selector-pseudo-class-case:指定伪类选择器的大小写。selector-pseudo-class-no-unknown:禁止使用未知的伪类选择器。selector-pseudo-class-parentheses-space-inside:在伪类选择器的括号内要求使用一个空格或禁止有空白。selector-pseudo-class-whitelist:指定一个允许使用的伪类选择器的白名单。selector-pseudo-element-case:指定伪元素的大小写。selector-pseudo-element-colon-notation:指定伪元素使用单冒号还是双冒号。selector-pseudo-element-no-unknown:禁止使用未知的伪元素。selector-root-no-composition:禁止:root混合使用。selector-type-case:指定类型选择器的大小写。selector-type-no-unknown:禁用未知的类型选择器。selector-max-empty-lines:限制选择器中相邻空行数量。
选择列表
selector-list-comma-newline-after: 要求选择器列表的逗号之后有一个换行符或禁止在逗号之后有空白 。selector-list-comma-newline-before: 要求选择器列表的逗号之前有一个换行符或禁止在逗号之前有空白 。selector-list-comma-space-after:要求在选择器列表的逗号之后有一个空格,或禁止有空白 。selector-list-comma-space-before:要求在选择器列表的逗号之前有一个空格,或禁止有空白 。
根规则
root-no-standard-properties:禁止在:root中出现标准属性。
规则
rule-nested-empty-line-before:在嵌套的规则中要求或禁止有空行。rule-non-nested-empty-line-before:在非嵌套的规则之前要求或禁止有空行。
媒体功能
media-feature-colon-space-after:在 media 特性中的冒号之后要求有一个空格或禁止有空白。media-feature-colon-space-before:在 media 特性中的冒号之前要求有一个空格或禁止有空白。media-feature-name-blacklist:指定禁止使用的 media 特性名称的黑名单。media-feature-name-case:指定 media 特性名称的大小写。media-feature-name-no-unknown:禁止使用未知的 media 特性名称。media-feature-name-no-vendor-prefix:禁止 media 特性名称带有浏览器引擎前缀。media-feature-name-whitelist:指定允许使用的 media 特性名称的白名单。media-feature-no-missing-punctuation:禁止非布尔类型的 media 特性缺少标点。media-feature-parentheses-space-inside:在media 特性的括号内要求有一个空格或禁止有空白。media-feature-range-operator-space-after:在 media 特性的范围操作符之后要求有一个空格或禁止有空白。media-feature-range-operator-space-before:在 media 特性的范围操作符之前要求有一个空格或禁止有空白。
自定义媒体
custom-media-pattern:指定一个自定义媒体查询名称的匹配模式。
媒体查询列表
media-query-list-comma-newline-after:在媒体查询的逗号之后要求有一个换行符或禁止有空白。media-query-list-comma-newline-before:在媒体查询的逗号之前要求有一个换行符或禁止有空白。media-query-list-comma-space-after:在媒体查询的逗号之后要求有一个空格或禁止有空白。media-query-list-comma-space-before:在媒体查询的逗号之前要求有一个空格或禁止有空白。
At-rule
at-rule-blacklist:指定一个禁止使用的 at 规则的黑名单。- empty line before at-rules .
at-rule-empty-line-before:要求或禁止在 at 规则之前有空行 。at-rule-name-case:指定 at 规则名称的大小写。at-rule-name-newline-after:要求在 at 规则之后有一个换行符。at-rule-name-space-after:要求在 at 规则之后有一个空格。at-rule-no-unknown:禁止使用未知的 at 规则。at-rule-no-vendor-prefix:禁止 at 规则使用浏览器引擎前缀。at-rule-semicolon-newline-after:要求在 at 规则的分号之后有一个换行符 。at-rule-whitelist:指定一个允许使用的 at 规则的白名单。
stylelint-disable 注释
stylelint-disable-reason:要求在stylelint-disable注释之前或之后有一个原因的描述注释。
注释
comment-empty-line-before:要求或禁止在注释之前有空行。comment-no-empty:禁止空注释。comment-whitespace-inside:要求或禁止在注释标签内有空白。comment-word-blacklist:指定一个不允许出现在注释中的单词的黑名单。
一般/表
indentation:指定缩进 。max-empty-lines:限制相邻空行的数量。max-line-length:限制单行的长度。max-nesting-depth:限制允许嵌套的深度。no-browser-hacks:禁用与你使用的浏览器无关的 browser hacks。no-descending-specificity:禁止低优先级的选择器出现在高优先级的选择器之后。no-duplicate-selectors:在一个样式表中禁止出现重复的选择器。no-empty-source:禁止空源。no-eol-whitespace:禁止行尾空白。no-extra-semicolons:禁止多余的分号。no-indistinguishable-colors:禁用相似的颜色。no-invalid-double-slash-comments:禁用 CSS 不支持的双斜线注释 (//...)。no-missing-end-of-source-newline:禁止缺少文件末尾的换行符。no-unknown-animations:禁止动画名称与@keyframes声明不符。no-unsupported-browser-features:禁止使用浏览器不支持的特性。


