Configuración de Tailwind CSS

El archivo de configuración central de Tailwind CSS estailwind.config.js。

tailwind.config.js es el archivo de configuración de Tailwind CSS, utilizado para personalizar la configuración predeterminada de Tailwind.

Al modificar el archivo tailwind.config.js, los desarrolladores pueden personalizar colores, espaciados, fuentes, puntos de interrupción y otros elementos del sistema de diseño para satisfacer las necesidades específicas del proyecto.

Crear archivo de configuración

Usando la herramienta CLI de Tailwind CSS se puede generar rápidamente un archivo tailwind.config.js básico.

Ejecuta el siguiente comando en el directorio raíz del proyecto:

npx tailwindcss init

Esto creará un archivo tailwind.config.js con la configuración básica.

Estructura básica

La siguiente es la estructura de un archivo tailwind.config.js típico:

Ejemplo

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js,vue}"], // Definir las rutas de archivos de plantilla que se deben escanear
  theme: {
    extend: {}, // Extensión personalizada
  },
  plugins: [], // Configurar plugins
}

El código anterior le indica a Tailwind CSS que escanee todos los archivos .html, .js y .vue en el directorio src.


Principales opciones de configuración

1. Configurar ruta de plantillas: content

En el archivo tailwind.config.js, la opción content se utiliza para especificar qué archivos debe escanear Tailwind CSS para recopilar nombres de clases.
content: [
  "./index.html", // 单文件路径
  "./src/**/*.{html,js,ts,jsx,tsx}", // 包含多个文件类型的路径
],

Esto le indicará a Tailwind CSS que escanee todos los archivos .html, .js, .ts, .jsx y .tsx en el directorio src.

El campo content se utiliza para especificar las rutas de los archivos de plantilla de Tailwind. Tailwind escaneará estos archivos para generar los estilos necesarios, reduciendo el tamaño del archivo CSS generado, ya que solo genera los estilos utilizados en los archivos de plantilla y evita que los estilos no utilizados se compilen en la salida final.

2. Personalizar tema: theme

En la sección theme, puedes definir colores, fuentes, espaciados, tamaños de borde, etc.

Por ejemplo, extender los colores predeterminados o agregar nuevos colores:

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

Esto agregará un nuevo color llamado cyan, que podrás usar en tu proyecto con nombres de clase como bg-cyan.

Opción de configuraciónDescripciónEjemplo
fontSizePersonalizar tamaño de fuentejavascript fontSize: { 'xs': '0.75rem', '4xl': '2.5rem', },
screensDefinir puntos de interrupción (diseño responsive)javascript screens: { 'sm': '640px', 'xl': '1280px', },
borderRadiusPersonalizar bordes redondeadosjavascript borderRadius: { 'lg': '1rem', 'xl': '1.5rem', },
extendExtender los valores predeterminados existentesjavascript extend: { colors: { danger: '#FF5A5F', }, },

Ejemplo

theme: {
  extend: {
    colors: {
      primary: '#1D4ED8',
      secondary: '#64748B',
    },
    spacing: {
      18: '4.5rem', // Agregar un espaciado de 4.5rem
    },
    fontSize: {
      '4xl': '2.5rem',
    },
    borderRadius: {
      'xl': '1.5rem',
    },
    screens: {
      '2xl': '1536px', // Agregar un nuevo punto de interrupción responsive
    },
  },
}

Define colores mediante theme.colors y haz referencia a ellos en los estilos.

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

Ejemplo

<div class="bg-brand text-brand-light">Custom Colors Example</div>

Pruébalo »

Activa el soporte de modo oscuro de Tailwind mediante darkMode.

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

Ejemplo

<div class="bg-background-light dark:bg-background-dark">
  Dark Mode Example
</div>

3. Configurar variantes: variants

La opción variants te permite definir qué estados (como hover, focus, etc.) deben incluirse en el CSS final.

Puedes extender o sobrescribir las variantes predeterminadas:

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

4. Usar plugins: plugins

La opción plugins te permite agregar clases de utilidad personalizadas.

Estos plugins pueden ser proporcionados oficialmente por Tailwind CSS o creados por la comunidad, con el siguiente formato:

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

Ejemplo de uso de plugins:

Ejemplo

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

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

Importar plugins de la comunidad:

Ejemplo

module.exports = {
  plugins: [
    require('@tailwindcss/forms'), // Plugin de estilos para formularios
    require('@tailwindcss/typography'), // Plugin de tipografía
  ],
}

Configuración de Tailwind CSS

De forma predeterminada, Tailwind busca el archivo tailwind.config.js en el directorio raíz del proyecto, donde puedes establecer la configuración que necesites:

Ejemplo

