font_face: Create a font-face specification

View source: R/fonts.R

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


svglite documentation built on June 22, 2024, 6:46 p.m.