PostCSS plugin for splitting css into multiple css files with sourcemaps support for preventing limitation of shinny ie9
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.editorconfig
.eslintrc
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
gulpfile.js
index.js
package.json

README.md

PostCSS eSplit Build Status

PostCSS plugin for splitting css into multiple css files with sourcemaps support for preventing limitation of shinny ie9.

/* Input example - style.css */
@charset "UTF-8";

.someClass {
    display: block;
}

@media (max-width: 768px) {
    p {
        color: red;
    }

    em {
        color: blue;
    }
}
/* 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

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