忽略代码
¥Ignoring code
你可以忽略:
¥You can ignore:
-
文件的一部分
¥parts of a file
-
完全归档
¥files entirely
文件的各个部分
¥Parts of a file
你可以使用 CSS 中的配置注释暂时关闭规则。
¥You can temporarily turn off rules using configuration comments in your CSS.
例如,你可以使用未限定范围的禁用注释关闭所有规则:
¥For example, you can either turn all the rules off with an unscoped disable comment:
/* stylelint-disable */
a {}
/* stylelint-enable */
或者,你可以使用限定范围的禁用注释关闭单个规则:
¥Or you can turn off individual rules with a scoped disable comment:
/* stylelint-disable selector-max-id, declaration-no-important */
#id {
color: pink !important;
}
/* stylelint-enable selector-max-id, declaration-no-important */
你可以使用 /* stylelint-disable-line */
注释关闭各个行的规则,之后你不需要显式地重新启用它们:
¥You can turn off rules for individual lines with a /* stylelint-disable-line */
comment, after which you do not need to explicitly re-enable them:
#id { /* stylelint-disable-line */
color: pink !important; /* stylelint-disable-line declaration-no-important */
}
你还可以仅使用 /* stylelint-disable-next-line */
注释关闭下一行的规则,之后无需显式重新启用它们:
¥You can also turn off rules for the next line only with a /* stylelint-disable-next-line */
comment, after which you do not need to explicitly re-enable them:
#id {
/* stylelint-disable-next-line declaration-no-important */
color: pink !important;
}
Stylelint 支持复杂、重叠的禁用和启用模式:
¥Stylelint supports complex, overlapping disabling & enabling patterns:
/* stylelint-disable */
/* stylelint-enable foo */
/* stylelint-disable foo */
/* stylelint-enable */
/* stylelint-disable foo, bar */
/* stylelint-disable baz */
/* stylelint-enable baz, bar */
/* stylelint-enable foo */
[!WARNING] 非标准语法注释中的配置命令(例如
// stylelint-disable
)仅受最低限度的支持。它们仅在选择器或值列表之外找到时才有效。¥[!WARNING] Configuration commands in non-standard syntax comments (e.g.
// stylelint-disable
) are only minimally supported.\ They will only work when found outside of selectors or value lists.
你还可以在注释末尾的两个连字符之后添加描述:
¥You may also include a description at the end of the comment, after two hyphens:
/* stylelint-disable -- Reason for disabling Stylelint. */
/* stylelint-disable foo -- Reason for disabling the foo rule. */
/* stylelint-disable foo, bar -- Reason for disabling the foo and bar rules. */
[!WARNING] 连字符两侧都必须有空格。
¥[!WARNING] There must be a space on both sides of the hyphens.
完全归档
¥Files entirely
你可以使用 .stylelintignore
文件来忽略特定文件。例如:
¥You can use a .stylelintignore
file to ignore specific files. For example:
vendor/**/*.css
.stylelintignore
文件中的模式必须与 .gitignore
语法 匹配。(node-ignore
在幕后解析你的模式。).stylelintignore
中的模式总是相对于 process.cwd()
进行分析。
¥The patterns in your .stylelintignore
file must match .gitignore
syntax. (Behind the scenes, node-ignore
parses your patterns.) Your patterns in .stylelintignore
are always analyzed relative to process.cwd()
.
Stylelint 在 process.cwd()
中查找 .stylelintignore
文件。你还可以使用 --ignore-path
(在 CLI 中)和 ignorePath
(在 JS 中)选项指定忽略模式文件的路径(绝对路径或相对于 process.cwd()
)。
¥Stylelint looks for a .stylelintignore
file in process.cwd()
. You can also specify a path to your ignore patterns file (absolute or relative to process.cwd()
) using the --ignore-path
(in the CLI) and ignorePath
(in JS) options.
为方便起见,如果 .gitignore
文件已经存在,则可以将其替换为 .stylelintignore
,例如
¥For convenience, if a .gitignore
file is already present it can be substituted for .stylelintignore
e.g.
stylelint "*.css" --ignore-path .gitignore
或者,你可以在配置对象中添加 ignoreFiles
属性。
¥Alternatively, you can add an ignoreFiles
property within your configuration object.