postcss-load-plugins

WebJar for postcss-load-plugins

License	MIT
GroupId	org.webjars.npm
ArtifactId	postcss-load-plugins
Last Version	2.3.0
Release Date	May 8, 2017
Type	jar
Description	postcss-load-plugins WebJar for postcss-load-plugins
Project URL	http://webjars.org
Source Code Management	https://github.com/michael-ciniawsky/postcss-load-plugins

Download postcss-load-plugins

Filename	Size
postcss-load-plugins-2.3.0.pom
postcss-load-plugins-2.3.0.jar	8 KB
postcss-load-plugins-2.3.0-sources.jar	22 bytes
postcss-load-plugins-2.3.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/postcss-load-plugins/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>postcss-load-plugins</artifactId>
    <version>2.3.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/postcss-load-plugins/
implementation 'org.webjars.npm:postcss-load-plugins:2.3.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/postcss-load-plugins/
implementation ("org.webjars.npm:postcss-load-plugins:2.3.0")

Apache Buildr

'org.webjars.npm:postcss-load-plugins:jar:2.3.0'

Apache Ivy

<dependency org="org.webjars.npm" name="postcss-load-plugins" rev="2.3.0">
  <artifact name="postcss-load-plugins" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='postcss-load-plugins', version='2.3.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "postcss-load-plugins" % "2.3.0"

Leiningen

[org.webjars.npm/postcss-load-plugins "2.3.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.webjars.npm : cosmiconfig	jar	[2.1.1,3)
org.webjars.npm : object-assign	jar	[4.1.0,5)

Project Modules

There are no modules declared in this project.

Load Plugins

Install

npm i -D postcss-load-plugins

Usage

npm i -S|-D postcss-plugin

Install plugins and save them to your package.json dependencies/devDependencies.

package.json

Create postcss section in your projects package.json.

App
  |– client
  |– public
  |
  |- package.json

{
  "postcss": {
    "plugins": {
      "postcss-plugin": {}
    }
  }
}

.postcssrc

Create a .postcssrc file.

App
  |– client
  |– public
  |
  |- (.postcssrc|.postcssrc.json|.postcssrc.yaml)
  |- package.json

JSON

{
  "plugins": {
    "postcss-plugin": {}
  }
}

YAML

plugins:
  postcss-plugin: {}

postcss.config.js or .postcssrc.js

You may need some JavaScript logic to generate your config. For this case you can use a file named postcss.config.js or .postcssrc.js.

App
  |– client
  |– public
  |
  |- (postcss.config.js|.postcssrc.js)
  |- package.json

Plugins can be loaded in either using an {Object} or an {Array}.

{Object}

module.exports = (ctx) => ({
  plugins: {
    'postcss-plugin': ctx.plugin
  }
})

{Array}

module.exports = (ctx) => ({
  plugins: [
    require('postcss-plugin')(ctx.plugin)
  ]
})

Options

Plugin options can take the following values.

{}: Plugin loads with defaults

'postcss-plugin': {} || null

⚠️ {} must be an empty object

{Object}: Plugin loads with options

'postcss-plugin': { option: '', option: '' }

false: Plugin will not be loaded

'postcss-plugin': false

Order

Plugin order is determined by declaration in the plugins section.

{
  plugins: {
    'postcss-plugin': {}, // plugins[0]
    'postcss-plugin': {}, // plugins[1]
    'postcss-plugin': {}  // plugins[2]
  }
}

Context

When using a function (postcss.config.js), it is possible to pass context to postcss-load-plugins, which will be evaluated before loading your plugins. By default ctx.env (process.env.NODE_ENV) and ctx.cwd (process.cwd()) are available.

Examples

postcss.config.js

module.exports = (ctx) => ({
  plugins: {
    postcss-import: {},
    postcss-modules: ctx.modules ? {} : false,
    cssnano: ctx.env === 'production' ? {} : false
  }
})

const { readFileSync } = require('fs')

const postcss = require('postcss')
const pluginsrc = require('postcss-load-plugins')

const css = readFileSync('index.css', 'utf8')

const ctx = { modules: true }

pluginsrc(ctx).then((plugins) => {
  postcss(plugins)
    .process(css)
    .then((result) => console.log(result.css))
})

Maintainers

Michael Ciniawsky

Mateusz Derks

Contributors

Diogo Franco

Versions

Version
2.3.0 May 8, 2017