Customizing Letter Spacing

WindTheme.setLetterSpacing('extra-wide', 0.15);
double spacing = WindTheme.getLetterSpacing('wide'); // 0.025

Default Letter Spacings#

WindTheme defines several pre-defined letter spacings mapped to descriptive keys. Values are in em units.

For example:

• tracking-tight applies a letter spacing of -0.025em.
• tracking-wide applies a letter spacing of 0.025em.

Arbitrary Letter Spacings#

For values outside the scale, use the tracking-[value] syntax, where value is the desired spacing in em units.

• tracking-[0.1] applies a letter spacing of 0.1em.
• tracking-[0.3] applies a letter spacing of 0.3em.

Managing Letter Spacings#

WindTheme provides methods to check, retrieve, add, and remove letter spacings at runtime.

// Check whether a letter spacing exists
bool exists = WindTheme.hasLetterSpacing('normal');
print(exists); // Output: true

// Retrieve a letter spacing value
double spacing = WindTheme.getLetterSpacing('wide');
print(spacing); // Output: 0.025

// Add a custom letter spacing
WindTheme.setLetterSpacing('extra-wide', 0.15);

// Update an existing letter spacing
WindTheme.setLetterSpacing('wide', 0.03);

// Remove a letter spacing
WindTheme.removeLetterSpacing('extra-wide');

Related Documentation#

• Letter Spacing Utilities — apply spacing with tracking-*
• Line Height — customize line height keys
• Font Size — customize the typographic scale