重大更改:-moz-document
Firefox 过去有一个 @-moz-document 规则需要特殊解析。随着 Firefox 移除对该规则的支持,Sass 正在逐步移除对解析这些规则的支持。
Sass 历史上支持对 @-moz-document
规则进行特殊解析。由于Firefox 已停止对它们的 支持,Sass 也将停止支持特殊解析,并将将其视为未知的 at-规则。
有一个例外:空 url 前缀函数仍然允许,因为这用于针对 Firefox 的 hack。
CSS 输出
@-moz-document url-prefix() {
.error {
color: red;
}
}
过渡期过渡期永久链接
- Dart Sass
- 自 1.7.2 版本起
- LibSass
- ✗
- Ruby Sass
- ✗
首先,我们将对 @-moz-document
的所有用法发出弃用警告,除了空 url-前缀 hack 之外。
在 Dart Sass 2.0 中,@-moz-document
将被视为未知的 at-规则。
我能否静默警告?我能否静默警告?永久链接
Sass 提供了一套强大的选项来管理您何时看到哪些弃用警告。
简洁模式和详细模式简洁模式和详细模式永久链接
默认情况下,Sass 以简洁模式运行,它只会打印每种类型的弃用警告五次,然后它会静默其他警告。这有助于确保用户知道何时需要注意即将发生的重大更改,而不会产生过多的控制台噪音。
如果您改为在详细模式下运行 Sass,它将打印遇到的每个弃用警告。这对于在修复弃用时跟踪剩余工作非常有用。您可以使用命令行上的--verbose
标志或 JavaScript API 中的verbose
选项启用详细模式。
⚠️ 注意!
从 JS API 运行时,Sass 不会在编译之间共享任何信息,因此默认情况下,它会为编译的每个样式表打印五次警告。但是,您可以通过编写(或要求您最喜欢的框架的 Sass 插件的作者编写)一个自定义 Logger
来解决此问题,该 Logger
每个弃用只打印五次错误,并且可以在多个编译中共享。
静默依赖项中的弃用静默依赖项中的弃用永久链接
有时,您的依赖项存在您无法解决的弃用警告。您可以使用命令行上的--quiet-deps
标志或 JavaScript API 中的quietDeps
选项静默来自依赖项的弃用警告,同时仍为您的应用程序打印它们。
出于此标志的目的,“依赖项”是指任何不仅仅是从入口点样式表进行一系列相对加载的样式表。这意味着来自加载路径的任何内容,以及通过自定义导入器加载的大多数样式表。
静默特定弃用静默特定弃用永久链接
如果您知道某个特定的弃用对您来说不是问题,您可以使用命令行上的--silence-deprecation
标志或 JavaScript API 中的silenceDeprecations
选项静默该特定弃用的警告。