- Typography
- font-family
Typography
font-family
Utilities for controlling the font family of an element.
| Class | Styles |
|---|---|
font-sans | font-family: var(--font-sans); /* ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji' */ |
font-serif | font-family: var(--font-serif); /* ui-serif, Georgia, Cambria, 'Times New Roman', Times, serif */ |
font-mono | font-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>; |
Examples
Basic example
Use utilities like font-sans and font-mono to set the font family of an element:
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
<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>Using a custom value
Use the font-[<value>] syntax to set the font family based on a completely custom value:
<p class="font-[Open_Sans] ..."> <!-- ... --></p>For CSS variables, you can also use the font-(<custom-property>) syntax:
<p class="font-(--my-font) ..."> <!-- ... --></p>This is just a shorthand for font-[var(<custom-property>)] that adds the var() function for you automatically.
Responsive design
Prefix a font-family utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:
<p class="font-sans md:font-serif ..."> <!-- ... --></p>Learn more about using variants in the variants documentation.
Customizing your theme
Use the --font-* theme variables to customize the font family utilities in your project:
@theme { --font-display: "Oswald", "sans-serif"; }Now the font-display utility can be used in your markup:
<div class="font-display"> <!-- ... --></div>You can also provide default font-feature-settings and font-variation-settings values for a font family:
@theme { --font-display: "Oswald", "sans-serif"; --font-display--font-feature-settings: "cv02", "cv03", "cv04", "cv11"; --font-display--font-variation-settings: "opsz" 32; }If needed, use the @font-face at-rule to load custom fonts:
@font-face { font-family: Oswald; font-style: normal; font-weight: 200 700; font-display: swap; src: url("/fonts/Oswald.woff2") format("woff2");}Learn more about customizing your theme in the theme documentation.
