Rework Importer
Rework plugin for allowing CSS files to import other CSS files.
Usage
To properly use the import plugin you should make sure it's the first you call use on. This allows your other plugins to do their work on the imported CSS.
var rework = require('rework');
var imprt = require('rework-importer');
var fs = require('fs');
// Not recommended way of loading styles...
rework(fs.readFileSync('style.css'), 'utf-8')
.use(imprt(opts)) // opts described below
.use(another-plugin)
.use(another-plugin)
.toString();
Many imports in one block.
style.css
@import {
file: myFirstCSSFile.css;
file: mySecondCSSFile.css
}
myFirstCSSFile.css
body {
background: #000;
}
myFirstCSSFile.css
h1 {
font-size: 200px;
}
Resulting CSS
body {
background: #000;
}
h1 {
font-size: 200px;
}
Or with "native" @import
-syntax:
style.css
@import url('foobar.css');
body {
background: #000;
}
foobar.css
* { box-sizing: border-box; }
Resulting CSS
* {
box-sizing: border-box;
}
body {
background: #000;
}
Options
Available options are:
- path, required option. Path to the base directory, all imports will be relative to this path.
- whitespace, set to true if you want to use significant whitespace in your imported files.
- encoding, if your CSS is anything other then UTF-8 encoded.
Known issues
- Imports currently, probably, only work at the "top level" stylesheet. Not
inside
@keyframes
or@media
declarations.`
License
MIT