Tailwind v2 安装与编译
Tailwind 一般通过 npm 安装,以模块引入项目中,并需要经过编译后才可以使用。
安装
# Using npm
npm install tailwindcss
# Using Yarn
yarn add tailwindcss
引入 Tailwind
将 Tailwind 基础类引入到项目的样式表中,如项目的样式在 src/styles.css
文档中
@tailwind base;
@tailwind components;
@tailwind utilities;
Tip
如果使用 postcss 插件或其他打包工具,如 webpack,则使用 @import
关键字导入
@import "tailwindcss/base";
@import "tailwindcss/components";
@import "tailwindcss/utilities";
创建 Tailwind 配置文件
可以在配置文件 tailwind.config.js
中增添或修改覆写原有的基础类(⚠️ 但不建议修改原有的基础类)在终端输入以下命令即可创建该配置文件:
npx tailwindcss init
// 在该文档中配置 tailwind
module.exports = {
future: {},
purge: [],
theme: {
extend: {},
},
variants: {},
plugins: [],
}
Tip
Tailwind 的配置文件虽然是可选的,但强烈建议在初始化项目时创建该文件,VS Code 插件 Tailwind CSS IntelliSense 需要项目中存在该文件才启动。
Tip
如果需要将所有预设的基础类列出到配置文件中,可以在终端命令添加 --full
指令,然后可以参照原有的基础类,添加定制的基础类
npx tailwindcss init --full
Tip
虽然 Tailwind 提供 CDN 方式载入,但强烈不建议使用,因为无法使用很多 Tailwind 的功能,而且最重要的是无法定制基础类。
编译
有多种方式编译 tailwind 生成 CSS 样式表文档
- 使用 PostCSS 插件
Tip
需要在终端输入
npm install postcss-cli
安装相应的 CLI,具体配置和编译流程可参考教程 Setting up Tailwind and PostCSS 或官方文档 PostCSS documentation 在项目中创建 post-css 配置文档postcss.config.jsjsmodule.exports = { plugins: [ // ... require('tailwindcss'), require('autoprefixer'), // 可以添加其他的 CSS 插件 // ... ] }
- 使用 Tailwind CLI
所安装的 Tailwind 模块已内置 CLI,可用于编译bashnpx tailwindcss build styles.css -o output.css
- 使用打包工具,如 Webpack
Tip
可以将编译代码整合为 npm script,如使用 Tailwind CLI 编译,可以在 package.json
中添加相应的命令
// 样式表源代码在文档 src/styles.css 中
// 编译生成的代码在 public/styles.css 中
{
// ...
"scripts": {
"build-css": "tailwindcss build src/styles.css -o public/styles.css"
},
}
Warning
当配置文件和原始的 style.css
等文件修改后需要经过编译才可生效。