broccoli-postcss-sourcemaps
The broccoli-postcss-sourcemaps plugin runs your css
through postcss plugins of your choosing.
This is a fork of broccoli-postcss
which adds support for sourcemaps and other 1-to-many css output scenarios.
Installation
npm install --save-dev broccoli-postcss-sourcemaps
Usage
var compileCSS = require('broccoli-postcss-sourcemaps');
var outputTree = compileCSS(inputTree, options);
inputTrees
: An array of trees that specify the directories used by Broccoli. If you have a single tree, pass [tree]
.
options
: Options for PostCSS. Additional options are specified
below.
Options not passed to PostCSS
plugins
An array of plugin objects to be used by PostCSS (a minimum of 1 plugin is required). The supported object format is module
: the plugin module itself, and options
: an object of supported options for the given plugin.
resultHandler
: A callback that is invoked after each file is
processed by PostCSS. This can be used to process the PostCSS
result messages or do other per-file operations. Note: the primary output
file has not yet been written to disk when this callback is invoked.
It is passed result, filter, relativePath, addOutputFile
.
result
: [Object] The PostCSS result object.
filter
: [Object] The Broccoli Multi Filter object.
relativePath
: [String] The relative path of the file being compiled.
addOutputFile
: [Function] A callback that can be used to register
additional output files with the Broccoli Multi Filter
Example
var compileCSS = require('broccoli-postcss-sourcemaps');
var cssnext = require('cssnext');
var options = {
plugins: [
{
module: cssnext,
options: {
browsers: ['last 2 version']
}
}
],
map: {
inline: false,
annotation: false
}
}
var outputTree = compileCSS(['styles'], options);
module.exports = outputTree;