/** @type {import('tailwindcss').Config} */
module.exports = {
  // Especifica de qué archivos Tailwind CSS debe extraer los nombres de clase. Aquí se configura para extraer de todos los archivos `.html` y `.js` en el directorio `./src`.
  content: ['./src/**/*.{html,js}'],

  theme: {
    // Configuración de colores personalizados
    colors: {
      'blue': '#1fb6ff', // Define un color llamado 'blue' con el valor #1fb6ff
      'purple': '#7e5bef', // Define un color llamado 'purple' con el valor #7e5bef
      'pink': '#ff49db', // Define un color llamado 'pink' con el valor #ff49db
      'orange': '#ff7849', // Define un color llamado 'orange' con el valor #ff7849
      'green': '#1370CE', // Define un color llamado 'green' con el valor #1370CE
      'yellow': '#ffc82c', // Define un color llamado 'yellow' con el valor #ffc82c
      'gray-dark': '#273444', // Define un color llamado 'gray-dark' con el valor #273444
      'gray': '#8492a6', // Define un color llamado 'gray' con el valor #8492a6
      'gray-light': '#d3dce6' // Define un color llamado 'gray-light' con el valor #d3dce6
    },
    // Configuración de familias de fuentes personalizadas
    fontFamily: {
      sans: ['Graphik', 'sans-serif'], // Define una familia de fuentes llamada 'sans', que incluye 'Graphik' y la genérica 'sans-serif'
      serif: ['Merriweather', 'serif'] // Define una familia de fuentes llamada 'serif', que incluye 'Merriweather' y la genérica 'serif'
    },
    // Configuración de extensión personalizada
    extend: {
      // Extensión de espaciados personalizados
      spacing: {
        '8xl': '96rem', // Define un espaciado llamado '8xl' con el valor 96rem
        '9xl': '128rem' // Define un espaciado llamado '9xl' con el valor 128rem
      },
      // Extensión de bordes redondeados personalizados
      borderRadius: {
        '4xl': '2rem' // Define un borde redondeado llamado '4xl' con el valor 2rem
      }
    }
  },
}

La siguiente tabla enumera las opciones de configuración del archivo tailwind.config.js y sus instrucciones de uso:

Opción de configuraciónDescripciónValor predeterminadoEjemplo
contentConfigura las rutas de archivos de plantilla que Tailwind CSS debe escanear, para eliminar estilos no utilizados.['./src/**/*.{html,js,ts,jsx,tsx}']content: ["./src/**/*.html", "./src/**/*.vue"]
themeSe utiliza para definir y extender el sistema de diseño predeterminado de Tailwind, incluyendo colores, espaciados, fuentes, etc.extend: {}theme: { colors: { primary: '#3490dc' } }
extendSe utiliza para extender las opciones de configuración predeterminadas de Tailwind, en lugar de sobrescribir los valores predeterminados.{}extend: { colors: { primary: '#3490dc' } }
screensConfigura los puntos de interrupción responsive, determinando cuándo se aplican estilos específicos.{ sm: '640px', md: '768px', lg: '1024px', xl: '1280px' }screens: { '2xl': '1536px' }
colorsPersonaliza o extiende la paleta de colores.Proporciona una serie de colores de forma predeterminada, comoblue, red, greenesperarcolors: { primary: '#1D4ED8', secondary: '#64748B' }
spacingConfigura el margen y el padding (p, m, pt, mtetc.).Proporciona unidades de forma predeterminada, como0.5rem, 1rem, 2remesperarspacing: { 18: '4.5rem' }
fontFamilyPersonaliza las familias de fuentes.'sans', 'serif', 'mono'fontFamily: { sans: ['Inter', 'sans-serif'] }
fontSizePersonaliza los tamaños de fuente.'sm': '0.875rem', 'lg': '1.125rem'fontSize: { '4xl': '2.5rem' }
fontWeightPersonaliza los grosores de fuente.'normal', 'bold', 'bolder', 'lighter'fontWeight: { 'light': '300', 'bold': '700' }
lineHeightConfigura la altura de línea.'none': '1', 'tight': '1.25', 'normal': '1.5', 'loose': '2'lineHeight: { 'relaxed': '1.75', 'loose': '2' }
borderRadiusConfigura el radio de los bordes redondeados.'none': '0px', 'sm': '0.125rem', 'md': '0.375rem', 'lg': '0.5rem'borderRadius: { 'xl': '1.5rem' }
borderWidthConfigura el ancho de los bordes.{ default: '1px', '0': '0', '2': '2px' }borderWidth: { '3': '3px' }
zIndexConfiguraz-indexel nivel de z-index.{ '0': '0', '10': '10', '20': '20' }zIndex: { 'max': '9999' }
opacityConfigura los valores de opacidad.{ '0': '0', '25': '0.25', '50': '0.5', '75': '0.75', '100': '1' }opacity: { '40': '0.4' }
boxShadowConfigura las sombras de caja (box-shadow).{ 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)' }
containerConfigura el ancho máximo del contenedor (para diseño responsive).{ center: false, padding: '2rem' }container: { center: true, padding: '1rem' }
aspectRatioConfigura la relación de aspecto de los elementos.{ 'none': 'none' }aspectRatio: { '16/9': '16/9' }
gridTemplateColumnsConfigura la plantilla de columnas de CSS Grid.{ auto: 'auto', '1fr': '1fr' }gridTemplateColumns: { 'layout': 'repeat(3, 1fr)' }
gridColumnConfigura el comportamiento de expansión de columnas de los elementos Grid.{ 'span-1': 'span 1 / span 1' }gridColumn: { 'span-2': 'span 2 / span 2' }
transitionPropertyConfigura las propiedades de transición.{ all: 'all' }transitionProperty: { 'color': 'color' }
transitionDurationConfigura la duración de las transiciones.{ 75: '75ms', 150: '150ms', 300: '300ms' }transitionDuration: { '400': '400ms' }
transitionTimingFunctionConfigura la función de temporización (timing function) de las transiciones.{ 'ease': 'ease', 'linear': 'linear' }transitionTimingFunction: { 'ease-out': 'ease-out' }

A través de tailwind.config.js, puedes personalizar fácilmente las funcionalidades y estilos de Tailwind CSS para adaptarte a diversas necesidades de diseño. Aprovechar adecuadamente características como la extensión (extend), los plugins (plugins) y la configuración del tema (theme) puede mejorar significativamente la eficiencia de desarrollo y la flexibilidad de estilos del proyecto.

Otras extensiones