mirror of
https://github.com/danog/sass-site.git
synced 2024-12-11 17:09:52 +01:00
f80aa04469
This merges the color-units and random-with-units deprecation pages into a single shared function-units page, updates the color-units deprecations to reflect that Phase 2 has been enacted, and adds new function unit deprecations. See #511 See sass/sass#2904 See #662 See sass/sass#3374
43 lines
1.9 KiB
Plaintext
43 lines
1.9 KiB
Plaintext
---
|
|
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:
|
|
|
|
* [Functions are stricter about which units they
|
|
allow](breaking-changes/function-units) beginning in Dart Sass 1.32.0.
|
|
|
|
* [Selectors with invalid combinators are
|
|
invalid](breaking-changes/bogus-combinators) beginning in Dart Sass 1.54.0.
|
|
|
|
* [`/` is changing from a division operation to a list
|
|
separator](breaking-changes/slash-div) beginning in Dart Sass 1.33.0.
|
|
|
|
* [Parsing the special syntax of `@-moz-document` will be
|
|
invalid](breaking-changes/moz-document) beginning in Dart Sass 1.7.2.
|
|
|
|
* [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.
|