Breaking Change: Funktionen und Mixins, die mit – beginnen

Vor Dart Sass 1.76.0 konnten Funktions- und Mixin-Namen beliebige gültige CSS-Bezeichner sein, aber Bezeichner, die mit -- beginnen, sind jetzt veraltet.

Im Allgemeinen erlaubt Sass jedem gültigen CSS-Bezeichner, für jede Sass-Definition verwendet zu werden. Dazu gehören Bezeichner, die mit -- beginnen, was Benutzer am ehesten im Kontext von CSS-Custom Properties kennen. Die CSS-Arbeitsgruppe erwägt jedoch ernsthaft die Hinzufügung nativer Unterstützung für Funktionen und Mixins in CSS selbst, wahrscheinlich unter Verwendung von At-Rules namens @mixin und @function, genau wie Sass.

Das bedeutet, dass Sass, um seinen Kernprinzip des CSS-Kompatibilität zu wahren und gleichzeitig die Build-Zeit-Funktionen und Mixins von Sass zu unterstützen, zwischen CSS- und Sass-Deklarationen unterscheiden können muss, die dieselben At-Rule-Namen verwenden. Glücklicherweise, obwohl die Details der Syntax, die CSS für Funktionen und Mixins verwendet, noch sehr unklar sind, scheint ein Punkt unumstritten zu sein: die Verwendung von Custom-Property-ähnlichen Bezeichnern, die mit -- beginnen, für CSS-Mixin- und Funktionsnamen .

Dies ermöglicht Sass, reine CSS-Funktionen und Mixins als diejenigen zu unterscheiden, die mit -- beginnen. Aber damit dies funktioniert, müssen wir Sass-Funktionen und Mixins zuerst die Verwendung dieses Präfixes verbieten.

ÜbergangszeitraumÜbergangszeitraum Permalink

Dart Sass: seit 1.76.0
LibSass: ✗
Ruby Sass: ✗

Zwischen Dart Sass 1.76.0 und Dart Sass 2.0.0 wird Dart Sass weiterhin Funktionen und Mixins erlauben, deren Namen mit -- beginnen. Es wird jedoch eine Deprecation-Warnung namens css-function-mixin ausgeben.

Zwischen Dart Sass 2.0.0 und der Veröffentlichung der Unterstützung von Dart Sass für reine CSS-Funktionen und Mixins dürfen Funktionen und Mixins keine Namen haben, die mit -- beginnen.

Kann ich die Warnungen unterdrücken?

Sass bietet eine leistungsstarke Reihe von Optionen zur Verwaltung, welche Deprecations-Warnungen Sie wann sehen.

Terse- und Verbose-Modus

Standardmäßig läuft Sass im Terse-Modus, in dem jede Art von Deprecations-Warnung nur fünfmal ausgegeben wird, bevor weitere Warnungen unterdrückt werden. Dies stellt sicher, dass die Benutzer wissen, wann sie sich einer bevorstehenden Breaking Change bewusst sein müssen, ohne eine überwältigende Menge an Konsolenrauschen zu erzeugen.

Wenn Sie stattdessen Sass im Verbose-Modus ausführen, wird jede Deprecations-Warnung ausgegeben. Dies kann nützlich sein, um die verbleibende Arbeit bei der Behebung von Deprecations zu verfolgen. Sie können den Verbose-Modus mit dem Flag --verbose in der Befehlszeile oder der Option verbose in der JavaScript API aktivieren.

⚠️ Vorsicht!

Wenn Sass über die JS API ausgeführt wird, teilt Sass keine Informationen über Kompilierungen hinweg. Daher werden standardmäßig fünf Warnungen für *jedes kompilierte Stylesheet* ausgegeben. Sie können dies jedoch beheben, indem Sie einen benutzerdefinierten Logger schreiben (oder den Autor Ihres bevorzugten Frameworks dazu auffordern, dies zu tun), der nur fünf Fehler pro Deprecation ausgibt und über mehrere Kompilierungen hinweg geteilt werden kann.

Deprecations in Abhängigkeiten unterdrücken

Manchmal haben Ihre Abhängigkeiten Deprecations-Warnungen, auf die Sie keinen Einfluss haben. Sie können Deprecations-Warnungen von Abhängigkeiten unterdrücken, während sie für Ihre Anwendung weiterhin ausgegeben werden, indem Sie das Flag --quiet-deps in der Befehlszeile oder die Option quietDeps in der JavaScript API verwenden.

Für die Zwecke dieses Flags ist eine "Abhängigkeit" jedes Stylesheet, das keine reine Serie relativer Ladevorgänge vom Einstiegs-Stylesheet ist. Das bedeutet alles, was von einem Lade-Pfad kommt, und die meisten Stylesheets, die über benutzerdefinierte Importer geladen werden.

Spezifische Deprecations unterdrücken

Wenn Sie wissen, dass eine bestimmte Deprecation für Sie kein Problem darstellt, können Sie Warnungen für diese spezifische Deprecation unterdrücken, indem Sie das Flag --silence-deprecation in der Befehlszeile oder die Option silenceDeprecations in der JavaScript API verwenden.