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;
#>     }