Utilities for controlling the font family of an element.
The quick brown fox jumps over the lazy dog.
<p class="font-sans ...">
The quick brown fox jumps over the lazy dog.
</p>
The quick brown fox jumps over the lazy dog.
<p class="font-serif ...">
The quick brown fox jumps over the lazy dog.
</p>
The quick brown fox jumps over the lazy dog.
<p class="font-mono ...">
The quick brown fox jumps over the lazy dog.
</p>
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.
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', ...],
}
默認情況下, 只有 響應式 的 font family 變化模式 (variants) 會產生。
在 tailwind.config.js
的 variants
區塊中變更 fontFamily
屬性來決定有哪些變化模式會生成。
舉個例子來說,這個設定將會生成 響應式 和 hover 的變化模式。
// tailwind.config.js
module.exports = {
variants: {
extend: {
// ...
+ fontFamily: ['responsive', 'hover'],
}
}
}
如果你不打算在專案中使用 font family 功能,可以在你的設定檔裡的 corePlugins
屬性中將 fontFamily
設定為 false
來停用功能:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ fontFamily: false,
}
}