postcss-html
TypeScript icon, indicating that this package has built-in type declarations

0.3.0 • Public • Published

PostCSS HTML Syntax

NPM version Travis Coverage Status

PostCSS Syntax for parsing HTML

vue component compatible

Getting Started

First thing's first, install the module:

npm install postcss-html --save-dev

If you want support SCSS/SASS/LESS/SugarSS syntaxh, you need to install the corresponding module.

Use Cases

var syntax = require('postcss-html');
postcss(plugins).process(source, { syntax: syntax }).then(function (result) {
	// An alias for the result.css property. Use it with syntaxes that generate non-CSS output.
	result.content
});

Style Transformations

The main use case of this plugin is to apply PostCSS transformations directly to HTML source code. For example, if you ship a theme written in style tag in HTML and need Autoprefixer to add the appropriate vendor prefixes to it; or you need to lint style source in HTML with a plugin such as Stylelint.

Inferring the syntax of style file

When passing a non-HTML file, this plugin will infer the syntax by file extension, and fallback by standard CSS syntax.

Custom unknown syntax

var syntax = require('postcss-html');
postcss(plugins).process(html, {
	syntax: syntax((opts, lang) => {
		if ('stylus' === lang) {
			// Custom syntax by attribute of <style> tag
			return require('postcss-stylus')
		} else if (/\.styl$/.test(opts.from)) {
			// Custom syntax by file extension
			return require('postcss-stylus')
		}
	})
}).then(function (result) {
	result.content
});

Package Sidebar

Install

npm i postcss-html@0.3.0

Version

0.3.0

License

MIT

Last publish

Collaborators

  • jeddy3
  • ai
  • gucong
  • ota-meshi