Text element

Text, with {expressions} interpolated.

- { type: text, value: ... }

Example

text.report.yaml

title: Text
culture: en-US
parameters:
  Customer: { type: string, default: "='Contoso Ltd'" }
body:
  reportHeader:
    - gap: 6pt
      content:
        - { type: text, value: Quarterly report, fontSize: 18pt, fontWeight: bold, tag: h1 }
        - { type: text, value: "Prepared for {Customer} on {Date(2026, 9, 24):D}.", color: "#6B4428" }
        - type: text
          width: 60%
          align: justify
          value: >-
            Text wraps to the width of its box. This paragraph is justified, so every line
            but the last one reaches both edges of the column.
        - type: text
          width: 45%
          italic: true
          overflow: ellipsis
          maxLines: 1
          value: A long line that is cut short with an ellipsis instead of wrapping

Properties

value

Type: text · Required

Text template, e.g. "{Sum(Population):N0} people". Grows to fit unless height is fixed.

overflow

Type: keyword · Default: wrap

What happens to text that does not fit its width (or its height, when fixed).

One of:

• wrap: Wraps onto as many lines as the text needs.
• clip: Cuts off what does not fit.
• ellipsis: Ends the last line that fits with an ellipsis.
• shrink: Reduces the font size until the text fits.

maxLines

Type: whole number

The most lines to show; the rest overflows.

It also has the properties of every element and the style properties.