Directivas y funciones de Tailwind CSS

Tailwind CSS proporciona algunas funciones y directivas muy útiles que ayudan a los desarrolladores a gestionar mejor los estilos y optimizar el código.

Mediante funciones y directivas, Tailwind puede brindarte más control y flexibilidad, especialmente en la personalización de estilos, el manejo del diseño responsive y la ampliación de funcionalidades.

Tailwind CSS ofrece diversas directivas y funciones para ayudar a los desarrolladores a gestionar y personalizar estilos:

  • Uso@tailwindIntroduce los estilos base, los estilos de componentes y las clases utilitarias de Tailwind.
  • @applyPermite combinar varias clases utilitarias en clases personalizadas para evitar la repetición de estilos.
  • @layerPermite organizar y definir diferentes capas de estilos en tu CSS personalizado.
  • Usa funciones integradas de color, espaciado, transparencia, radio de borde, etc., para calcular y generar estilos dinámicamente.

Directiva @tailwind

@tailwindLa directiva se utiliza para introducir las tres capas principales de Tailwind en un archivo CSS:base, componentsyutilities。

  • @tailwind base: introduce los estilos base de Tailwind (como los estilos de reinicio del navegador).
  • @tailwind components: introduce los estilos de componentes, utilizados para definir estilos base como botones, tarjetas, formularios, etc.
  • @tailwind utilities: introduce las clases utilitarias, la parte central de la biblioteca de estilos de Tailwind, que proporciona clases utilitarias de bajo nivel para diseño, color, espaciado, bordes, etc.

Estas capas definen todos los estilos básicos, estilos de componentes y clases utilitarias que necesitas al usar Tailwind.

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

Directiva @apply

@applyLa directiva se utiliza para aplicar las clases utilitarias de Tailwind en clases CSS personalizadas. Esto te permite combinar estilos de uso común mientras mantienes la capacidad de mantenimiento y la flexibilidad de Tailwind.

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

Ejemplo

/* Clase de botón personalizada */
.btn {
  @apply px-4 py-2 bg-blue-500 text-white rounded-lg;
}

/* Clase de botón de advertencia personalizada */
.btn-warning {
  @apply px-4 py-2 bg-yellow-500 text-black rounded-lg;
}

Mediante el uso de@apply, puedes combinar clases de uso común en una clase CSS personalizada para poder reutilizarla.

Directiva @layer

@layerLa directiva se utiliza para definir capas (layer) en Tailwind, principalmente para la organización de estilos de extensión personalizados. Se utiliza comúnmente para crear componentes personalizados, clases utilitarias, etc., con el fin de mantener una estructura clara en el archivo CSS.

  • @layer components: define componentes personalizados.
  • @layer utilities: define clases utilitarias personalizadas.
  • @layer base: define estilos base.

Formato de sintaxis:

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

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

Ejemplo

/* Definir componente de botón personalizado */
@layer components {
  .btn {
    @apply px-4 py-2 bg-blue-500 text-white rounded-lg;
  }
}

/* Definir clase utilitaria personalizada */
@layer utilities {
  .no-scrollbar {
    @apply overflow-hidden;
  }
}

Directiva @import

En Tailwind CSS, también puedes usar la@importdirectiva para importar otros archivos CSS. Aunque Tailwind no recomienda usarla con frecuencia,@import, aún así admite esta funcionalidad.

Formato de sintaxis:

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

Funciones de Tailwind CSS

Las funciones en Tailwind CSS se utilizan principalmente para generar estilos dinámicamente, como el cálculo de color, transparencia, tamaño, etc. Te permiten realizar más cálculos y tener más control en el archivo de configuración o en los estilos personalizados.

Funciones de color (Color Functions)

Tailwind proporciona algunas funciones de color integradas que se pueden utilizar para generar diferentes variantes de color (como oscurecer, aclarar, etc.).

  • darken(): oscurece el color.
  • lighten(): aclara el color.
  • opacity(): establece la transparencia del color.

Ejemplo

