.. | ||
lib | ||
CHANGELOG.md | ||
LICENSE | ||
package.json | ||
README.md |
PostCSS SCSS Syntax ![Build Status](https://img.shields.io/travis/postcss/postcss-scss.svg)
This module does not compile SCSS. It simply parses mixins as custom at-rules & variables as properties, so that PostCSS plugins can then transform SCSS source code alongside CSS.
Install
npm --save install postcss-scss
or (if you use Yarn)
yarn add --dev postcss-scss
Usage
There are two ways to use this parser:
1. SCSS Transformations
The main use case of this plugin is to apply PostCSS transformations directly to SCSS source code.
For example, you can lint SCSS source with Stylelint and linter will automatically fix issues in the source.
// postcss.config.js
module.exports = {
syntax: 'postcss-scss',
plugins: {
…
}
}
2. Inline Comments for PostCSS
Also you can use this parser just to add //
single-line comment
to your PostCSS project (without any Sass):
:root {
// Main theme color
--color: red;
}
Note that you don’t need a special stringifier to handle the output; the default one will automatically convert single line comments into block comments.
// postcss.config.js
module.exports = {
parser: 'postcss-scss',
plugins: {
…
}
}
If you want Sass behaviour with removing inline comments, you can use postcss-strip-inline-comments plugin.