「及時」模式:全新世代的 Tailwind CSS
Tailwind CSS on GitHub

Font Family

Utilities for controlling the font family of an element.

Default class reference

Class
屬性
font-sansfont-family: ui-sans-serif, system-ui, -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: ui-serif, Georgia, Cambria, "Times New Roman", Times, serif;
font-monofont-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;

Sans-serif

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

The quick brown fox jumps over the lazy dog.

<p class="font-sans ...">
  The quick brown fox jumps over the lazy dog.
</p>

Serif

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

The quick brown fox jumps over the lazy dog.

<p class="font-serif ...">
  The quick brown fox jumps over the lazy dog.
</p>

Monospaced

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

The quick brown fox jumps over the lazy dog.

<p class="font-mono ...">
  The quick brown fox jumps over the lazy dog.
</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.

<p class="font-sans md:font-serif">
  <!-- ... -->
</p>

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

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.

  // tailwind.config.js
  module.exports = {
    theme: {
      fontFamily: {
-       'sans': ['ui-sans-serif', 'system-ui', ...],
-       'serif': ['ui-serif', 'Georgia', ...],
-       'mono': ['ui-monospace', 'SFMono-Regular', ...],
+       'display': ['Oswald', ...],
+       'body': ['"Open Sans"', ...],
      }
    }
  }

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

{
  // Array format:
  'sans': ['Helvetica', 'Arial', 'sans-serif'],

  // Comma-delimited format:
  'sans': 'Helvetica, Arial, sans-serif',
}

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.

{
  // Won't work:
  'sans': ['Exo 2', ...],

  // Add quotes:
  'sans': ['"Exo 2"', ...],

  // ...or escape the space:
  'sans': ['Exo\\ 2', ...],
}

Variants

默認情況下, 只有 響應式 的 font family 變化模式 (variants) 會產生。

tailwind.config.jsvariants 區塊中變更 fontFamily 屬性來決定有哪些變化模式會生成。

舉個例子來說,這個設定將會生成 響應式 和 hover 的變化模式。

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       fontFamily: ['responsive', 'hover'],
      }
    }
  }

Disabling

如果你不打算在專案中使用 font family 功能,可以在你的設定檔裡的 corePlugins 屬性中將 fontFamily 設定為 false 來停用功能:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     fontFamily: false,
    }
  }