Краткая справка

Класс
Свойства
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;

Основы использования

Установка семейства шрифтов

Вы можете управлять шрифтом текста с помощью утилит семейства шрифтов.

font-sans

Быстрая коричневая лиса прыгает через ленивую собаку.

font-serif

Быстрая коричневая лиса прыгает через ленивую собаку.

font-mono

Быстрая коричневая лиса прыгает через ленивую собаку.

<p class="font-sans ...">Быстрая коричневая лиса ...</p>
<p class="font-serif ...">Быстрая коричневая лиса ...</p>
<p class="font-mono ...">Быстрая коричневая лиса ...</p>

Применяя условно

Tailwind lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:font-serif to only apply the font-serif utility on hover.

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

For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.

Контрольные точки и медиа-запросы

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. 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>

To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.


Использование пользовательских значений

Настройка вашей темы

По умолчанию Tailwind предоставляет три утилиты семейства шрифтов: кроссбраузерный стек без засечек, кроссбраузерный стек с засечками и кроссбраузерный моноширинный стек. Вы можете изменить, добавить или удалить их, отредактировав раздел theme.fontFamily в Вашей конфигурации Tailwind.

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

Семейства шрифтов можно указать как массив или как простую строку с разделителями-запятыми:

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

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

Обратите внимание, что Tailwind не экранирует имена шрифтов автоматически для Вас. Если вы используете шрифт, содержащий недопустимый идентификатор, заключите его в кавычки или экранируйте недопустимые символы.

{
  // Не сработает:
  'sans': ['Exo 2', ...],

  // Добавьте кавычки:
  'sans': ['"Exo 2"', ...],

  // ...или экранируйте из пробела:
  'sans': ['Exo\\ 2', ...],
}

Дополнительные сведения о настройке темы по умолчанию смотрите в документации настройка темы.

Произвольные значения

If you need to use a one-off font-family value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

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

Learn more about arbitrary value support in the arbitrary values documentation.

Настройка шрифта по умолчанию

Для удобства Preflight устанавливает семейство шрифтов в элементе html в соответствии с настроенным шрифтом sans, поэтому один из способов изменить шрифт по умолчанию для вашего проекта — настроить ключ sans в вашей конфигурации fontFamily:

tailwind.config.js
const defaultTheme = require('tailwindcss/defaultTheme')

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

Вы также можете настроить шрифт по умолчанию, используемый в вашем проекте, добавив собственный базовый стиль, который явно задает свойство font-family:

main.css
@tailwind base;
@tailwind components;
@tailwind utilities;

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

Это лучший подход, если вы настроили утилиты семейства шрифтов, чтобы они имели разные имена, и не хотите, чтобы в вашем проекте была доступна утилита font-sans.