Create a font-face specification

Webfonts in SVG and HTML can either be specified manually using the `@font-face` at-rule, or imported from e.g. Google Fonts using the `@import` at-rule. `font_face()` helps you create a valid `@font-face` block for the `web_fonts` argument in [svglite()] and [svgstring()] functions.

font_face(
  family,
  woff2 = NULL,
  woff = NULL,
  ttf = NULL,
  otf = NULL,
  eot = NULL,
  svg = NULL,
  local = NULL,
  weight = NULL,
  style = NULL,
  range = NULL,
  variant = NULL,
  stretch = NULL,
  feature_setting = NULL,
  variation_setting = NULL
)

Arguments

family	The font family name this font should respond to.
woff2, woff, ttf, otf, eot, svg	URLs to the font in different formats. At least one must be given. Best browser support is provided by the woff format.
local	One or more font names that local installations of the font may have. If a local font is found with either of the given names it will be used and no download will happen.
weight	An optional value for the `font-weight` descriptor
style	An optional value for the `font-style` descriptor
range	An optional value for the `unicode-range` descriptor Will give the range of unicode values that this font will support
variant	An optional value for the `font-variant` descriptor
stretch	An optional value for the `font-stretch` descriptor
feature_setting	An optional value for the `font-feature-settings` descriptor It is recommended to avoid using this if possible
variation_setting	An optional value for the `font-variation-settings` descriptor.

Value

A character string with the `@font-face` block.

Examples

font_face(
  family = "MyHelvetica",
  ttf = "MgOpenModernaBold.ttf",
  local = c("Helvetica Neue Bold", "HelveticaNeue-Bold"),
  weight = "bold"
)
#>     @font-face {
#>       font-family: "MyHelvetica";
#>       src: local("Helvetica Neue Bold"),
#>            local("HelveticaNeue-Bold"),
#>            url("MgOpenModernaBold.ttf") format("truetype");
#>       font-weight: bold;
#>     }