Fontsource faces

Edit this guide on GitHub

Creates one FontFace from the Fontsource catalog. Write the family name first, followed by name: value arguments in any order. Include weight and style to select the face:

fontsource_font_face!(
    ROBOTO,
    weight: 400,
    style: Normal,
)

Every value is checked against the vendored catalog at compile time.

Arguments

The family comes first, as the name of its families constant (e.g. ROBOTO).

weight is one of the family's available weights in 100..=900.

style is Normal or Italic, and the family has to offer it.

subset selects characters such as Latin or Cyrillic and determines the face's unicode-range. It defaults to the family's default subset.

display sets how text appears while the font loads. It accepts a FontDisplay value and defaults to Swap.

host selects where the font file is loaded from. It defaults to JsDelivr. Use Asset to bundle the file as a Hearth asset and serve it yourself. This requires the asset feature.

fontsource_font_face!(
    ROBOTO,
    weight: 700,
    style: Italic,
    subset: Cyrillic,
    display: Optional,
    host: Asset,
)

Whole families

Use fontsource_font! to create a Font with several weights, styles, or subsets.