重大变更：以 – 开头的函数和混合器
在 Dart Sass 1.76.0 之前，函数和混合器名称可以是任何有效的 CSS 标识符，但现在以 -- 开头的标识符已被弃用。
通常，Sass 允许对任何 Sass 定义使用任何有效的 CSS 标识符。这包括以 -- 开头的标识符，用户可能最熟悉的是在 CSS 自定义属性 的上下文中。然而，CSS 工作组正在认真考虑为 CSS 本身添加内置的函数和混合器支持，可能使用类似 Sass 的名为 @mixin 和 @function 的 at 规则。
这意味着 Sass 为了在保持其 CSS 兼容性的核心设计原则的同时仍支持 Sass 的构建时函数和混合器，需要能够区分使用相同 at 规则名称的 CSS 和 Sass 声明。幸运的是，尽管 CSS 用于函数和混合器的语法细节仍然悬而未决，但有一点似乎是无争议的：对于 CSS 混合器和函数名称，使用以 -- 开头的类似自定义属性的标识符。
这将允许 Sass 将纯 CSS 函数和混合器识别为以 -- 开头的函数和混合器。但为了使这一点能够起作用，我们首先必须禁止 Sass 函数和混合器使用该前缀。
过渡期过渡期 permalink
- Dart Sass
- since 1.76.0
- LibSass
- ✗
- Ruby Sass
- ✗
在 Dart Sass 1.76.0 和 Dart Sass 2.0.0 之间，Dart Sass 将继续允许名称以 -- 开头的函数和混合器。但是，它将发出名为 css-function-mixin 的弃用警告。
在 Dart Sass 2.0.0 和 Dart Sass 对纯 CSS 函数和混合器的支持发布之间，不允许函数和混合器具有以 -- 开头的名称。
Can I Silence the Warnings?Can I Silence the Warnings? permalink
Sass provides a powerful suite of options for managing which deprecation warnings you see and when.
Terse and Verbose ModeTerse and Verbose Mode permalink
By default, Sass runs in terse mode, where it will only print each type of deprecation warning five times before it silences additional warnings. This helps ensure that users know when they need to be aware of an upcoming breaking change without creating an overwhelming amount of console noise.
If you run Sass in verbose mode instead, it will print every deprecation
warning it encounters. This can be useful for tracking the remaining work to be
done when fixing deprecations. You can enable verbose mode using
the --verbose flag on the command line, or
the verbose option in the JavaScript API.
⚠️ Heads up!
When running from the JS API, Sass doesn’t share any information across
compilations, so by default it’ll print five warnings for each stylesheet
that’s compiled. However, you can fix this by writing (or asking the author of
your favorite framework’s Sass plugin to write) a custom Logger that only
prints five errors per deprecation and can be shared across multiple compilations.
Silencing Deprecations in DependenciesSilencing Deprecations in Dependencies permalink
Sometimes, your dependencies have deprecation warnings that you can’t do
anything about. You can silence deprecation warnings from dependencies while
still printing them for your app using
the --quiet-deps flag on the command line, or
the quietDeps option in the JavaScript API.
For the purposes of this flag, a "dependency" is any stylesheet that’s not just a series of relative loads from the entrypoint stylesheet. This means anything that comes from a load path, and most stylesheets loaded through custom importers.
Silencing Specific DeprecationsSilencing Specific Deprecations permalink
If you know that one particular deprecation isn’t a problem for you, you can
silence warnings for that specific deprecation using
the --silence-deprecation flag on the command line, or
the silenceDeprecations option in the JavaScript API.