rollup-plugin-postcss
Advanced tools
rollup-plugin-postcss is a Rollup plugin that allows you to import and process CSS files with PostCSS. It supports various PostCSS plugins, CSS modules, and can even extract CSS into separate files.
Importing CSS
This feature allows you to import CSS files directly into your JavaScript or TypeScript files. The imported styles can then be used within your components.
import styles from './styles.css';Using PostCSS Plugins
This feature allows you to use PostCSS plugins like autoprefixer to process your CSS. The example demonstrates how to configure the plugin to use autoprefixer.
import postcss from 'rollup-plugin-postcss';
import autoprefixer from 'autoprefixer';
export default {
input: 'src/index.js',
output: {
file: 'dist/bundle.js',
format: 'cjs'
},
plugins: [
postcss({
plugins: [
autoprefixer()
]
})
]
};Extracting CSS
This feature allows you to extract CSS into a separate file instead of including it in the JavaScript bundle. The example shows how to configure the plugin to extract CSS.
import postcss from 'rollup-plugin-postcss';
export default {
input: 'src/index.js',
output: {
file: 'dist/bundle.js',
format: 'cjs'
},
plugins: [
postcss({
extract: true
})
]
};CSS Modules
This feature allows you to use CSS Modules, which scope CSS by automatically creating unique class names. The example demonstrates how to enable CSS Modules in the plugin configuration.
import postcss from 'rollup-plugin-postcss';
export default {
input: 'src/index.js',
output: {
file: 'dist/bundle.js',
format: 'cjs'
},
plugins: [
postcss({
modules: true
})
]
};rollup-plugin-css-only is a Rollup plugin that allows you to import CSS files and extract them into a separate file. Unlike rollup-plugin-postcss, it does not support PostCSS plugins or CSS Modules.
rollup-plugin-sass is a Rollup plugin that allows you to import and compile Sass/SCSS files. It supports extracting CSS into separate files and can be used in conjunction with PostCSS plugins. However, it is specifically designed for Sass/SCSS rather than general CSS processing.
rollup-plugin-styles is a versatile Rollup plugin that supports importing and processing CSS, Sass, Less, and Stylus files. It also supports PostCSS plugins and CSS Modules, making it a more comprehensive solution compared to rollup-plugin-postcss.
Seamless integration between Rollup and PostCSS.
You are viewing the docs for v1.0, for v0.5 please see here.
import postcss from 'rollup-plugin-postcss'
export default {
plugins: [
postcss()
]
}
postcss({
extract: true
})
postcss({
modules: true,
// Or with custom options for `postcss-modules`
modules: {}
})
First add relevant dependency:
yarn add node-sass --dev
# Now you can import `.sass` and `.scss` files in your library
Then enable it in the plugin:
postcss({
use: [
['sass', {/* optional sass options */}]
]
})
Type: boolean object
Default: true
Inject CSS into <head>, it's always false when extract: true.
You can also use it as options for style-inject.
Type: boolean
Default: false
Extract CSS into its own file.
Type: boolean object
Default: false
Enable CSS modules or set options for postcss-modules.
Type: boolean
Default: false
Use named exports alongside default export.
When importing specific classNames, the following will happen:
$ sign wrapped underlines, eg. -- => $__$$ signs, eg. switch => $switch$All transformed names will be logged in your terminal like:
Exported "new" as "$new$" in test/fixtures/named-exports/style.css
The original will not be removed, it's still available on default export:
import style, { class$_$name, class$__$name, $switch$ } from './style.css';
console.log(style['class-name'] === class$_$name) // true
console.log(style['class--name'] === class$__$name) // true
console.log(style['switch'] === $switch$) // true
Type: boolean object
Default: false
Minimize CSS, boolean or options for cssnano.
Type: boolean "inline"
Enable sourceMap.
Type: string function
PostCSS parser, like sugarss.
Type: boolean object
Default: true
Load PostCSS config file.
Type: string
The path to config file, so that we can skip searching.
Type: object
ctx argument for PostCSS config file.
Type: name[] [name, options][]
Use a loader, currently built-in loaders are:
sass (Support .scss and .sass)stylus (TODO)less (TODO)Type: Loader[]
An array of custom loaders.
interface Loader {
name: string,
test: RegExp,
process: (this: Context, input: Payload) => Promise<Payload> | Payload
}
interface Context {
/** Loader options */
options: any
/** Sourcemap */
sourceMap: any
/** Resource path */
id: string
}
interface Payload {
/** File content */
code: string
/** Sourcemap */
map?: string | SourceMap
}
Type: id => void
A function to be invoked when an import for CSS file is detected.
MIT © EGOIST
FAQs
Seamless integration between Rollup and PostCSS
The npm package rollup-plugin-postcss receives a total of 607,704 weekly downloads. As such, rollup-plugin-postcss popularity was classified as popular.
We found that rollup-plugin-postcss demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
cURL and Go security teams are publicly rejecting CVSS as flawed for assessing vulnerabilities and are calling for more accurate, context-aware approaches.
Security News
Bun 1.2 enhances its JavaScript runtime with 90% Node.js compatibility, built-in S3 and Postgres support, HTML Imports, and faster, cloud-first performance.
Security News
Biden's executive order pushes for AI-driven cybersecurity, software supply chain transparency, and stronger protections for federal and open source systems.