/* Usar la función lighten para aclarar el color */
.bg-custom-lighten {
  background-color: lighten(#3490dc, 10%);
}

/* Usar la función darken para oscurecer el color */
.bg-custom-darken {
  background-color: darken(#3490dc, 10%);
}

/* Usar la función opacity para establecer la transparencia */
.bg-custom-opacity {
  background-color: rgba(52, 144, 220, 0.8);
}

Funciones de espaciado (Spacing Functions)

Tailwind proporciona funciones con unidades comorem, px, em, etc. Puedes usarlas para calcular tamaños y valores de espaciado dinámicos.

Ejemplo

/* Usar la función rem para establecer un espaciado basado en el tamaño de fuente raíz */
.margin-4 {
  margin: rem(4);
}

/* Usar la función px para establecer el espaciado */
.padding-10px {
  padding: px(10);
}

Funciones de radio de borde (Border Radius Functions)

En Tailwind CSS también se pueden usar funciones para establecer el radio de borde. Por ejemplo, usarradius()para calcular diferentes radios de borde.

Ejemplo

/* Usar la función radius para establecer el radio de borde */
.rounded-custom {
  border-radius: radius(8px);
}

Funciones personalizadas (Custom Functions)

Tailwind CSS te permite definir y usar funciones personalizadas. Puedes, entailwind.config.js, usar lathemefunción para acceder y manipular el sistema de diseño de Tailwind. Por ejemplo, puedes generar colores, espaciados, fuentes, etc. dinámicamente.

Ejemplo

// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        'custom-green': '#1064B9', // Usar directamente códigos de color
      },
      spacing: {
        '1/3': '33.333333%',  // Unidades de espaciado personalizadas
      },
    },
  },
};

Funciones integradas comunes de Tailwind CSS

Tailwind CSS incluye muchas funciones integradas para ayudarte a realizar cálculos al construir estilos personalizados.

A continuación se muestran algunas funciones integradas comunes:

FunciónDescripciónEjemplo
rem()Convierte el valor de píxeles especificado aremunidades, basado en el tamaño de fuente raíz (16px por defecto).rem(16) → 1rem
em()Convierte el valor de píxeles especificado aemunidades, basado en el tamaño de fuente del elemento actual.em(16) → 1em
px()Convierte el valor numérico especificado apxunidades.px(16) → 16px
calc()En Tailwind CSS, usa la función CSScalc()para realizar cálculos dinámicos.calc(100% - 20px)
min()Toma el valor mínimo entre dos valores.min(10px, 5vw) → 5vw
max()Toma el valor máximo entre dos valores.max(10px, 5vw) → 10px
clamp()Genera una funciónclamp(), comúnmente utilizada para establecer tamaños de fuente y espaciados responsive.clamp(1rem, 5vw, 3rem)→ Genera dinámicamente tamaños de fuente responsive
theme()Accede a los valores de tema en la configuración de Tailwind (como colores, espaciados, fuentes, etc.).theme('colors.blue.500') → #3b82f6
screen()Devuelve los puntos de interrupción de tamaño de pantalla adaptados para diseño responsive.screen('md') → @media (min-width: 768px)

Ejemplo de rem():

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

Ejemplo de em():

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

Ejemplo de px():

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

Ejemplo de calc():

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

Ejemplo de theme():

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

Ejemplo de clamp():

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

Uso de operadores condicionales y combinación de funciones

En Tailwind, muchas funcionalidades se pueden usar junto con operadores condicionales. Al combinar diseño responsive y clases de estado (comohover:, focus:), puedes aplicar estos estilos dinámicamente.

Por ejemplo, puedes combinar@applyy diseño responsive para implementar ciertas funcionalidades:

Ejemplo

/* Estilos personalizados que combinan diseño responsive y clases de estado */
.button {
  @apply py-2 px-4 bg-blue-500 text-white rounded-md;
}

/* En pantallas medianas, el color de fondo del botón se vuelve verde */
@media (min-width: 768px) {
  .button:hover {
    background-color: #4882BB; /* Usar el verde de Tailwind */
  }
}
Otras extensiones