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

背景

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

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

目标

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

使用步骤

| 💡 对于现代化前端开发,webpack、vite、rollup 这些前端构建工具是必须的;使用PostCSS插件是构建工具和 TailwindCSS 结合的最佳选择。

1. 安装 TailwindCSS & PostCSS

jsx 复制代码
npm install -D tailwindcss tailwindcss postcss autoprefixer

2. 初始化 TailwindCSS 配置文件

jsx 复制代码
npx tailwindcss init

3. 配置 TailwindCSS 扫描范围

| 📌 由于 TailwindCSS 的工作原理是扫描指定范围内所有的文件,获取到文件中CSS class类,基于TailwindCSS 内置预设的规则以及用户自定义的规则,最终生成一份 CSS 文件。

那么重点来了!!!

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

  • React:"./src/**/*.{js,jsx,ts,tsx}"
  • Vue: "./src/**/*.{vue,js,ts,jsx,tsx}"
  • Svelte: "./src/**/*.{svelte,js,ts,jsx,tsx}"
jsx 复制代码
/** @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,并添加如下配置;

jsx 复制代码
// postcss.config.js

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

5. 构建工具集成 PostCSS插件(让PostCSS插件开始工作)

| 📌 Vite、Create react app 内部集成了postcss插件,可以忽略这一步

  • Rspack
jsx 复制代码
/**
 * @type {import('@rspack/cli').Configuration}
 */

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          {
            loader: "postcss-loader",
          },
        ],
        type: "css",
      },
    ],
  }
};
  • webpack
jsx 复制代码
module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          "style-loader",
          "css-loader",
          {
            loader: "postcss-loader"
          },
        ],
      },
    ],
  },
};

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

jsx 复制代码
// index.css

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

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

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

jsx 复制代码
npm run dev

使用效果

使用TailwindCSS 画一个正方形

jsx 复制代码
<div className='border border-lime-600 w-32 h-32'></div>

总结

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

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

相关原创文章

相关推荐
Captaincc2 小时前
AI用量v0.1.11更新发布 新增 jusage doctor 诊断指令 托盘展示token 和余额 新增 AutoClaw 支持
前端·后端·vibecoding
计算机魔术师4 小时前
德国Wiki被黑后两周,OpenAI终于把模型失控的账本摊开了
前端
kyriewen4 小时前
我让 AI 当面试官面了我一轮:第 3 个追问我就卡住了(附 10 道追问清单)
前端·面试·ai编程
IT_陈寒5 小时前
Python的GIL把我坑惨了,多线程跑得比单线程还慢
前端·人工智能·后端
前端snow5 小时前
ai agent --- 多agent框架之图编排引擎-langgraph
前端
竹林8185 小时前
OmniPic Studio v3.2.1 核心技术架构与全平台发版解析文档
前端·浏览器
JamesZhang800785 小时前
页面内存只涨不跌? 一次泄漏排查, 牵出 WeakMap 的诞生
前端
Z小明5 小时前
第 6 章 组件进阶
前端·vue.js
江华森5 小时前
HTTP请求的完整过程详解:从DNS解析到TCP挥手的微秒级实战分析
前端
南青5 小时前
Vue 3 中后台实战:我踩过的 10 个坑和最佳实践
前端