Конфигурация Tailwind CSS

Основной файл конфигурации Tailwind CSS —tailwind.config.js。

tailwind.config.js — это файл конфигурации Tailwind CSS, используемый для настройки конфигурации Tailwind по умолчанию.

Изменяя файл tailwind.config.js, разработчики могут настраивать элементы дизайн-системы, такие как цвета, отступы, шрифты и контрольные точки, в соответствии с конкретными требованиями проекта.

Создание файла конфигурации

Вы можете быстро создать базовый файл tailwind.config.js с помощью инструмента CLI Tailwind CSS.

Выполните следующую команду в корневом каталоге проекта:

npx tailwindcss init

Это создаст файл tailwind.config.js, содержащий базовую конфигурацию.

Базовая структура

Ниже приведена структура типичного файла tailwind.config.js:

Пример

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js,vue}"], // Определите пути к файлам шаблонов для сканирования
  theme: {
    extend: {}, // Пользовательские расширения
  },
  plugins: [], // Настройка плагинов
}

Приведённый выше код указывает Tailwind CSS сканировать все файлы .html, .js и .vue в каталоге src.


Основные элементы конфигурации

1. Настройка пути к шаблонам: content

В файле tailwind.config.js параметр content используется для указания, какие файлы Tailwind CSS должен сканировать для сбора имён классов.
content: [
  "./index.html", // 单文件路径
  "./src/**/*.{html,js,ts,jsx,tsx}", // 包含多个文件类型的路径
],

Это указывает Tailwind CSS сканировать все файлы .html, .js, .ts, .jsx и .tsx в каталоге src.

Поле content используется для указания путей к файлам шаблонов для Tailwind. Tailwind сканирует эти файлы, чтобы сгенерировать необходимые стили, уменьшая размер сгенерированного CSS-файла за счёт создания только тех стилей, которые используются в файлах шаблонов, и предотвращая компиляцию неиспользуемых стилей в итоговый вывод.

2. Настройка темы: theme

В разделе theme можно определить цвета, шрифты, отступы, размеры границ и другое.

Например, расширьте цвета по умолчанию или добавьте новые цвета:

theme: {
  extend: {
    colors: {
      cyan: '#9CDBFF',
    }
  }
}

Это добавит новый цвет с именем cyan, и вы сможете использовать в проекте такие имена классов, как bg-cyan.

Элемент конфигурацииОписаниеПример
fontSizeПользовательский размер шрифтаjavascript fontSize: { 'xs': '0.75rem', '4xl': '2.5rem', },
screensОпределение точек останова (адаптивный дизайн)javascript screens: { 'sm': '640px', 'xl': '1280px', },
borderRadiusПользовательский радиус границыjavascript borderRadius: { 'lg': '1rem', 'xl': '1.5rem', },
extendРасширить существующие значения по умолчаниюjavascript extend: { colors: { danger: '#FF5A5F', }, },

Пример

theme: {
  extend: {
    colors: {
      primary: '#1D4ED8',
      secondary: '#64748B',
    },
    spacing: {
      18: '4.5rem', // Добавить отступ 4.5rem
    },
    fontSize: {
      '4xl': '2.5rem',
    },
    borderRadius: {
      'xl': '1.5rem',
    },
    screens: {
      '2xl': '1536px', // Добавить новые адаптивные точки останова
    },
  },
}

Определите цвета через theme.colors и ссылайтесь на них в стилях.

theme: {
  extend: {
    colors: {
      brand: {
        light: '#93C5FD',
        DEFAULT: '#3B82F6',
        dark: '#1E40AF',
      },
    },
  },
}

Пример

<div class="bg-brand text-brand-light">Пример пользовательских цветов</div>

Попробуйте »

Включите поддержку тёмного режима Tailwind с помощью darkMode.

module.exports = {
  darkMode: 'class', // 或 'media'
  theme: {
    extend: {
      colors: {
        background: {
          light: '#FFFFFF',
          dark: '#000000',
        },
      },
    },
  },
}

Пример

