R: Create a font-face specification

font_face {svglite} | R Documentation

## Create a font-face specification

### Description

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.

### Usage

    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"
    )

[Package svglite version 2.0.0 Index]