Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Glyphs

Display character sets to document the letterforms, numerals, and punctuation of a type family.

<Glyphs />

Usage

The default character sets adapt to the current page’s direction and use its localized interface labels automatically.

<Glyphs />

Examples

Focus on numerals

Supply labeled character sets to replace the defaults. Use this for numerals, symbols, or characters relevant to your brand’s languages.

<Glyphs font="display" sets={[{ label: "Numerals", chars: "0123456789" }]} />

Show Arabic letters in the text family

In an Arabic page configured with RTL direction, <Glyphs /> selects Arabic letters and both Arabic and Latin numerals automatically. Here, explicit dir and ui overrides demonstrate an Arabic specimen within an English page. This example also switches from the default display family to font="text" and uses a medium weight. The wrapper sets the reading direction of the example; Glyphs uses its dir prop to choose the character sets.

Both the snippet and preview resolve Arabic labels with resolveUIStrings("ar", ...) and pass them as ui. Overriding direction alone does not change the interface language. The sample brand has no Arabic font file, so unsupported Arabic characters use the browser’s font fallback; load a family with Arabic coverage when documenting your own brand.

import { resolveUIStrings } from "brandtree";

<div dir="rtl" lang="ar">
  <Glyphs
    ui={resolveUIStrings("ar", { defaultLocale: "en" })}
    dir="rtl"
    font="text"
    weight={500}
  />
</div>

Character sets and direction

Without custom sets, left-to-right content gets Latin uppercase, lowercase, numerals, and punctuation. Right-to-left content gets Arabic letters, Arabic and Latin numerals, and punctuation. Custom sets replace the defaults entirely; sets={[]} renders no sets.

Direction chooses these defaults; it does not load a font or prove that the font supports those characters. Configure and load the selected family through Typography.

API reference

PropType
ui?UIStrings

Override interface strings for this component. Supplied automatically in Brandtree MDX.

TypeUIStrings
Defaultprops.ui
dir?"ltr" | "rtl"

Override text direction for this component. Supplied automatically in Brandtree MDX.

Type"ltr" | "rtl"
Defaultprops.dir
font?"display" | "text"
Type"display" | "text"
Default"display"
weight?number
Typenumber
Default400
sets?Array<{ label: string; chars: string }>

Character sets to print. Defaults to direction-specific sets.

TypeArray<{ label: string; chars: string }>
class?string

Additional class on the outer element.

Typestring

Was this page helpful?