Конфигурация 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:
Пример
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', }, }, |
Пример
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',
},
},
},
}
Включите поддержку тёмного режима Tailwind с помощью darkMode.
module.exports = {
darkMode: 'class', // 或 'media'
theme: {
extend: {
colors: {
background: {
light: '#FFFFFF',
dark: '#000000',
},
},
},
},
}
Пример
Пример тёмного режима
</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')
]
Пример использования плагина:
Пример
module.exports = {
plugins: [
plugin(function ({ addUtilities }) {
addUtilities({
'.text-shadow': {
textShadow: '2px 2px 4px rgba(0,0,0,0.5)',
},
});
}),
],
}
Импорт плагинов сообщества:
Пример
plugins: [
require('@tailwindcss/forms'), // Плагин стилей форм
require('@tailwindcss/typography'), // Плагин типографики
],
}
Конфигурация Tailwind CSS
По умолчанию Tailwind ищет файл tailwind.config.js в корневом каталоге проекта, где вы можете указать необходимую информацию конфигурации:
Пример
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' } |
| zIndex | Setz-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, может значительно повысить эффективность разработки проекта и гибкость стилей.
Другие расширения