Orbit

Text is the variant-driven primitive for every text node. Choose a variant for size and weight, a color token for tone, and an as element for semantics.

Type scale

Headings use the display face at the larger sizes; body, label, and caption cover supporting copy. The monospace prop swaps any variant to the mono font.

The quick brown fox

heading-2xl

The quick brown fox

heading-xl

The quick brown fox

heading-l

The quick brown fox

heading-m

The quick brown fox

heading-s

The quick brown fox

heading-xs

The quick brown fox

heading-xxs

The quick brown fox

body

The quick brown fox

default

The quick brown fox

title

The quick brown fox

label

The quick brown fox

caption

Colors

Color tokens convey tone and status. Headings always render at full contrast regardless of color.

default

The quick brown fox jumps over the lazy dog

muted

The quick brown fox jumps over the lazy dog

disabled

The quick brown fox jumps over the lazy dog

accent

The quick brown fox jumps over the lazy dog

success

The quick brown fox jumps over the lazy dog

warning

The quick brown fox jumps over the lazy dog

danger

The quick brown fox jumps over the lazy dog

error

The quick brown fox jumps over the lazy dog

Alignment and wrap

Control flow with align and wrap. Use balance for short headings and pretty for long paragraphs.

The wrap prop maps to CSS text-wrap. Use balance to even out short, multi-line headings and pretty to avoid orphans in body copy.

Balanced, centered copy that wraps evenly across its lines

<Text variant="body" wrap="balance" align="center">
  Balanced, centered copy
</Text>

Props

The full Text API.

as

Edefault: p

Underlying HTML element.

variant

TextVariantdefault: default

Type-scale style.

monospace

booleandefault: false

Switches to the mono font family, keeping the variant size.

formatter

TextFormatter

Formats the children value, e.g. number to 3,290,033.

tabularNums

booleandefault: false

Aligns figures in columns with tabular numerals.

truncate

number | booleandefault: false

Clamps to one line (true) or N lines (number) with ellipsis.

color

TextColordefault: default

Foreground color. Use inherit to adopt a parent Box color.

Text alignment.

Wrapping behavior.

loading

booleandefault: false

Renders a skeleton placeholder.

placeholderText

string

Width source for the single-line skeleton.

placeholderNumberOfLines

numberdefault: 1

Lines rendered when loading.

lineThrough

booleandefault: false

Strikes through the text.