README.md
2.92 KB
PostCSS Font Format
PostCSS Font Format Keywords lets you specify font formats as keywords, following the CSS Fonts specification.
@font-face {
src: url(file.woff2) format(woff2);
}
/* becomes */
@font-face {
src: url(file.woff2) format("woff2");
}
See prior work by valtlai here postcss-font-format-keywords To ensure long term maintenance and to provide the needed features this plugin was recreated based on valtlai's work.
Usage
Add PostCSS Font Format Keywords to your project:
npm install postcss @csstools/postcss-font-format-keywords --save-dev
Use it as a PostCSS plugin:
const postcss = require('postcss');
const postcssFontFormatKeywords = require('@csstools/postcss-font-format-keywords');
postcss([
postcssFontFormatKeywords(/* pluginOptions */)
]).process(YOUR_CSS /*, processOptions */);
PostCSS Font Format Keywords runs in all Node environments, with special instructions for:
Node | PostCSS CLI | Webpack | Create React App | Gulp | Grunt |
---|
Options
preserve
The preserve
option determines whether the original source
is preserved. By default, it is not preserved.
postcssFontFormatKeywords({ preserve: true })
@font-face {
src: url(file.woff2) format(woff2);
}
/* becomes */
@font-face {
src: url(file.woff2) format("woff2");
src: url(file.woff2) format(woff2);
}