Utility to convert Mapbox GL Style font names to CSS font definitions
npm install mapbox-to-css-fontUtility to convert Mapbox/MapLibre GL Style fontstacks or fonts names to CSS compatible font definitions.
For fontstacks, the style and weight of the primary font (first font in the fontstack) will also be used for the fallback fonts.
Fonts commonly found in Mapbox/MapLibre styles, which are not available as systm fonts or free fonts on Fontsource or Google Fonts, will be replaced with a close match:
| Mapbox/MapLibre Font Name | Replacement Font Name |
|---------------------------|-----------------------|
| Arial Unicode MS | Arial |
| DIN Pro | Barlow |
| Klokantech Noto Sans | Noto Sans |
``js
import parseFont from 'mapbox-to-css-font';
parseFont('Open Sans Regular', 16, 1.2);
// returns 'normal 400 16px/1.2 "Open Sans"'
`
Parameters
- fonts string|Array<string> Mapbox GL Style fontstack or single font, e.g. ['Open Sans Regular', 'Arial Unicode MS Regular'] or 'Open Sans Regular'.
- size number Font size in pixels.
- lineHeight string|number Line height as css line-height. Optional.
Returns string CSS font definition, e.g. 'normal 400 16px/1.2 "Open Sans"'`.