Font Family

Utilities for controlling the font family of an element.

Class reference

ClassProperties
.font-sansfont-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
.font-seriffont-family: Georgia, Cambria, "Times New Roman", Times, serif;
.font-monofont-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;

Sans-serif

Use .font-sans to apply a web safe sans-serif font family:

Font Family - 图1

  1. <p class="font-sans text-lg text-gray-800 text-center">
  2. I'm a sans-serif paragraph.
  3. </p>

Serif

Use .font-serif to apply a web safe serif font family:

Font Family - 图2

  1. <p class="font-serif text-lg text-gray-800 text-center">
  2. I'm a serif paragraph.
  3. </p>

Monospaced

Use .font-mono to apply a web safe monospaced font family:

Font Family - 图3

  1. <p class="font-mono text-lg text-gray-800 text-center">
  2. I'm a monospaced paragraph.
  3. </p>

Responsive

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

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

  1. <p class="font-sans sm:font-serif md:font-mono lg:font-sans xl:font-serif">
  2. <!-- ... -->
  3. </p>

Font Family - 图4

Customizing

Font Families

By default Tailwind provides three font family utilities: a cross-browser sans-serif stack, a cross-browser serif stack, and a cross-browser monospaced stack. You can change, add, or remove these by editing the theme.fontFamily section of your Tailwind config.

  1. // tailwind.config.js
  2. module.exports = {
  3. theme: {
  4. fontFamily: {
  5. - 'sans': ['-apple-system', 'BlinkMacSystemFont', ...],
  6. - 'serif': ['Georgia', 'Cambria', ...],
  7. - 'mono': ['SFMono-Regular', 'Menlo', ...],
  8. + 'display': ['Oswald', ...],
  9. + 'body': ['Open Sans', ...],
  10. }
  11. }
  12. }

Font families can be specified as an array or as a simple comma-delimited string:

  1. {
  2. // Array format:
  3. 'sans': ['Helvetica', 'Arial', 'sans-serif'],
  4. // Comma-delimited format:
  5. 'sans': 'Helvetica, Arial, sans-serif',
  6. }

Note that Tailwind does not automatically escape font names for you. If you’re using a font that contains an invalid identifier, wrap it in quotes or escape the invalid characters.

  1. {
  2. // Won't work:
  3. 'sans': ['Exo 2', ...],
  4. // Add quotes:
  5. 'sans': ['"Exo 2"', ...],
  6. // ...or escape the space:
  7. 'sans': ['Exo\\ 2', ...],
  8. }

Responsive and pseudo-class variants

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

You can control which variants are generated for the font family utilities by modifying the fontFamily 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. // ...
  5. - fontFamily: ['responsive'],
  6. + fontFamily: ['responsive', 'hover', 'focus'],
  7. }
  8. }

Disabling

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

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