React/Vue/Svelte 前端项目中开始使用TailwindCSS

2023-12-13 03:44:19

背景

TailwindCSS 近年来在前端圈非常流行，它摆脱了原有的CSS限制，以灵活实用为卖点，用户通过各种class组合即可构建出漂亮的用户界面。对于初学者而言，可能需要一些上手成本，一旦掌握实用技巧后，TailwindCSS会是我们开发工作中的出鞘利刃。

笔者参与开发的项目几乎全部支持TailwindCSS来完成需求开发，期间碰到过TailwindCSS相关的各种问题。于是想着把TailwindCSS的使用技巧和踩坑经验记录下来，分享给有需要的同学。

目标

初学者快速入门 TailwindCSS；
TailwindCSS 使用技巧和提效工具；
高效的问题定位和排查；
TailwindCSS 工作原理；

使用步骤

1. 安装 TailwindCSS & PostCSS

npm install -D tailwindcss tailwindcss postcss autoprefixer

2. 初始化 TailwindCSS 配置文件

npx tailwindcss init

3. 配置 TailwindCSS 扫描范围

那么重点来了!!!
对于不同前端技术栈的项目，比如 React、Vue、Svelte、Angular等等，我们只需要配置对应的文件扫描范围即可。其他的配置步骤都是相同的。

React："./src/**/*.{js,jsx,ts,tsx}"
Vue: "./src/**/*.{vue,js,ts,jsx,tsx}”
Svelte: "./src/**/*.{svelte,js,ts,jsx,tsx}"

/** @type {import('tailwindcss').Config} */
module.exports = {
	// 加载对应**构建工具**和**技术栈**的文件即可
  **content: ["./src/**/*.{html,js}"],**
  theme: {
    extend: {},
  },
  plugins: [],
}

如果你在html模板中也使用了 TailwindCSS 的样式类，那么 content 配置数组也需要添加 html 文件路径。

4. 配置 PostCSS

如果项目中之前已经使用了 PostCSS 插件，我们只需要在 postcss.config.js中添加 tailwindcss相关的配置；如果项目之前没有使用 PostCSS 插件，那我们需要在项目根路径创建文件postcss.config.js，并添加如下配置；

// postcss.config.js

module.exports = {
  plugins: {
    tailwindcss: {},
    autoprefixer: {},
  }
}

5. 构建工具集成 PostCSS插件（让PostCSS插件开始工作）

Rspack

/**
 * @type {import('@rspack/cli').Configuration}
 */

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          {
            loader: "postcss-loader",
          },
        ],
        type: "css",
      },
    ],
  }
};

webpack

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          "style-loader",
          "css-loader",
          {
            loader: "postcss-loader"
          },
        ],
      },
    ],
  },
};

6. 项目全局CSS文件中添加 TailwinCSS 依赖内容

// index.css

@tailwind base;
@tailwind components;
@tailwind utilities;

至此，我们完成了使用 TailwindCSS 的所有配置，接下来是如何使用 TailwindCSS 美化页面。

在此之前我们需要启动或者重启本地开发服务器

npm run dev

使用效果

使用TailwindCSS 画一个正方形

<div className='border border-lime-600 w-32 h-32'></div>

TailwindCSS 画正方形

总结

TailwindCSS 的开始步骤看着比较多，但是真正按照步骤动手启动可能只需要几分钟，更多的内容是我想跟大家分享具体的作用，也方便大家能够对 TailwindCSS 有个较为清晰的理解。

更多的 TailwindCSS 相关的内容分享，前往 TailwindCSS 使用指南