光速入门 Tailwind CSS

卡列尼娜翠花2024-07-05 6:03

文章目录

Tailwind CSS 中文网
Tailwind Play

入门

安装

三种使用方式：

  1. cli
  2. 结合 postcss
  3. cdn

cli 方式就和命令行使用 scss、tsc 这些工具一样，需要手动执行监听文件改变的命令，实时编译。这种方式只适合做 demo 时的简单使用。

想要正儿八经的使用，比如和构建工具结合，就要搭配 postcss 一起使用。

bash 复制代码 
pnpm install -D tailwindcss postcss autoprefixer

pnpm tailwindcss init --postcss

tailwindcss 初始化后会生成 postcss 和 tailwindcss 的配置文件。

然后在 tailwindcss.config.js 的 content 选项中配置需要编译的模版文件路径。

javascript 复制代码 
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js}"],
  theme: {
    extend: {},
  },
  plugins: [],
}

将指令添加到主 css 文件：

css 复制代码 
@tailwind base;
@tailwind components;
@tailwind utilities;

此时会出现 css 无法识别 tailwind 指令的问题。

解决办法：
解决 vscode Unknown at rule @xxx 的警告

IDE 设置

vscode 安装 tailwind 插件可以获得提示和高亮。并且官方提供了一个 Prettier 插件，它会自动按照官方推荐的类顺序对你写的类进行排序。

bash 复制代码 
pnpm add -D prettier prettier-plugin-tailwindcss
bash 复制代码 
{
    "plugins": [
        "prettier-plugin-tailwindcss"
    ]
}

注意：项目中声明了 prettier 的配置文件的，那 vscode settings.json 中的 prettier 配置就会被覆盖。

所以项目中的配置文件除了声明使用 prettier-plugin-tailwindcss 插件外，还要补充其他额外的配置。除非你起初使用的 prettier 配置就是 prettier 默认的配置。

另外配置文件可能出现 json schema 验证失败的问题。
解决"无法从"https://json.schemastore.org/xxx"加载架构"的问题

使用预编译器

由于 Tailwind 是一个 PostCSS 插件，没有什么能阻止你将它与 Sass、Less、Stylus 或其他预处理器一起使用。

虽然可以，但非常不建议和预编译器一起使用。

当需要使用某些预编译器的功能时，你应该高度考虑依赖其他 PostCSS 插件来添加你使用的预处理器功能，而不是使用单独的 预处理器。

预编译器最常见的几个功能：

  1. css 拆分成多个文件导入
  2. 选择器嵌套
  3. 变量
  4. 浏览器前缀

这 4 个功能对应的 postcss 解决方案：

  1. postcss 插件：postcss-import
    1. 安装使用。
  2. 官方基于 postcss-nested（默认） 或 postcss-nesting 封装的插件：tailwindcss/nesting
    1. 已经内置，可直接使用，并且可配置应用哪个postcss-nesting 插件。不过需要安装使用。
    2. 如果使用了 postcss 预设： postcss-preset-env。则要手动关掉预设中的嵌套功能，让官方的嵌套插件生效。
  3. 直接使用 css 变量
  4. postcss 插件：autoprefixer
    1. 安装使用，并且添加在插件末尾使用。其实 init 时，已经添加在末尾。

postcss-import 它严格遵守 CSS 规范， @import 语句必须在第一行使用。

这个问题容易在两个地方忽视：一是和常规 CSS 写在一起时，二是和 tailwind 主 css 文件写在一起时。

无论是 .box {} 这样的常规 CSS 还是 @tailwind 指令，@import 都必须写在第一行。

为了解决这个容易忽视的问题，最好的办法就是拆成单独文件写。

css 复制代码 
/* components.css */
@import "./components/buttons.css";
@import "./components/card.css";
css 复制代码 
/* components/buttons.css */
.btn {
  padding: theme('spacing.4') theme('spacing.2');
  /* ... */
}

使用 postcss-nesting 作为嵌套实现，并关闭 postcss 预设插件中的嵌套功能：

javascript 复制代码 
// postcss.config.js
module.exports = {
  plugins: {
    'postcss-import': {},
    'tailwindcss/nesting': 'postcss-nesting',
    tailwindcss: {},
    'postcss-preset-env': {
      features: { 'nesting-rules': false },
    },
  }
}