<div class="bg-background-light dark:bg-background-dark">
  Пример тёмного режима
</div>

3. Настройка вариантов: variants

Опция variants позволяет определить, какие состояния (например, hover, focus и т. д.) должны быть включены в итоговый CSS.

Вы можете расширить или переопределить варианты по умолчанию:

variants: {
  extend: {
    borderColor: ['focus-visible'],
    opacity: ['disabled'],
  }
}

4. Использование плагинов: plugins

Опция plugins позволяет добавлять пользовательские utility-классы.

Эти плагины могут быть официально предоставлены Tailwind CSS или созданы сообществом, в следующем формате:

plugins: [
  require('some-tailwindcss-plugin')
]

Пример использования плагина:

Пример

const plugin = require('tailwindcss/plugin');

module.exports = {
  plugins: [
    plugin(function ({ addUtilities }) {
      addUtilities({
        '.text-shadow': {
          textShadow: '2px 2px 4px rgba(0,0,0,0.5)',
        },
      });
    }),
  ],
}

Импорт плагинов сообщества:

Пример

module.exports = {
  plugins: [
    require('@tailwindcss/forms'), // Плагин стилей форм
    require('@tailwindcss/typography'), // Плагин типографики
  ],
}

Конфигурация Tailwind CSS

По умолчанию Tailwind ищет файл tailwind.config.js в корневом каталоге проекта, где вы можете указать необходимую информацию конфигурации:

Пример

/** @type {import('tailwindcss').Config} */
module.exports = {
  // Укажите, из каких файлов Tailwind CSS должен извлекать имена классов. Здесь настроено извлечение из всех файлов `.html` и `.js` в каталоге `./src`.
  content: ['./src/**/*.{html,js}'],

  theme: {
    // Пользовательская конфигурация цветов
    colors: {
      'blue': '#1fb6ff', // Определяет цвет с именем 'blue' и значением #1fb6ff
      'purple': '#7e5bef', // Определяет цвет с именем 'purple' и значением #7e5bef
      'pink': '#ff49db', // Определяет цвет с именем 'pink' и значением #ff49db
      'orange': '#ff7849', // Определяет цвет с именем 'orange' и значением #ff7849
      'green': '#1370CE', // Определяет цвет с именем 'green' и значением #1370CE
      'yellow': '#ffc82c', // Определяет цвет с именем 'yellow' и значением #ffc82c
      'gray-dark': '#273444', // Определяет цвет с именем 'gray-dark' и значением #273444
      'gray': '#8492a6', // Определяет цвет с именем 'gray' со значением #8492a6
      'gray-light': '#d3dce6' // Определяет цвет с именем 'gray-light' со значением #d3dce6
    },
    // Пользовательская конфигурация семейства шрифтов
    fontFamily: {
      sans: ['Graphik', 'sans-serif'], // Определяет семейство шрифтов с именем 'sans', включающее 'Graphik' и общий 'sans-serif'
      serif: ['Merriweather', 'serif'] // Определяет семейство шрифтов с именем 'serif', включающее 'Merriweather' и общий 'serif'
    },
    // Пользовательская конфигурация расширения
    extend: {
      // Пользовательское расширение отступов
      spacing: {
        '8xl': '96rem', // Определяет интервал с именем '8xl' со значением 96rem
        '9xl': '128rem' // Определяет интервал с именем '9xl' со значением 128rem
      },
      // Пользовательское расширение радиуса границы
      borderRadius: {
        '4xl': '2rem' // Определяет радиус границы с именем '4xl' со значением 2rem
      }
    }
  },
}

В следующей таблице перечислены параметры конфигурации файла tailwind.config.js и описания их использования:

