ISSUE-0220 Tailwind 的 CSS 变量层被漏掉¶
症状(Tony 实测 v0.16.54)¶
「地区选择位置怎么到右下呢」
地区选择弹窗跑到屏幕右下角、部分超出可视区。
根因¶
src/components/ui/dialog.tsx 的定位写法本身是对的
(fixed left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2),
但构建产物里这个类生成的是:
.-translate-x-1\/2 {
--tw-translate-x: -50%;
transform: translate(var(--tw-translate-x), var(--tw-translate-y))
rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y))
scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y));
}
--tw-translate-y / --tw-rotate / --tw-skew-* / --tw-scale-* 全都没有定义
⇒ 整条 transform 的值无效 ⇒ 浏览器丢弃整条声明
⇒ 元素停在 left:50% top:50%,左上角落在屏幕正中 ⇒ 看起来就在右下角。
为什么变量没了:这些默认值由 Tailwind 3 的 @tailwind base(CSS 变量层)输出。
v0.16.40 为了关掉 preflight(本仓 200+ 文件还在用 MUI,那套 reset 会整体砸界面),
src/styles/tailwind.css 整个没写 @tailwind base,
只手补了 border-style 和 <button> 两项 reset —— 变量层被一起漏掉了。
🔴 波及面远不止定位¶
在构建产物上实测,这些变量全部"被引用但无默认值":
--tw-shadow ⇒ 所有 shadow-* 失效
--tw-ring-offset-shadow ⇒ 所有 ring-* 失效
--tw-ring-color
--tw-blur ⇒ blur / filter 失效
⇒ 阴影、focus 环、模糊从 v0.16.40 起一直没生效过(五个版本)。 主控在 v0.16.43~49 几轮"视觉打磨"里以为界面不够精致是设计问题, 反复调 shadow 数值 —— 而那些声明从来没有进入过渲染。
修法¶
在 tailwind.css 的局部 reset 段补全 Tailwind 3 的全部 --tw-* 默认值,
清单从 node_modules/tailwindcss 取(不凭记忆列,漏一个就是又一个静默失效的特性)。
🔴 preflight 仍然关着、仍然没有 @tailwind base —— 那条约束至今成立。
验证(真浏览器,不是 jsdom)¶
修复后在构建产物 + 真实浏览器里量:
transform = matrix(1, 0, 0, 1, -100, -50) ← 之前是 none
元素中心 = (420,450) 视口中心 = (420,450)
居中偏差 = 0 , 0
阴影 = 生效
🔴 元教训¶
关掉一个框架的 base 层时,要分清它里面有几样东西。
Tailwind 的 base 层含两部分:① preflight(全局 reset)② CSS 变量默认值层。 我们只想关掉 ①,却把整个 base 一起去掉了,②被连坐 —— 而 ② 的失效是静默的: 没有报错、没有告警,只有"阴影好像没那么明显""弹窗位置怪怪的"这类说不清的症状。
同一形态在本仓已发生两次: v0.16.44b border-style 缺失 ⇒ 边框一根都不显示(当时只补了这一项) v0.16.55 变量层缺失 ⇒ transform / shadow / ring 全体失效
⇒ 第一次补的时候就该问"还缺什么",而不是"这个症状修好了吗"。
遗留¶
执行方建议把变量清单固化成闸(跑 Tailwind CLI 取 golden 逐项对账), 否则下次谁删一组变量,没有任何闸会红。已登记待办。