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
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ón | Descripción | Ejemplo |
|---|---|---|
fontSize | Personalizar tamaño de fuente | javascript fontSize: { 'xs': '0.75rem', '4xl': '2.5rem', }, |
screens | Definir puntos de interrupción (diseño responsive) | javascript screens: { 'sm': '640px', 'xl': '1280px', }, |
borderRadius | Personalizar bordes redondeados | javascript borderRadius: { 'lg': '1rem', 'xl': '1.5rem', }, |
extend | Extender los valores predeterminados existentes | javascript extend: { colors: { danger: '#FF5A5F', }, }, |
Ejemplo
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',
},
},
},
}
Activa el soporte de modo oscuro de Tailwind mediante darkMode.
module.exports = {
darkMode: 'class', // 或 'media'
theme: {
extend: {
colors: {
background: {
light: '#FFFFFF',
dark: '#000000',
},
},
},
},
}
Ejemplo
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
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
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
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ón | Descripción | Valor predeterminado | Ejemplo |
|---|---|---|---|
| content | Configura 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"] |
| theme | Se utiliza para definir y extender el sistema de diseño predeterminado de Tailwind, incluyendo colores, espaciados, fuentes, etc. | extend: {} | theme: { colors: { primary: '#3490dc' } } |
| extend | Se utiliza para extender las opciones de configuración predeterminadas de Tailwind, en lugar de sobrescribir los valores predeterminados. | {} | extend: { colors: { primary: '#3490dc' } } |
| screens | Configura 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' } |
| colors | Personaliza o extiende la paleta de colores. | Proporciona una serie de colores de forma predeterminada, comoblue, red, greenesperar | colors: { primary: '#1D4ED8', secondary: '#64748B' } |
| spacing | Configura el margen y el padding (p, m, pt, mtetc.). | Proporciona unidades de forma predeterminada, como0.5rem, 1rem, 2remesperar | spacing: { 18: '4.5rem' } |
| fontFamily | Personaliza las familias de fuentes. | 'sans', 'serif', 'mono' | fontFamily: { sans: ['Inter', 'sans-serif'] } |
| fontSize | Personaliza los tamaños de fuente. | 'sm': '0.875rem', 'lg': '1.125rem' | fontSize: { '4xl': '2.5rem' } |
| fontWeight | Personaliza los grosores de fuente. | 'normal', 'bold', 'bolder', 'lighter' | fontWeight: { 'light': '300', 'bold': '700' } |
| lineHeight | Configura la altura de línea. | 'none': '1', 'tight': '1.25', 'normal': '1.5', 'loose': '2' | lineHeight: { 'relaxed': '1.75', 'loose': '2' } |
| borderRadius | Configura el radio de los bordes redondeados. | 'none': '0px', 'sm': '0.125rem', 'md': '0.375rem', 'lg': '0.5rem' | borderRadius: { 'xl': '1.5rem' } |
| borderWidth | Configura el ancho de los bordes. | { default: '1px', '0': '0', '2': '2px' } | borderWidth: { '3': '3px' } |
| zIndex | Configuraz-indexel nivel de z-index. | { '0': '0', '10': '10', '20': '20' } | zIndex: { 'max': '9999' } |
| opacity | Configura los valores de opacidad. | { '0': '0', '25': '0.25', '50': '0.5', '75': '0.75', '100': '1' } | opacity: { '40': '0.4' } |
| boxShadow | Configura 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)' } |
| container | Configura el ancho máximo del contenedor (para diseño responsive). | { center: false, padding: '2rem' } | container: { center: true, padding: '1rem' } |
| aspectRatio | Configura la relación de aspecto de los elementos. | { 'none': 'none' } | aspectRatio: { '16/9': '16/9' } |
| gridTemplateColumns | Configura la plantilla de columnas de CSS Grid. | { auto: 'auto', '1fr': '1fr' } | gridTemplateColumns: { 'layout': 'repeat(3, 1fr)' } |
| gridColumn | Configura el comportamiento de expansión de columnas de los elementos Grid. | { 'span-1': 'span 1 / span 1' } | gridColumn: { 'span-2': 'span 2 / span 2' } |
| transitionProperty | Configura las propiedades de transición. | { all: 'all' } | transitionProperty: { 'color': 'color' } |
| transitionDuration | Configura la duración de las transiciones. | { 75: '75ms', 150: '150ms', 300: '300ms' } | transitionDuration: { '400': '400ms' } |
| transitionTimingFunction | Configura 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