Fonts and styles

fonts

Each entry of fonts, by family name: the name the font style property uses. Paths are resolved by the host, relative to the template by default.

fonts:
  Inter: { regular: fonts/Inter-Regular.ttf, bold: fonts/Inter-Bold.ttf, fallback: [Arabic] }
  Arabic: { regular: fonts/NotoSansArabic-Regular.ttf }

regular

Type: text · Required

Path of the regular face (TrueType or OpenType), resolved by the host’s font provider.

bold

Type: text

Path of the bold face.

italic

Type: text

Path of the italic face.

boldItalic

Type: text

Path of the bold italic face.

fallback

Type: list of text

Declared families to take characters from when this family has no glyph for them, in order.

styles

Each entry of styles, by name, applied with style on bands, elements, table columns, rows and cells. A style has the style properties below, and can extend another.

styles:
  default: { font: Inter, fontSize: 9pt }
  heading: { fontSize: 14pt, fontWeight: bold }
  total: { extends: heading, align: end, borderTop: 0.75pt solid #000000 }

extends

Type: text

Name of the style this one inherits from.

Style properties

A named set of style properties. Bands, elements, styles, table columns, rows and cells all have these. They cascade: from the band, to the element’s named style (following extends), to the element’s own properties. Text properties are inherited by what a band or stack contains; box properties (background, padding, borders and vertical alignment) are not.

font

Type: text

A font family declared in fonts. Default Helvetica.

fontWeight

Type: keyword

Normal or bold.

One of:

normal
bold

italic

Type: true or false

Uses the italic face.

underline

Type: true or false

Underlines the text.

color

Type: color

Text color. Default black.

background

Type: color

Fill color of the box. Not inherited.

align

Type: keyword

Horizontal alignment of text. Default start.

One of:

start
end
left
center
right
justify

textDirection

Type: keyword

Base direction of text. Default auto.

One of:

auto
ltr
rtl

verticalAlign

Type: keyword

Vertical alignment of the content in its box. Default top; not inherited.

One of:

top
middle
bottom

lineHeight

Type: number

Multiple of the font size.

padding

Type: edges

Space between the border and the content. Not inherited.

border

Type: stroke

All four borders; the side properties override it. Not inherited.

borderTop

Type: stroke

The top border.

borderRight

Type: stroke

The right border.

borderBottom

Type: stroke

The bottom border.

borderLeft

Type: stroke

The left border.