总结 postcss 配置：

bash 复制代码 
pnpm add -D postcss-import

pnpm add -D autoprefixer
javascript 复制代码 
export default {
    plugins: {
        "postcss-import": {},
        "tailwindcss/nesting": {},
        tailwindcss: {},
        autoprefixer: {}
    }
};

硬要和预编译器一起使用，具体参考文档。

生产环境优化

对于尽可能小的生产构建，我们建议使用 cssnano 等工具缩小 CSS，并使用 Brotli 压缩 CSS。

如果你使用的是 Tailwind CLI，则可以通过添加 --minify 标志来缩小 CSS：

bash 复制代码 
npx tailwindcss -o build.css --minify

如果你已将 Tailwind 安装为 PostCSS 插件，请将 cssnano 添加到插件列表的末尾：

javascript 复制代码 
module.exports = {
  plugins: {
    tailwindcss: {},
    autoprefixer: {},
    ...(process.env.NODE_ENV === 'production' ? { cssnano: {} } : {})
  }
}

如果你使用的是框架，请查看文档，因为这通常会在生产中自动为你处理，你甚至不需要对其进行配置。

基础概念

分层

首先我们要明白，tailwind 能通过类的方式来写样式，是因为它已经提供了这些写好了 css 的类。并且 tailwind 把这些类分成了三层。

Tailwind 将其生成的样式组织成三个不同的 "layers" --- 这是 ITCSS 推广的概念。

  • base 层用于重置规则或应用于纯 HTML 元素的默认样式。
  • components 层用于你希望能够使用工具覆盖的基于类的样式。
  • utilities 层用于小型、单一用途的类，这些类应始终优先于任何其他样式。

ITCSS（Inverted Triangle CSS）是一种CSS架构方法，它通过将CSS代码组织成一系列层次来提高CSS的可维护性和可扩展性。这些层次从宽泛的、全局的设置到非常具体、局部的样式，形成一个倒三角形的结构。

每一层都有其明确的职责，如下：

  1. Settings：包含设计中的变量，如颜色、字体和断点。
  2. Tools：包含辅助函数、混合宏和实用工具类。
  3. Generic：包含重置、标准化样式和排版规则。
  4. Base：包含元素的样式，如按钮、表单和网格系统。
  5. Objects：包含设计中的布局模式，如媒体对象和列表。
  6. Components：包含更复杂的功能模块，如按钮组、轮播和导航。
  7. Utilities：包含最具体的设计调整，如间距、文本样式和可见性。

ITCSS的目标是通过限制CSS的特异性、减少依赖性、避免重叠和冲突，以及提供清晰的代码组织结构，来创建一个易于管理和扩展的CSS代码库。这种方法特别适合大型项目和团队协作，因为它有助于确保一致性和减少不必要的复杂性。

指令

tailwind 总共就提供了 4 个指令。

@tailwind

@tailwind 指令就像是导入语句 import，将 Tailwind 提供的 base、components、utilities 和 variants 样式插入到你的 CSS 中。

@layer

自定义样式的时候，我们可能会添加一些自定义类。@layer 指令就是用来告诉 tailwind 这些自定义的类应该属于三层中的哪一层，tailwind 你要按这一层的规矩管理它。

css 复制代码 
@tailwind base;
@tailwind components;
@tailwind utilities;

@layer base {
  h1 {
    @apply text-2xl;
  }
  h2 {
    @apply text-xl;
  }
}

@layer components {
  .btn-blue {
    @apply bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded;
  }
}

@layer utilities {
  .filter-none {
    filter: none;
  }
  .filter-grayscale {
    filter: grayscale(100%);
  }
}

@apply

@apply 指令如上所示，就是可以在自定义的 css 中使用 tailwind 提供的类。而且它不仅仅局限于 tailwind 提供的类，自定义的类也可以提取其中的样式进行复用。

  • 不过要注意：从类中提取的样式会删掉 !important。
css 复制代码 
@layer base {
  h1 {
    @apply text-2xl;
  }
}
css 复制代码 
.foo {
  color: blue !important;
}

.bar {
  @apply foo;
}

