重大更改:-moz-document

Firefox 过去有一个 @-moz-document 规则需要特殊解析。随着 Firefox 移除对该规则的支持,Sass 正在逐步移除对解析这些规则的支持。

Sass 历史上支持对 @-moz-document 规则进行特殊解析。由于Firefox 已停止对它们的 支持,Sass 也将停止支持特殊解析,并将将其视为未知的 at-规则。

有一个例外:空 url 前缀函数仍然允许,因为这用于针对 Firefox 的 hack。

游乐场

SCSS 语法

@-moz-document url-prefix() {
  .error {
    color: red;
  }
}
游乐场

Sass 语法

@-moz-document url-prefix()
  .error
    color: red


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 选项静默该特定弃用的警告。