Utility 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 free fonts on Fontsource or Google Fonts, will be replaced with a close match:
Mapbox/MapLibre Font Name | Replacement Font Name |
---|---|
Klokantech Noto Sans | Noto Sans |
DIN Pro | Barlow |
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"'
.