Font Variant Numeric

Utilities for controlling the variant of numbers.

Default class reference

Class
Properties
normal-numsfont-variant-numeric: normal;
ordinalfont-variant-numeric: ordinal;
slashed-zerofont-variant-numeric: slashed-zero;
lining-numsfont-variant-numeric: lining-nums;
oldstyle-numsfont-variant-numeric: oldstyle-nums;
proportional-numsfont-variant-numeric: proportional-nums;
tabular-numsfont-variant-numeric: tabular-nums;
diagonal-fractionsfont-variant-numeric: diagonal-fractions;
stacked-fractionsfont-variant-numeric: stacked-fractions;

Usage

Use the font-variant-numeric utilities to enable additional glyphs for numbers, fractions, and ordinal markers (in fonts that support them).

These utilities are composable so you can enable multiple font-variant-numeric features by combining multiple classes in your HTML:

  1. <p class="ordinal slashed-zero tabular-nums ...">1234567890</p>

Note that many fonts don’t support these features (stacked fractions support for example is especially rare), so some of these utilities may have no effect depending on the font family you are using.

Ordinal

Use the ordinal utility to enable special glyphs for the ordinal markers.

Font Variant Numeric - 图1

  1. <p class="ordinal ...">1st</p>

Slashed Zero

Use the slashed-zero utility to force a 0 with a slash; this is useful when a clear distinction between O and 0 is needed.

Font Variant Numeric - 图2

  1. <p class="slashed-zero ...">0</p>

Lining figures

Use the lining-nums utility to use the numeric glyphs that are all aligned by their baseline. This corresponds to the lnum OpenType feature. This is the default for most fonts.

Font Variant Numeric - 图3

  1. <p class="lining-nums ...">1234567890</p>

Oldstyle figures

Use the oldstyle-nums utility to use numeric glyphs where some numbers have descenders. This corresponds to the onum OpenType feature.

Font Variant Numeric - 图4

  1. <p class="oldstyle-nums ...">1234567890</p>

Proportional figures

Use the proportional-nums utility to use numeric glyphs that have proportional widths (rather than uniform/tabular). This corresponds to the pnum OpenType feature.

Font Variant Numeric - 图5

  1. <p class="proportional-nums ...">12121</p>
  2. <p class="proportional-nums ...">90909</p>

Tabular figures

Use the tabular-nums utility to use numeric glyphs that have uniform/tabular widths (rather than proportional). This corresponds to the tnum OpenType feature.

Font Variant Numeric - 图6

  1. <p class="tabular-nums ...">12121</p>
  2. <p class="tabular-nums ...">90909</p>

Diagonal fractions

Use the diagonal-fractions utility to replace numbers separated by a slash with common diagonal fractions. This corresponds to the frac OpenType feature.

Font Variant Numeric - 图7

  1. <p class="diagonal-fractions ...">1/2 3/4 5/6</p>

Stacked fractions

Use the stacked-fractions utility to replace numbers separated by a slash with common stacked fractions. This corresponds to the frac OpenType feature. Very few fonts seem to support this feature — we’ve used Ubuntu Mono here.

Font Variant Numeric - 图8

  1. <p class="stacked-fractions ...">1/2 3/4 5/6</p>

Resetting numeric font variants

Use the normal-nums propery to reset numeric font variants. This is usually useful for resetting a font feature at a particular breakpoint:

  1. <p class="slashed-zero tabular-nums md:normal-nums ...">12345</p>

Responsive

To control font-variant-numeric property of an element at a specific breakpoint, add a {screen}: prefix to any existing font-variant-numeric utility. For example, use md:tabular-nums to apply the tabular-nums utility at only medium screen sizes and above.

  1. <div class="proportional-nums md:tabular-nums">
  2. <!-- ... -->
  3. </div>

For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.

Customizing

Variants

By default, only responsive variants are generated for font variant numeric utilities.

You can control which variants are generated for the font variant numeric utilities by modifying the fontVariantNumeric property in the variants section of your tailwind.config.js file.

For example, this config will also generate hover and focus variants:

  1. // tailwind.config.js
  2. module.exports = {
  3. variants: {
  4. extend: {
  5. // ...
  6. + fontVariantNumeric: ['hover', 'focus'],
  7. }
  8. }
  9. }

Disabling

If you don’t plan to use the font variant numeric utilities in your project, you can disable them entirely by setting the fontVariantNumeric property to false in the corePlugins section of your config file:

  1. // tailwind.config.js
  2. module.exports = {
  3. corePlugins: {
  4. // ...
  5. + fontVariantNumeric: false,
  6. }
  7. }

←Font Weight   Letter Spacing→