https://github.com/vitaliyr/postcss-esplit
PostCSS plugin for splitting css into multiple css files with sourcemaps support for preventing limitation of shinny ie9
https://github.com/vitaliyr/postcss-esplit
postcss
Last synced: about 1 year ago
JSON representation
PostCSS plugin for splitting css into multiple css files with sourcemaps support for preventing limitation of shinny ie9
- Host: GitHub
- URL: https://github.com/vitaliyr/postcss-esplit
- Owner: VitaliyR
- License: mit
- Created: 2015-11-11T15:32:57.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-04-05T11:47:30.000Z (about 9 years ago)
- Last Synced: 2025-03-21T21:44:48.562Z (over 1 year ago)
- Topics: postcss
- Language: JavaScript
- Size: 37.1 KB
- Stars: 8
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# PostCSS eSplit [![Build Status][ci-img]][ci]
[PostCSS] plugin for splitting css into multiple css files with sourcemaps support for preventing limitation of shinny ie9.
[PostCSS]: https://github.com/postcss/postcss
[ci-img]: https://travis-ci.org/VitaliyR/postcss-esplit.svg?branch=master
[ci]: https://travis-ci.org/VitaliyR/postcss-esplit
```css
/* Input example - style.css */
@charset "UTF-8";
.someClass {
display: block;
}
@media (max-width: 768px) {
p {
color: red;
}
em {
color: blue;
}
}
```
```css
/* Output example with maxSelectors = 2 */
/* style.css */
@charset "UTF-8";
@import url(style-0.css);
@media (max-width: 768px) {
em {
color: blue;
}
}
/* style-0.css */
.someClass {
display: block;
}
@media (max-width: 768px) {
p {
color: red;
}
}
```
## Install
```
npm install postcss-esplit --save
```
## Usage
```js
postcss([ require('postcss-esplit')(/*opts*/) ])
```
See [PostCSS] docs for examples for your environment.
Also, starting from version 0.0.2 there are no need to place the plugin in the end of the
processor plugins list.
## Options
* `maxSelectors` *{number=4000}* count of selectors exceeding which css file should be separated
* `fileName` *{string=%original%-%i%}* template for retrieving name of separated files
* `%original%` *{string}* name of original file
* `%i%` *{number}* index of separated file
* `fileNameStartIndex` *{number=0}* separated files will receive generated name starting from this index
* `writeFiles` *{boolean=true}* separated files should be written to the disk
* `writeSourceMaps` *{boolean=true}* source maps of separated files should be written to the disk
* `writeImport` *{boolean=true}* original css source should have import declaration for separated files
* `quiet` *{boolean-false}* toggling console output