Lzh on GitHub

font-family

控制元素字体族的实用工具。

快速参考

类名样式
font-sansfont-family: var(--font-sans); /* ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji' */
font-seriffont-family: var(--font-serif); /* ui-serif, Georgia, Cambria, 'Times New Roman', Times, serif */
font-monofont-family: var(--font-mono); /* ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace */
font-(family-name:<custom-property>)font-family: var(<custom-property>);
font-[<value>]font-family: <value>;

示例

基本示例

使用 font-sans 和 font-mono 等实用工具设置元素的字体族：

font-sans

The quick brown fox jumps over the lazy dog.

font-serif

The quick brown fox jumps over the lazy dog.

font-mono

The quick brown fox jumps over the lazy dog. 

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

使用自定义值

使用 font-[<value>] 语法根据完全自定义的值设置 font family：

<p class="font-[Open_Sans] ...">
  Lorem ipsum dolor sit amet...
</p>

对于 CSS 变量，您还可以使用 font-(family-name:<custom-property>) 语法：

<p class="font-(family-name:--my-font) ...">
  Lorem ipsum dolor sit amet...
</p>

这只是 font-[family-name:var(<custom-property>)] 的简写形式，它会自动为您添加 var() 函数。

响应式设计

使用断点变体（例如 md:）作为 font-family 实用工具的前缀，以便仅在中等尺寸及以上的屏幕上应用该实用工具：

<p class="font-sans md:font-serif ...">
  Lorem ipsum dolor sit amet...
</p>

在 变体文档 中了解更多关于使用变体的信息。

自定义您的主题

使用 --font-* 主题变量自定义项目中的 font family 实用工具：

@theme {
  --font-display: "Oswald", "sans-serif";
}

现在，font-display 实用工具可以在您的标记中使用：

<div class="font-display">
  <!-- ... -->
</div>

您还可以为字体族提供默认的 font-feature-settings 和 font-variation-settings 值：

@theme {
  --font-display: "Oswald", "sans-serif";
  --font-display--font-feature-settings: "cv02", "cv03", "cv04", "cv11";
  --font-display--font-variation-settings: "opsz" 32;
}

如果需要，可以使用 @font-face at-rule 加载自定义字体：

@font-face {
  font-family: Oswald;
  font-style: normal;
  font-weight: 200 700;
  font-display: swap;
  src: url("/fonts/Oswald.woff2") format("woff2");
}

如果您从 Google Fonts 等服务加载字体，请确保将 @import 放在 CSS 文件的最顶部：

@import url("https://fonts.googleapis.com/css2?family=Roboto&display=swap");
@import "../../../../../node_modules/.pnpm/tailwindcss@4.1.11/node_modules/tailwindcss/dist/lib.d.mts";

@theme {
    --font-roboto: "Roboto", sans-serif;
}

浏览器要求 @import 语句出现在任何其他规则之前，因此 URL 导入需要位于像 @import "tailwindcss" 这样的导入之上，后者会内联到编译后的 CSS 中。

在 主题文档 中了解更多关于自定义主题的信息。