用途
tailwind-ops 是一套围绕 Tailwind CSS 的实用模式与配置指南,主题包括布局、响应式设计、组件模式、暗色模式、动画以及 v4 迁移。资料声明其中关于 Tailwind v4 生态的事实核验时间为 2026-07。
主要能力
布局决策
文档以决策树形式给出布局选择建议:单行或单列项目使用 Flexbox(如 class="flex items-center gap-4"、class="flex flex-col gap-4");二维网格使用 CSS Grid(如 class="grid grid-cols-3 gap-6"、响应式网格 class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6");需要按容器而非视口自适应时使用容器查询(v3.2+ / v4 原生);并给出多种居中方式与整页布局写法。
响应式设计
提供移动优先断点速查:sm: 640px、md: 768px、lg: 1024px、xl: 1280px、2xl: 1536px。示例包括移动端堆叠/平板两列/桌面三列、移动端隐藏桌面显示、移动端全宽桌面限宽等写法。
容器查询方面,父级声明 class="@container",子级使用 @sm:、@lg: 等;还可使用具名容器(如 @container/card 与 @md/card:text-lg)。
流体排版给出基于 clamp() 的写法示例,如 class="text-[clamp(1.5rem,4vw,3rem)]"。
暗色模式
给出策略决策树:手动切换(用户偏好存储)使用 class 策略(v3)/ selector 策略(v4);仅跟随系统偏好使用 media 策略;自定义选择器(如 data 属性)为 v4 selector 策略。文档列出 v3 与 v4 各自的配置写法,并给出背景/文字、卡片、输入框等暗色变体示例。
组件与状态修饰符
文档包含卡片、按钮变体、表单输入、导航栏、模态遮罩、徽章、警告等可复制片段,并附状态修饰符速查表(hover、focus、focus-visible、focus-within、active、disabled、group-hover、group-focus、peer-checked、peer-invalid、data-[state=open]、aria-expanded、aria-selected、open、first、last、odd、even、placeholder、motion-reduce、motion-safe、print),以及 group/peer 模式和具名 group 的示例。
Tailwind v4
列出 v3 到 v4 的主要变化:配置从 tailwind.config.js 变为 CSS-first @theme;主题值从 JS theme.extend.colors 变为 --color-brand: #3b82f6;;插件从 JS plugin() 变为 CSS 中 @plugin;配置文件可用 @config "./legacy.config.js"(兼容);PostCSS 包为 @tailwindcss/postcss;Vite 使用 @tailwindcss/vite;颜色支持 OKLCH;容器查询原生支持;入场动画可用 @starting-style。文档另给出 v4 新工具类示例(原生容器查询、@starting-style、锚点定位(实验性)、新的 shadow 与 ring 默认值)。
常见坑
列出动态类名不生效、样式被覆盖(specificity)、@apply 与组件库冲突、Prose 样式泄漏、生产环境缺少类、暗色模式闪烁(FOUC)、容器查询未限定作用域、任意值与配置取舍、group/peer 命名冲突、响应式顺序、display: none 无法过渡、Purge 移除动态类等问题及对应修复方式。
参考文件
文档列出参考文件及其内容与行数规模:references/component-patterns.md(约 700 行)、references/v4-migration.md(约 500 行)、references/configuration.md(约 500 行)、references/animation-patterns.md(约 110 行)。
使用方式
资料以模式、决策树和可复制代码片段的形式呈现。其中还包含一个事实校验脚本 scripts/check-tailwind-facts.py,可离线运行(结构校验,无网络,退出码 0 一致 / 10 漂移)或在线运行(每周新鲜度任务,检查文档中的主版本是否落后于 npm 最新 dist-tag,退出码 10 表示有主版本前进,7 表示 npm 不可达)。规范事实清单位于 assets/tailwind-facts.json。
适用场景
适合需要查阅 Tailwind 布局、响应式、暗色模式、组件写法以及从 v3 迁移到 v4 的前端开发工作。文档还提及与 react-ops、vue-ops、astro-ops、craftcms-ops、frontend-upgrade-ops、web-perf-ops 等技能配合使用,并引用官方文档 https://tailwindcss.com/docs 与 v4 博客 https://tailwindcss.com/blog/tailwindcss-v4。
限制
资料未提供该技能自身的安装方式、收费或价格信息、平台支持范围与性能效果数据,这些内容暂未提供。