跳转至

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 逐项对账), 否则下次谁删一组变量,没有任何闸会红。已登记待办。