Instalación de Tailwind CSS (NPM)
Antes de comenzar, asegúrate de tener Node.js y npm instalados. Puedes comprobar si están instalados con los siguientes comandos:
node -v npm -v
Si tu sistema aún no es compatible con Node.js y NPM, puedes consultar nuestroTutorial de Node.js。
En China, usar npm puede ser muy lento. Puedes usar la herramienta de línea de comandos cnpm (compatible con compresión gzip) personalizada por Taobao en lugar del npm predeterminado:
$ npm install -g cnpm --registry=https://registry.npmmirror.com $ npm config set registry https://registry.npmmirror.com
De esta manera, puedes usar el comando cnpm para instalar módulos:
$ cnpm install [name]
Para más información, consulta:http://npm.taobao.org/。
Instalar Tailwind CSS 3
Este capítulo trata sobre la instalación de Tailwind CSS 3. El método de instalación de Tailwind CSS 4 ha cambiado: detecta automáticamente archivos como HTML y JavaScript, evitando la molestia de configurar manualmente las fuentes de contenido.
Para más detalles, consulta:Instalación de Tailwind CSS 4。
Instalación mediante npm. Instala y configura Tailwind CSS en tu proyecto local:
npm install -D tailwindcss npx tailwindcss init
Después de ejecutar el comando anterior, se generará un archivo de configuración básico tailwind.config.js para personalizarlo.
Configurar la ruta de las plantillas
A continuación, podemos añadir la ruta de las plantillas en el archivo tailwind.config.js:
Código del archivo tailwind.config.js:
module.exports = {
content: ["./src/**/*.{html,js}"], // Ajústalo según los tipos de archivo reales del proyecto
theme: {
extend: {},
},
plugins: [],
}
Añadir las directivas de Tailwind al archivo CSS
En tu archivo CSS principalsrc/input.css(si no existe, créalo) añade cada módulo de funcionalidad de Tailwind mediante la directiva @tailwind.
Código del archivo src/input.css:
@tailwind components;
@tailwind utilities;
Iniciar el proceso de compilación de Tailwind CLI
Ejecuta la herramienta CLI para escanear las clases en los archivos de plantilla y compilar el CSS.npx tailwindcss -i ./src/input.css -o ./src/output.css --watch
Usar Tailwind en HTML
Añade el archivo CSS compilado dentro de la etiqueta <head> y luego podrás comenzar a usar las clases de utilidad de Tailwind para dar estilo a tu contenido.
Código del archivo src/index.html:
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="./output.css" rel="stylesheet">
</head>
<body>
<h1 class="text-3xl font-bold underline">
Hello world!
</h1>
</body>
</html>
Los pasos anteriores se aplican a la mayoría de los proyectos frontend modernos, ya sea que uses Vue, React u otros frameworks. Asegúrate de incluir el archivo CSS compilado en el proceso de compilación para que los estilos de Tailwind CSS se apliquen correctamente a tu proyecto.
Usar PostCSS
Instalar Tailwind CSS como un plugin de PostCSS es la mejor manera de integrarlo sin problemas con herramientas de compilación como webpack, Rollup, Vite y Parcel.
1. Instalar Tailwind CSS
Instala Tailwind CSS y sus dependencias relacionadas mediante npm, y genera el archivo de configuración tailwind.config.js.
npm install -D tailwindcss postcss autoprefixer npx tailwindcss init
2. Añadir Tailwind a la configuración de PostCSS
En el archivo postcss.config.js del proyecto, añade los plugins tailwindcss y autoprefixer.
Código del archivo postcss.config.js:
plugins: {
tailwindcss: {},
autoprefixer: {},
}
}
3. Configurar la ruta de las plantillas
En el archivo tailwind.config.js, añade las rutas de todos los archivos de plantilla para que Tailwind CSS pueda generar los estilos necesarios a partir de ellos.
Código del archivo tailwind.config.js:
module.exports = {
content: ["./src/**/*.{html,js}"], // Reemplaza con las rutas reales de plantillas del proyecto
theme: {
extend: {},
},
plugins: [],
}
4. Añadir las directivas de Tailwind en el archivo CSS
En el archivo CSS principal, añade las siguientes tres directivas centrales de Tailwind para incluir estilos base, estilos de componentes y estilos de clases de utilidad.
Código del archivo main.css:
@tailwind components;
@tailwind utilities;
5. Iniciar el proceso de compilación
Inicia el proceso de compilación del proyecto mediante npm run dev u otros comandos configurados en el archivo package.json.
npm run dev
6. Usar Tailwind CSS en HTML
Asegúrate de que el archivo CSS compilado se incluya correctamente en la etiqueta <head> (algunos frameworks pueden hacerlo automáticamente) y luego comienza a usar las clases de utilidad proporcionadas por Tailwind CSS en HTML para estilizar el contenido.
Código del archivo index.html:
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="/dist/main.css" rel="stylesheet"> <!-- Incluir el archivo CSS compilado -->
</head>
<body>
<h1 class="text-3xl font-bold underline">
Hello world!
</h1>
</body>
</html>