Директивы и функции Tailwind CSS

Tailwind CSS предоставляет некоторые очень полезные функции и директивы, которые помогают разработчикам лучше управлять стилями и оптимизировать код.

С помощью функций и директив Tailwind даёт вам больше контроля и гибкости, особенно при настройке стилей, работе с адаптивным дизайном и расширении функциональности.

Tailwind CSS предоставляет множество директив и функций, помогающих разработчикам управлять стилями и настраивать их:

  • Использование@tailwindИмпортирует базовые стили Tailwind, стили компонентов и утилитарные классы.
  • @applyПозволяет объединять несколько утилитарных классов в пользовательские классы, избегая дублирования стилей.
  • @layerПозволяет организовывать и определять различные слои стилей внутри пользовательского CSS.
  • Встроенные функции для цветов, отступов, прозрачности, радиуса границ и т. д. позволяют динамически вычислять и генерировать стили.

Директива @tailwind

@tailwindДиректива используется для импорта трёх основных слоёв Tailwind в CSS-файлах:base, componentsиutilities。

  • @tailwind base: импортирует базовые стили Tailwind (например, стили сброса браузера).
  • @tailwind components: импортирует стили компонентов, используемые для определения базовых стилей для кнопок, карточек, форм и многого другого.
  • @tailwind utilities: импортирует утилитарные классы — основную часть библиотеки стилей Tailwind, предоставляя низкоуровневые утилитарные классы для макета, цветов, отступов, границ и многого другого.

Эти слои определяют все базовые стили, стили компонентов и утилитарные классы, необходимые при использовании Tailwind.

/* 自定义样式中引入 Tailwind 样式 */
@tailwind base;          /* 引入基础样式 */
@tailwind components;    /* 引入组件样式 */
@tailwind utilities;     /* 引入工具类 */

Директива @apply

@applyДиректива используется для применения утилитарных классов Tailwind внутри пользовательских CSS-классов. Она позволяет объединять общие стили, сохраняя поддерживаемость и гибкость Tailwind.

.my-class {
  @apply <utility-class1> <utility-class2> ... ;
}

Пример

/* Пользовательский класс кнопки */
.btn {
  @apply px-4 py-2 bg-blue-500 text-white rounded-lg;
}

/* Пользовательский класс кнопки предупреждения */
.btn-warning {
  @apply px-4 py-2 bg-yellow-500 text-black rounded-lg;
}

Используя@apply, можно объединить общие классы в пользовательский CSS-класс, что позволяет повторно их использовать.

Директива @layer

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

  • @layer components: определяет пользовательские компоненты.
  • @layer utilities: определяет пользовательские утилитарные классы.
  • @layer base: определяет базовые стили.

Синтаксис:

@layer components {
  /* 在这里定义自定义的组件类 */
}

@layer utilities {
  /* 在这里定义自定义的工具类 */
}

Пример

/* Определить пользовательский компонент кнопки */
@layer components {
  .btn {
    @apply px-4 py-2 bg-blue-500 text-white rounded-lg;
  }
}

/* Определить пользовательский утилитарный класс */
@layer utilities {
  .no-scrollbar {
    @apply overflow-hidden;
  }
}

Директива @import

В Tailwind CSS также можно использовать@importдирективу для импорта других CSS-файлов. Хотя сам Tailwind не рекомендует частое использование@import, он всё же поддерживает эту возможность.

Синтаксис:

@import '<path-to-file>';

Функции Tailwind CSS

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

Цветовые функции

Tailwind предоставляет некоторые встроенные цветовые функции, которые можно использовать для создания различных вариантов цвета (например, затемнение, осветление и т. д.).

  • darken(): затемняет цвет.
  • lighten(): осветляет цвет.
  • opacity(): устанавливает прозрачность цвета.

Пример