还有一点，就是 @apply 指令在 Vue 组件中无法提取应用其他 css 文件中自定义的类。比如在主 css 文件 main.css 中自定义了一个 card 类，在组件中无法 @apply 应用 card 类。

这是因为每个 Vue 组件中

解决办法是在 tailwind 插件中添加自定义的 css 类，这样就能全局共享了。

javascript 复制代码 
const plugin = require('tailwindcss/plugin')

module.exports = {
  // ...
  plugins: [
    plugin(function ({ addComponents, theme }) {
      addComponents({
        '.card': {
          backgroundColor: theme('colors.white'),
          borderRadius: theme('borderRadius.lg'),
          padding: theme('spacing.6'),
          boxShadow: theme('boxShadow.xl'),
        }
      })
    })
  ]
}

但老实说，最好的解决办法就是根本不做这种奇怪的事情。因为你完全可以在 html 模版上写类，压根不需要

@config

@config 指令指定 Tailwind 在编译该 CSS 文件时应使用哪个配置文件。这对于需要为不同的 CSS 入口点使用不同的配置文件的项目很有用。

你提供给 @config 指令的路径是相对于该 CSS 文件的，并且将优先于 PostCSS 配置或 Tailwind CLI 中定义的路径。

javascript 复制代码 
@config "./tailwind.admin.config.js";

@tailwind base;
@tailwind components;
@tailwind utilities;
javascript 复制代码 
@config "./tailwind.site.config.js";

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

函数

Tailwind 添加了一些自定义函数，用来在自定义样式时，在 css 中获取 tailwind 提供的样式中的一些值。比如使用 tailwind 提供的间距，颜色等。

theme()

theme() 读取 tailwind 类中的样式。使用.表示法读取值。

  • 如果类中就带了点，避免歧义使用[]获取
css 复制代码 
.content-area {
  height: calc(100vh - theme(spacing.12));
}

.content-area {
  height: calc(100vh - theme(spacing[2.5]));
}
  • 访问嵌套颜色值时不要使用破折号语法，要把破折号换成点
css 复制代码 
/* 错误 */
.btn-blue {
  background-color: theme(colors.blue-500);
}

/* 正确 */
.btn-blue {
  background-color: theme(colors.blue.500);
}
  • 要调整使用 theme 检索到的颜色的透明度，请使用斜杠后跟你要使用的透明度值：
css 复制代码 
.btn-blue {
  background-color: theme(colors.blue.500 / 75%);
}

screen()

screen() 复用 tailwind 提供的断点，直接在媒体查询中使用。当想要媒体查询时，不用自己去查看 tailwind 编译的断点结构，然后复制使用。

css 复制代码 
/* 自己手写 */
@media (min-width: 640px) {
  /* ... */
}

/* 直接用 tailwind 的断点修饰符 */
@media screen(sm) {
  /* ... */
}

基础案例

tailwind 默认提供了样式重置。

怎么设置属性任意值？

所有的任意值，也可以说自定义的属性值，都是用[]包裹标记。

比如想要设置背景颜色为 #123456，bg-[#123456]。并且能自动区分，如text-[2em]是文字大小，text-[#123456]是文字颜色。

