SuperAPI AI 工具集

tailwind-patterns

前端与建站

查看项目

更新于 10-15 23:24

技能介绍

用途:整理 Tailwind CSS v4 的现代写法与原则,帮助以 CSS-first 方式做配置与组件设计,替代 v3 的 JavaScript 配置文件。

主要能力:v4 相对 v3 的改动包括——tailwind.config.js 改为 CSS 中的 @theme 指令;PostCSS 插件换成 Oxide 引擎(完整构建约 5 倍,增量构建超过 100 倍);JIT 原生常开;插件系统变为 CSS 原生特性;@apply 仍可用但不推荐。核心概念为 CSS-first、Oxide 引擎、原生嵌套、所有 token 以 --* 变量暴露。

使用方式:用 @theme 定义颜色、间距、字体等语义变量,如 --color-primary、--spacing-md、--font-sans;用 @container 定义容器并在子元素用 @sm、@md、@lg 响应(可命名如 @container/card);响应式采用移动优先,断点为 sm 640px、md 768px、lg 1024px、xl 1280px、2xl 1536px;暗色模式可选 class、media 或 v4 的 selector 策略。布局方面给出 flex 居中、纵向堆叠、两端对齐、换行网格,以及 grid 的 auto-fit、Bento 非对称、侧边栏 grid-cols-[auto_1fr] 等模式。颜色推荐 OKLCH,并按 primitive、semantic、component 三层组织 token。

抽取与限制:同一组类出现 3 次以上、状态变体复杂或属设计系统元素时应抽取为 React/Vue 组件,@apply 仅在缺少组件层时少量使用。反模式包括到处用任意值、!important、内联 style、重复长类名、混用 v3 配置与 v4、大量使用 @apply。性能上 v4 自动清除未使用样式,避免模板字符串生成类名,利用 Oxide 与 CI/CD 缓存。官方资料未提供具体安装命令与版本号,故此处不列。