/* Используйте функцию lighten, чтобы осветлить цвет */
.bg-custom-lighten {
  background-color: lighten(#3490dc, 10%);
}

/* Используйте функцию darken, чтобы затемнить цвет */
.bg-custom-darken {
  background-color: darken(#3490dc, 10%);
}

/* Используйте функцию opacity для установки прозрачности */
.bg-custom-opacity {
  background-color: rgba(52, 144, 220, 0.8);
}

Функции отступов

Tailwind предоставляетrem, px, emфункции для единиц измерения, таких как ... Вы можете использовать их для вычисления динамических размеров и значений отступов.

Пример

/* Используйте функцию rem для задания отступов на основе размера шрифта корневого элемента */
.margin-4 {
  margin: rem(4);
}

/* Используйте функцию px для задания отступов */
.padding-10px {
  padding: px(10);
}

Функции радиуса границы

В Tailwind CSS вы также можете использовать функции для установки радиуса границы. Например, используйтеradius()чтобы вычислять разные радиусы границ.

Пример

/* Используйте функцию radius для установки радиуса границы */
.rounded-custom {
  border-radius: radius(8px);
}

Пользовательские функции

Tailwind CSS позволяет вам определять и использовать пользовательские функции. Вы можетеtailwind.config.jsиспользоватьthemeфункцию для доступа и управления дизайн-системой Tailwind.

Пример

// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        'custom-green': '#1064B9', // Непосредственно используйте цветовые коды
      },
      spacing: {
        '1/3': '33.333333%',  // Пользовательские единицы отступов
      },
    },
  },
};

Распространённые встроенные функции в Tailwind CSS

В Tailwind CSS есть много встроенных функций, которые помогают с вычислениями при создании пользовательских стилей.

Вот некоторые распространённые встроенные функции:

ФункцияОписаниеПример
rem()Преобразует указанное значение в пикселях вremединицу, исходя из размера шрифта корневого элемента (по умолчанию 16px).rem(16) → 1rem
em()Преобразует указанное значение в пикселях вemединицу, исходя из размера шрифта текущего элемента.em(16) → 1em
px()Преобразует указанное значение вpxединицу.px(16) → 16px
calc()В Tailwind CSS используйте CSScalc()функцию для динамических вычислений.calc(100% - 20px)
min()Возвращает минимум из двух значений.min(10px, 5vw) → 5vw
max()Возвращает максимум из двух значений.max(10px, 5vw) → 10px
clamp()Генерируетclamp()функцию, часто используемую для настройки адаптивных размеров шрифта и отступов.clamp(1rem, 5vw, 3rem)→ Динамически генерирует адаптивные размеры шрифта
theme()Обращается к значениям темы в конфигурации Tailwind (таким как цвета, отступы, шрифты и т. д.).theme('colors.blue.500') → #3b82f6
screen()Возвращает подходящую точку останова размера экрана для адаптивного дизайна.screen('md') → @media (min-width: 768px)

Пример rem():

/* 将数字 16 转换为 rem 单位 */
.my-class {
  font-size: rem(16);  /* 结果为 1rem */
}

Пример em():

/* 将数字 16 转换为 em 单位 */
.my-class {
  padding: em(16);  /* 结果为 1em */
}

Пример px():

/* 使用 px() 函数生成固定像素 */
.my-class {
  margin: px(16);  /* 结果为 16px */
}

Пример calc():

/* 使用 calc() 函数动态计算 */
.my-class {
  width: calc(100% - px(20));  /* 结果为 100% - 20px */
}

Пример theme():

/* 使用 theme() 函数访问 Tailwind 主题配置 */
.my-class {
  background-color: theme('colors.green.500');  /* 结果为 #1064B9 */
}

Пример с clamp():

/* 使用 clamp() 设置字体大小,基于视口宽度变化 */
.my-class {
  font-size: clamp(1rem, 5vw, 3rem);  /* 最小 1rem,最大 3rem,视口宽度介于其间时动态变化 */
}

Использование условных операторов и комбинаций функций

В Tailwind многие возможности можно использовать с условными операторами. В сочетании с адаптивным дизайном и классами состояний (такими какhover:, focus:), вы можете динамически применять эти стили.

Например, вы можете объединить@applyс адаптивным дизайном для достижения определённых возможностей:

Пример

/* Пользовательские стили, сочетающие адаптивные классы и классы состояний */
.button {
  @apply py-2 px-4 bg-blue-500 text-white rounded-md;
}

/* На средних экранах цвет фона кнопки становится зелёным */
@media (min-width: 768px) {
  .button:hover {
    background-color: #4882BB; /* Используйте зелёный цвет Tailwind */
  }
}
Другие расширения