broccoli-css-lang-optimizer

broccoli-css-lang-optimizer

This addon causes language specific rulesets in CSS to be extracted into per-language css files. The original CSS file has the language specific rulesets removed from it.

This plugin uses postcss-lang-optimizer and adapts it for use in Broccoli projects.

API

In your Brocfile.js:

var LangOptimizer = require("broccoli-css-lang-optimizer");
var inputNodes = ["static/css"]; // or wherever you put your CSS files.
var options = { }; // Options for the plugin. See below.
module.exports = new LangOptimizer(inputNodes, options);

Options

You can pass options to this plugin to control its behavior.

{
  // includeBaseFile controls whether the base css is included
  // in every language-specific output file. When set to `false`,
  // only the lang-specific selectors are output to the language
  // specific file. Defaults to `true`.
  includeBaseFile: true,
  // filenameForLang is optional, when omited the filename is "<basename>_<lang>.css"
  filenameForLang: function(baseFilename, lang) {
    return baseFilename.replace(".css", "-" + lang + ".css");
  },
  // Passed along to the underlying postcss-lang-optimizer plugin.  Defaults to false.
  subtags: false,
  // Ensures a file is written for each of these languages (and only these languages)
  // even if they are or are not specified in the source CSS.
  // If omitted, languages are discovered from the source CSS file.
  // This property can also be set to a function that returns an array of langs.
  langs: ["en", "de", "zh"],
  // The folowing langs will be RTL processed with rtlcss. Highly
  // recommend not setting `includeBaseFile` to `false` when using rtl flipping.
  rtlLangs: ["ar", "he"],
  // The following options will be passed to the rtlcss plugin:
  rtlOptions: { }
}