npm i -D css-loaderThe css-loader interprets @import and url() as ES Modules import/require()
resolves them
Good loaders for requiring your assets are the file-loader and the url-loader which you should specify in your config (see below)
file.js
import css from 'file.css';webpack.config.js
module.exports = {
module: {
rules: [
{
test: /\.css$/,
use: [ 'style-loader', 'css-loader' ]
}
]
}
}You can also use the css-loader results directly as string, such as in Angular's component style.
webpack.config.js
{
test: /\.css$/,
use: [
'to-string-loader',
'css-loader'
]
}or
const css = require('./test.css').toString();
console.log(css); // {String}If there are SourceMaps, they will also be included in the result string.
If, for one reason or another, you need to extract CSS as a plain string resource (i.e. not wrapped in a JS module) you might want to check out the extract-loader. It's useful when you, for instance, need to post process the CSS as a string.
webpack.config.js
{
test: /\.css$/,
use: [
'handlebars-loader', // handlebars loader expects raw resource string
'extract-loader',
'css-loader'
]
}| Name | Type | Default | Description |
|---|---|---|---|
url |
{Boolean} |
true |
Enable/Disable url() resolving |
import |
{Boolean} |
true |
Enable/Disable @import resolving |
minimize |
{Boolean} |
false |
Enable/Disable Minification |
sourceMap |
{Boolean} |
false |
Enable/Disable Source Maps |
To disable url() resolving by css-loader set the option to false
.selector {
declaration: url(./path/to/image.png);
}import CSS__URL__0 from './path/to/image.png';
export default `
.selector {
declaration: url(${CSS__URL__0});
}
`To disable url() resolving by css-loader set the option to false
webpack.config.js
{
loader: 'css-loader',
options: {
url: false
}
}@import './path/to/import.css';import CSS__IMPORT__0 from './path/to/import.css';
export default `
.css {
color: red;
}
`To disable @import resolving by css-loader set the option to false
webpack.config.js
{
loader: 'css-loader',
options: {
import: false
}
}webpack.config.js
{
loader: 'css-loader',
options: {
minimize: true
}
}
⚠️ They are not enabled by default because they expose a runtime overhead and increase in bundle size (JS source maps do not). In addition to that relative paths are buggy and you need to use an absolute public path which includes the server URL.
webpack.config.js
{
loader: 'css-loader',
options: {
sourceMap: true
}
}The following webpack.config.js can load CSS files, embed small PNG/JPG/GIF/SVG images as well as fonts as Data URLs and copy larger files to the output directory.
webpack.config.js
module.exports = {
module: {
rules: [
{
test: /\.css$/,
use: [ 'style-loader', 'css-loader' ]
},
{
test: /\.(png|jpg|gif|svg|eot|ttf|woff|woff2)$/,
loader: 'url-loader',
options: {
limit: 10000
}
}
]
}
}For production builds it's recommended to extract the CSS from your bundle being able to use parallel loading of CSS/JS resources later on. This can be achieved by using the extract-text-webpack-plugin to extract the CSS when running in production mode.
webpack.config.js
const env = process.env.NODE_ENV
const ExtractTextPlugin = require('extract-text-webpack-plugin')
module.exports = {
module: {
rules: [
{
test: /\.css$/,
use: env === 'production'
? ExtractTextPlugin.extract({
fallback: 'style-loader',
use: [ 'css-loader' ]
})
: [ 'style-loader', 'css-loader' ]
},
]
},
plugins: env === 'production'
? [
new ExtractTextPlugin({
filename: '[name].css'
})
]
: []
}
Juho Vepsäläinen |
Joshua Wiens |
Michael Ciniawsky |
Alexander Krasnoyarov |
