2019-06-04 13:57:17 +02:00
|
|
|
---
|
|
|
|
|
title: Breaking Changes
|
|
|
|
|
introduction: >
|
|
|
|
|
New versions of Sass are as backwards-compatible as possible, but sometimes
|
|
|
|
|
a breaking change is necessary. Sass needs to keep up with the evolving CSS
|
|
|
|
|
specification, and old language design mistakes occasionally need to be fixed.
|
|
|
|
|
overview: true
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Before each breaking change is released, Sass implementations will produce
|
|
|
|
|
deprecation warnings for stylesheets whose behavior will change. Whenever
|
|
|
|
|
possible, these warnings will include suggestions for how to update the
|
|
|
|
|
deprecated styles to make them forward-compatible.
|
|
|
|
|
|
|
|
|
|
Different implementations have different policies for breaking changes and
|
|
|
|
|
deprecations. [Dart Sass][] will emit deprecation warnings for at least three
|
|
|
|
|
months before releasing a breaking change, and will release the breaking change
|
|
|
|
|
with a new major version number **unless that change is necessary for CSS
|
|
|
|
|
compatibility**. CSS compatibility changes are often both non-disruptive and
|
|
|
|
|
time-sensitive, so they may be released with new minor version numbers instead.
|
|
|
|
|
|
|
|
|
|
[Dart Sass]: /dart-sass
|
|
|
|
|
|
|
|
|
|
These breaking changes are coming soon or have recently been released:
|
|
|
|
|
|
2022-10-29 01:35:58 +02:00
|
|
|
* [Functions are stricter about which units they
|
|
|
|
|
allow](breaking-changes/function-units) beginning in Dart Sass 1.32.0.
|
2022-08-18 04:25:23 +02:00
|
|
|
|
2022-10-29 01:35:58 +02:00
|
|
|
* [Selectors with invalid combinators are
|
2022-07-19 02:00:41 +02:00
|
|
|
invalid](breaking-changes/bogus-combinators) beginning in Dart Sass 1.54.0.
|
|
|
|
|
|
2021-05-18 04:09:58 +02:00
|
|
|
* [`/` is changing from a division operation to a list
|
|
|
|
|
separator](breaking-changes/slash-div) beginning in Dart Sass 1.33.0.
|
|
|
|
|
|
2022-09-07 19:55:14 +02:00
|
|
|
* [Parsing the special syntax of `@-moz-document` will be
|
|
|
|
|
invalid](breaking-changes/moz-document) beginning in Dart Sass 1.7.2.
|
|
|
|
|
|
2019-06-04 13:57:17 +02:00
|
|
|
* [Compound selectors could not be extended](breaking-changes/extend-compound)
|
|
|
|
|
in Dart Sass 1.0.0 and Ruby Sass 4.0.0.
|
|
|
|
|
|
|
|
|
|
* [The syntax for CSS custom property values changed](breaking-changes/css-vars)
|
|
|
|
|
in Dart Sass 1.0.0, LibSass 3.5.0, and Ruby Sass 3.5.0.
|
2023-03-10 23:24:55 +01:00
|
|
|
|
|
|
|
|
## Early Opt-In
|
|
|
|
|
|
|
|
|
|
Dart Sass users can opt in to treat deprecations as errors early using the
|
|
|
|
|
[`--fatal-deprecation` command line option](cli/dart-sass#fatal-deprecation).
|
