PostCSS Syntax

postcss-syntax can automatically switch the required PostCSS syntax by file extension/source

Getting Started

First thing's first, install the module:

npm install postcss-syntax --save-dev

If you want support SCSS/SASS/LESS/SugarSS syntax, you need to install these module:

• SCSS: postcss-scss
• SASS: postcss-sass
• LESS: postcss-less
• SugarSS: sugarss

If you want support HTML (and HTML-like)/Markdown/CSS-in-JS file format, you need to install these module:

• CSS-in-JS: postcss-jsx
• HTML (and HTML-like): postcss-html
• Markdown: postcss-markdown

Use Cases

1const postcss = require('postcss');
2const syntax = require('postcss-syntax')({
3	rules: [
4		{
5			test: /\.(?:[sx]?html?|[sx]ht|vue|ux|php)$/i,
6			extract: 'html',
7		},
8		{
9			test: /\.(?:markdown|md)$/i,
10			extract: 'markdown',
11		},
12		{
13			test: /\.(?:[cm]?[jt]sx?|es\d*|pac)$/i,
14			extract: 'jsx',
15		},
16		{
17			// custom language for file extension
18			test: /\.postcss$/i,
19			lang: 'scss'
20		},
21		{
22			// custom language for file extension
23			test: /\.customcss$/i,
24			lang: 'custom'
25		},
26	],
27
28	// custom parser for CSS (using `postcss-safe-parser`)
29	css: 'postcss-safe-parser',
30	// custom parser for SASS (PostCSS-compatible syntax.)
31	sass: require('postcss-sass'),
32	// custom parser for SCSS (by module name)
33	scss: 'postcss-scss',
34	// custom parser for LESS (by module path)
35	less: './node_modules/postcss-less',
36	// custom parser for SugarSS
37	sugarss: require('sugarss'),
38	// custom parser for custom language
39	custom: require('postcss-custom-syntax'),
40
41});
42postcss(plugins).process(source, { syntax: syntax }).then(function (result) {
43	// An alias for the result.css property. Use it with syntaxes that generate non-CSS output.
44	result.content
45});