What does a `~` tilde in a CSS `url()` do?
Solution 1:
The CSS @import
path <url>
is usually relative to the current working directory.
So using the prefix ~
at the start of the path tells Webpack's css-loader to resolve the import "like a module", starting from the node_modules
directory.
What that means is that if you have a node module called normalize
installed, and you need to import a css file from within it named /normalize.css
, you can do that with:
@import "~normalize/normalize.css";
In your linked example, inside font-loader/example/test.js
there is an import of a module called font-boon
.
var boon = require('./font-boon');
Inside of font-loader/example/test.css
the font-boon module is @imported so that it is available in text.css
.
@import url("~./font-boon");
Solution 2:
UPDATE March 2021
From sass-loader tilde '~' imports are deprecated and is recommended to be removed.
Solution 3:
Using an @import statement assumes you're importing from the node_modules folder. So for example if you're trying to import bootstrap.css, you'd use
@import "~bootstrap/dist/css/bootstrap.css"
That is, you're putting the path relative to the node_modules folder.