| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475 |
- # postcss-minify-font-values [![Build Status][ci-img]][ci]
- > Minify font declarations with PostCSS.
- This module will try to minimise the `font-family`, `font-weight` and `font` shorthand
- properties; it can unquote font families where necessary, detect & remove
- duplicates, and cut short a declaration after it finds a keyword. For more
- examples, see the [tests](test).
- ```css
- h1 {
- font:bold 2.2rem/.9 "Open Sans Condensed", sans-serif;
- }
- p {
- font-family: "Helvetica Neue", Arial, sans-serif, Helvetica;
- font-weight: normal;
- }
- ```
- ```css
- h1 {
- font:700 2.2rem/.9 Open Sans Condensed,sans-serif
- }
- p {
- font-family: Helvetica Neue,Arial,sans-serif;
- font-weight: 400;
- }
- ```
- ## API
- ### minifyFontValues([options])
- #### options
- ##### removeAfterKeyword
- Type: `boolean`
- Default: `true`
- Pass `false` to disable the module from removing font families after it
- encounters a font keyword, for example `sans-serif`.
- ##### removeDuplicates
- Type: `boolean`
- Default: `true`
- Pass `false` to disable the module from removing duplicated font families.
- ##### removeQuotes
- Type: `boolean`
- Default: `true`
- Pass `false` to disable the module from removing quotes from font families.
- Note that oftentimes, this is a *safe optimisation* & is done safely. For more
- details, see [Mathias Bynens' article][mathias].
- ## Usage
- ```js
- postcss([ require('postcss-minify-font-values') ])
- ```
- See [PostCSS] docs for examples for your environment.
- MIT © [Bogdan Chadkin](mailto:trysound@yandex.ru)
- [mathias]: https://mathiasbynens.be/notes/unquoted-font-family
- [PostCSS]: https://github.com/postcss/postcss
- [ci-img]: https://travis-ci.org/TrySound/postcss-minify-font-values.svg
- [ci]: https://travis-ci.org/TrySound/postcss-minify-font-values
|
