字体系列

​基本用法

¥Basic usage

​设置字体系列

¥Setting the font family

你可以使用字体系列工具控制文本的字体。

¥You can control the typeface of text using the font family utilities.

<p class="font-sans ...">The quick brown fox ...</p>
<p class="font-serif ...">The quick brown fox ...</p>
<p class="font-mono ...">The quick brown fox ...</p>

​有条件地应用

​悬停、聚焦和其他状态

Tailwind 允许你使用变体修饰符在不同状态下有条件地应用工具类。例如，使用hover:font-serif 仅在 hover 时应用 font-serif 工具。

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

有关所有可用状态修饰符的完整列表，请查看悬停、聚焦、以及其他状态 文档。

​断点和媒体查询

你还可以使用变体修饰符来定位媒体查询，例如响应式断点、暗黑模式、首选减少运动等。例如，使用 md:font-serif 仅在中等屏幕尺寸及以上时应用 font-serif 工具。

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

要了解更多信息，请查看有关 响应式设计、暗黑模式、以及 其他媒体查询修饰符 的文档。

​使用自定义值

¥Using custom values

​自定义主题

¥Customizing your theme

默认情况下，Tailwind 提供三种字体系列工具：跨浏览器无衬线堆栈、跨浏览器衬线堆栈和跨浏览器等宽堆栈。你可以通过编辑 Tailwind 配置的 theme.fontFamily 部分来更改、添加或删除它们。

¥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.

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',
}

请注意，Tailwind 不会自动为你转义字体名称。如果你使用的字体包含无效标识符，请将其用引号引起来或转义无效字符。

¥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', ...],
}

与任何其他 Web 项目一样，请确保在 CSS 中为你使用的任何自定义字体包含必要的 @font-face 或 @import 规则，以便浏览器为你的网站加载这些字体：

¥Like any other web project, make sure to include the necessary @font-face or @import rules in your CSS for any custom fonts you’re using so that those fonts are loaded by the browser for your site:

@tailwind base;
@tailwind components;
@tailwind utilities;

@layer base {
  @font-face {
    font-family: 'Roboto';
    font-style: normal;
    font-weight: 400;
    font-display: swap;
    src: url(/fonts/Roboto.woff2) format('woff2');
  }
}

在 主题定制 文档中了解有关自定义默认主题的更多信息。

¥Learn more about customizing the default theme in the theme customization documentation.

​提供默认字体设置

¥Providing default font settings

在配置自定义字体时，你可以选择使用 [fontFamilies, { fontFeatureSettings, fontVariationSettings }] 形式的元组为项目中的每种字体提供默认的 font-feature-settings 和 font-variation-settings。

¥You can optionally provide default font-feature-settings and font-variation-settings for each font in your project using a tuple of the form [fontFamilies, { fontFeatureSettings, fontVariationSettings }] when configuring custom fonts.

module.exports = {
  theme: {
    fontFamily: {
      sans: [
        '"Inter var", sans-serif',
        {
          fontFeatureSettings: '"cv11", "ss01"',
          fontVariationSettings: '"opsz" 32'
        },
      ],
    },
  },
}

​任意值

¥Arbitrary values

如果你需要使用一次性的 font-family 值，而该值没有必要包含在你的主题中，请使用方括号动态生成属性，使用任意值。

<p class="font-['Open_Sans']">
  <!-- ... -->
</p>

在 任意值 文档中了解有关任意值支持的更多信息。

​自定义默认字体

¥Customizing the default font

为方便起见，预检 在 html 元素上设置字体系列以匹配你配置的 sans 字体，因此更改项目默认字体的一种方法是在 fontFamily 配置中自定义 sans 键：

¥For convenience, Preflight sets the font family on the html element to match your configured sans font, so one way to change the default font for your project is to customize the sans key in your fontFamily configuration:

const defaultTheme = require('tailwindcss/defaultTheme')

module.exports = {
  theme: {
    extend: {
      fontFamily: {
        'sans': ['"Proxima Nova"', ...defaultTheme.fontFamily.sans],
      },
    }
  }
}

你还可以通过明确设置 font-family 属性的 添加自定义基本样式 自定义项目中使用的默认字体：

¥You can also customize the default font used in your project by adding a custom base style that sets the font-family property explicitly:

@tailwind base;
@tailwind components;
@tailwind utilities;

@layer base {
  html {
    font-family: "Proxima Nova", system-ui, sans-serif;
  }
}

如果你已将字体系列工具自定义为具有不同的名称并且不希望在你的项目中有可用的 font-sans 工具，则这是最佳方法。

¥This is the best approach if you have customized your font family utilities to have different names and don’t want there to be font-sans utility available in your project.