README
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 ismodule
: the plugin module itself, andoptions
: 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 passedresult, 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
/* Brocfile.js */
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;