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:

/** @type {import('tailwindcss').Config} */
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 base;
@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:

<!doctype 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:

module.exports = {
  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:

/** @type {import('tailwindcss').Config} */
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 base;
@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:

<!doctype 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>
Otras extensiones