若是 tailwind 没有提供的属性，则全用[]包裹。如文字阴影：[text-shadow:0_3rem_#fff]

在[]中，多个属性值之间的空格用_代替。[]中其实就相当于直接写 css 属性值，所以也支持 css 的函数。如 var、calc。
text-[var(--color)]
hover:shadow-[0_0_25px_var(--color),0_0_100px_var(--color)]

hover 父元素时，怎么选中子元素添加样式？

group 标记父元素，然后 group:hover: 给子元素设置样式。如group:hover:text-red。

其他的，如兄弟选择器等，看文档。

添加 animation 动画

tailwind 默认提供了 4 个动画，分别是：

  1. spin 旋转
  2. ping 放大并透明，爆开的效果
  3. pulse 脉动，呼吸灯一样的效果
  4. bounce 弹跳
html 复制代码 
<div class="animation-pulse">ikun</div>

显然这些动画是不够的，要自定义 animation 动画，则要去配置文件中配置 keyframes。并且可以在 animation 选项中像使用 css 一样声明使用 keyframes 动画。这样就可以以 animation-xxx 原子类的方式在 html 中使用动画了。

  • 注意所有的配置都是 js 对象写法。
typescript 复制代码 
module.exports = {
  theme: {
    extend: {
      keyframes: {
        wiggle: {
          '0%, 100%': { transform: 'rotate(-3deg)' },
          '50%': { transform: 'rotate(3deg)' },
        }
      },
      animation: {
        wiggle: 'wiggle 1s ease-in-out infinite',
      }
    }
  }
}
html 复制代码 
<div class="animation-wiggle">ikun</div>

如果不想在 animation 选项中配置出对应的动画工具类，也可以通过animation-[]在 html 中像 css 那样使用：

html 复制代码 
<span 
  style="--i: 123" 
  class="
  inline-block 
  animate-[floatDown_0.3s_calc(var(--i)*50ms)_ease] 
  group-hover:animate-[floatUp_0.3s_ease_calc(var(--i)*50ms)_forwards]"
  >
  ikun
</span>

注意：inline 元素如 span 无法应用动画，要改成 block 或者 inline-block。

配置主题

tailwind 允许在配置文件中配置主题。其实主要是两块内容：

  1. 修改或覆盖 tailwind 提供的主题。比如修改 tailwind 默认提供的断点分界线
  2. 扩展工具类，extend。

如果你想保留主题选项的默认值，但还想添加新值，请在配置文件中的 theme.extend 键下添加扩展。该键下的值将与现有的 theme 值合并，并自动成为可供你使用的新类。

例如，这里我们扩展 fontFamily 属性以添加 font-display 类，该类可以更改元素上使用的字体：

typescript 复制代码 
/** @type {import('tailwindcss').Config} */
module.exports = {
  theme: {
    extend: {
      fontFamily: {
        display: 'Oswald, ui-serif', // Adds a new `font-display` class
      }
    }
  }
}

将其添加到主题后，你可以像任何其他字体系列工具一样使用它：

html 复制代码 
<h1 class="font-display">
  This uses the Oswald font
</h1>

扩展屏幕断点：

typescript 复制代码 
/** @type {import('tailwindcss').Config} */
module.exports = {
  theme: {
    extend: {
      screens: {
        '3xl': '1600px', // Adds a new `3xl:` screen variant
      }
    }
  }
}
html 复制代码 
<blockquote class="text-base md:text-md 3xl:text-lg">
  Oh I gotta get on that internet, I'm late on everything!
</blockquote>
相关推荐
学不会•2 小时前
css数据不固定情况下，循环加不同背景颜色
前端·javascript·html
活宝小娜4 小时前
vue不刷新浏览器更新页面的方法
前端·javascript·vue.js
程序视点4 小时前
【Vue3新工具】Pinia.js：提升开发效率，更轻量、更高效的状态管理方案！
前端·javascript·vue.js·typescript·vue·ecmascript
coldriversnow4 小时前
在Vue中，vue document.onkeydown 无效
前端·javascript·vue.js
我开心就好o4 小时前
uniapp点左上角返回键, 重复来回跳转的问题 解决方案
前端·javascript·uni-app
开心工作室_kaic5 小时前
ssm161基于web的资源共享平台的共享与开发+jsp(论文+源码)_kaic
java·开发语言·前端
刚刚好ā5 小时前
js作用域超全介绍--全局作用域、局部作用、块级作用域
前端·javascript·vue.js·vue
沉默璇年7 小时前
react中useMemo的使用场景
前端·react.js·前端框架
yqcoder7 小时前
reactflow 中 useNodesState 模块作用
开发语言·前端·javascript
2401_882727577 小时前
BY组态-低代码web可视化组件
前端·后端·物联网·低代码·数学建模·前端框架
热门推荐
01(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明02PyTorch机器学习实现液态神经网络03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04玄机平台应急响应—webshell查杀05Coze扣子平台完整体验和实践（附国内和国际版对比）06Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO07【目标跟踪】相机运动补偿08Unity中PICO实现 隔空取物 和 接触抓取物体09RAG 实践- Ollama+RagFlow 部署本地知识库10怎样让音频速度变慢？请跟随以下方法进行操作