gulp-scss2less
v1.0.0
Published
Gulp plugin wrapping less-plugin-sass2less
Downloads
22
Readme
gulp-scss2less
Gulp plugin wrapping less-plugin-sass2less
There are several other similar projects, but less-plugin-sass2less was the most robust one I could find.
Usage example
const scss2less = require('gulp-scss2less');
gulp.task('scss2less', () => {
gulp.src('src/scss/**/*.scss')
.pipe(scss2less())
.pipe(gulp.dest('dist/less'));
});
Caveats (mainly the same as less-plugin-sass2less)
- Keep it simple. less-plugin-sass2less is converting line by line with regex rather than using AST transformation (like for example gonzales-pe), but due to similarities between LESS and SCSS this still works very well. You'll likely have to "dumben down" your SCSS a little, or it won't be possible to transpile due to features in SCSS that are not supported by LESS.
@elseif
,@extend
and@function
cannot be converted, and are hence not supported.@function
can be supported experimentally by passing{customFunctions: true}
as an optional parameter forscss2less
. This will require you to also use less-plugin-functions though (or if you're building a library, everyone using it would).- !default attributes: Variables with the same name will not be ignored like in SASS. The most recent takes precedence over the previous one.
- @import statements: less-plugin-sass2less converts import statements to optional in order to support how SASS handles partials (file names with leading underscore). In effect, missing files and files with LESS errors will be ignored rather than the transpilation failing.