Элемент конфигурацииОписаниеЗначение по умолчаниюПример
contentНастройте пути к файлам шаблонов для сканирования Tailwind CSS, используемые для удаления неиспользуемых стилей.['./src/**/*.{html,js,ts,jsx,tsx}']content: ["./src/**/*.html", "./src/**/*.vue"]
themeИспользуется для определения и расширения дизайн-системы Tailwind по умолчанию, включая цвета, отступы, шрифты и т. д.extend: {}theme: { colors: { primary: '#3490dc' } }
extendИспользуется для расширения стандартных элементов конфигурации Tailwind, а не для переопределения значений по умолчанию.{}extend: { colors: { primary: '#3490dc' } }
screensНастройте адаптивные контрольные точки, определяющие, когда применяются определённые стили.{ sm: '640px', md: '768px', lg: '1024px', xl: '1280px' }screens: { '2xl': '1536px' }
colorsНастройте или расширьте цветовую палитру.По умолчанию предоставляет набор цветов, напримерblue, red, greenожиданиеcolors: { primary: '#1D4ED8', secondary: '#64748B' }
spacingУстановите внутренние и внешние отступы (p, m, pt, mtи т.д.).По умолчанию предоставляет единицы измерения, например0.5rem, 1rem, 2remожиданиеspacing: { 18: '4.5rem' }
fontFamilyНастройте семейство шрифтов.'sans', 'serif', 'mono'fontFamily: { sans: ['Inter', 'sans-serif'] }
fontSizeНастройте размер шрифта.'sm': '0.875rem', 'lg': '1.125rem'fontSize: { '4xl': '2.5rem' }
fontWeightНастройте насыщенность шрифта.'normal', 'bold', 'bolder', 'lighter'fontWeight: { 'light': '300', 'bold': '700' }
lineHeightЗадайте высоту строки.'none': '1', 'tight': '1.25', 'normal': '1.5', 'loose': '2'lineHeight: { 'relaxed': '1.75', 'loose': '2' }
borderRadiusУстановите радиус скругления границ.'none': '0px', 'sm': '0.125rem', 'md': '0.375rem', 'lg': '0.5rem'borderRadius: { 'xl': '1.5rem' }
borderWidthЗадать ширину границы.{ default: '1px', '0': '0', '2': '2px' }borderWidth: { '3': '3px' }
zIndexSetz-indexуровень.{ '0': '0', '10': '10', '20': '20' }zIndex: { 'max': '9999' }
opacityЗадать значение непрозрачности.{ '0': '0', '25': '0.25', '50': '0.5', '75': '0.75', '100': '1' }opacity: { '40': '0.4' }
boxShadowЗадать тень блока.{ sm: '0 1px 2px 0 rgba(0, 0, 0, 0.05)', default: '0 4px 6px rgba(0, 0, 0, 0.1)'}boxShadow: { 'lg': '0 10px 15px -3px rgba(0, 0, 0, 0.1)' }
containerЗадать максимальную ширину контейнера (для адаптивного дизайна).{ center: false, padding: '2rem' }container: { center: true, padding: '1rem' }
aspectRatioЗадать соотношение сторон элементов.{ 'none': 'none' }aspectRatio: { '16/9': '16/9' }
gridTemplateColumnsЗадать шаблон столбцов CSS Grid.{ auto: 'auto', '1fr': '1fr' }gridTemplateColumns: { 'layout': 'repeat(3, 1fr)' }
gridColumnЗадать поведение column-span для элементов Grid.{ 'span-1': 'span 1 / span 1' }gridColumn: { 'span-2': 'span 2 / span 2' }
transitionPropertyЗадать свойства перехода.{ all: 'all' }transitionProperty: { 'color': 'color' }
transitionDurationЗадать длительность перехода.{ 75: '75ms', 150: '150ms', 300: '300ms' }transitionDuration: { '400': '400ms' }
transitionTimingFunctionУстановите функцию синхронизации для переходов.{ 'ease': 'ease', 'linear': 'linear' }transitionTimingFunction: { 'ease-out': 'ease-out' }

С помощью tailwind.config.js вы можете легко настраивать возможности и стили Tailwind CSS под различные дизайнерские задачи. Разумное использование таких возможностей, как extend, plugins и конфигурация theme, может значительно повысить эффективность разработки проекта и гибкость стилей.

Другие расширения