README
postcss-font-family-fangsong
postcss-font-family-fangsong lets you use fangsong
in CSS, following the
CSS Fonts Module Level 4 specification.
body {
font: 16pt/28pt fangsong;
}
/* becomes */
body {
font: 16pt/28pt fangsong, STFangsong, FangSong, FangSong_GB2312;
}
Usage
Add postcss-font-family-fangsong to your build tool:
npm install postcss-font-family-fangsong --save-dev
PostCSS
Add PostCSS to your build tool:
npm install postcss --save-dev
Use postcss-font-family-fangsong as a plugin:
import postcss from "gulp-postcss";
import postcssFontFangsong from "postcss-font-family-fangsong";
postcss([postcssFontFangsong(/* options */)]).process(YOUR_CSS);
Gulp
Add Gulp PostCSS to your build tool:
npm install gulp-postcss --save-dev
Use postcss-font-family-fangsong in your Gulpfile:
import postcss from "gulp-postcss";
import postcssFontFangsong from "postcss-font-family-fangsong";
gulp.task("css", () =>
gulp
.src("./src/*.css")
.pipe(postcss([postcssFontFangsong(/* options */)]))
.pipe(gulp.dest("."))
);
Grunt
Add Grunt PostCSS to your build tool:
npm install grunt-postcss --save-dev
Use postcss-font-family-fangsong in your Gruntfile:
import postcssFontFangsong from "postcss-font-family-fangsong";
grunt.loadNpmTasks("grunt-postcss");
grunt.initConfig({
postcss: {
options: {
use: [postcssFontFangsong(/* options */)],
},
dist: {
src: "*.css",
},
},
});
Node
Use postcss-font-family-fangsong to process your CSS:
import postcssFontFangsong from "postcss-font-family-fangsong";
postcssFontFangsong.process(YOUR_CSS);
Options
family
The family: string | string[]
option defines the fallback families used to polyfill fangsong
.
It accepts an array or a comma-separated string.
import postcssFontFangsong from "postcss-font-family-fangsong";
postcssFontFangsong({
family: "fangsong, FangSong, FZFangSong-Z02, FandolFang",
});
preserve
The preserve: boolean
option controls whether fangsong
should be preserved in the transformed CSS output.
Its default value is true
postcssFontFangsong({
preserve: true, // preserve `fangsong` in the transpiled output
});
When both family
and preserve
are specified, preserve
is a no-op.