跳转至

设置页解释文字收进 ❓ —— 以及「藏警告」这个新风险面

起因

Tony 实测 v0.10.195 后:「很多解释文字是不是要收一收?比如搞个 ❓, 点击问号才显示详细的解释?设置的布局是不是要紧凑点?」

当时设置页有 59 处 helperText + 43 处 caption,每条都在标签下方占一整行, 十张卡滚六屏 —— 要调的那个输入框被解释埋在中间。

🔴 真正的发现:批量收起来之后,1652 条测试一条都没红

把 46 处 helperText= 机械改成 helpTip=(从常亮改成 hover 才见),全绿。

因为守这些文案的现有闸 —— ISSUE-0152 的 audit_grep、settings-copy-guards —— 量的都是「文件里有没有这个串」。串一个字没动,只是换了属性名。

而 ISSUE-0152 守的那三条恰恰是「商家会被直接不入库、且不可恢复」的警告。 也就是说:顺手把它们一起收进 ❓,没有任何现存机制会喊一声。

这是本仓「判据在量别的东西」的又一个活样本,而且是新形态 —— 以前是量错了对象,这次是量对了对象、漏掉了「可见性」这个维度。 同一句话挂 helperText 和挂 helpTip,对用户是两件事。

分档判据

档 判据 处置 条数
A 看不见就会丢数据 / 发凭据 / 静默改行为 留 helperText 常亮 6
短 ≤10 字(质量分五维的「emails 非空」之类) 不动 —— 收起来反而要多 hover 一次 5
B 解释字段是什么、填多少合适、名词、架构科普 转 helpTip 46

C 档(直接删)最终定为 0 条。 删是不可逆的信息损失,而收进 ❓ 已经达成紧凑目标 —— 本仓「不许阉割」的铁律在这里同样适用。

机制设计:让「藏起来」成为显式动作

没有做成「helperText 自动转 tooltip」,而是新增一个并列的 helpTip prop:

  • 不写 helpTip ⇒ 说明留在明面
  • 想藏 ⇒ 必须动手改那一行

⇒ 「忘了处理」的结果是「话还在」,不是「警告悄悄消失了」。

落点:src/components/help-tip.tsx + rhf-text-field / rhf-switch / rhf-select 三个组件各加一个 helpTip,SectionCard / AdvancedSection 也加(区块级架构说明)。

两块「共享队列架构」蓝底 banner(各占约 8 行)整块收进折叠区标题旁的 ❓。

新闸 tests/settings-help-tip-guards.test.ts

判据不是「文案在不在」,是「它挂在哪个属性上」。

这道闸自己也犯了两次判据错误(值得记)

变异 第一版结果 病因
M6 删掉「评分门槛」那句 ❌ 没红 窗口没有边界,往后找到了「评论数门槛」控件里一模一样的句子
组件 helperText 传递判据 ❌ 基线就红 判据写成 helperText={,而 rhf-switch 走的是 <FormHelperText> 的 children

修完之后四发变异全中:

# 变异 结果
M5 minRating 警告改挂 helpTip ✅ 红
M6 删掉「这里不删任何商家」 ✅ 红
M7 组件解构 helperText 却不用 ✅ 红
M8 危险组「不是勾选后立即生效」改挂 helpTip ✅ 红

窗口边界的取法要按锚点形态分两种,这个区分是踩出来的不是设计出来的:

  • 属性锚点 name="minRating" —— 已在控件里,下一个控件标签就是边界
  • 文本锚点 ⚠️ 会删数据… —— 在控件外,紧跟的标签正是要检查的控件本身,得跳过第一个

边界正则用同级控件白名单,不用「下一个大写标签」—— helperText 文本里就有 <REDACTED:type> 这种字面量,会被当成标签提前截断窗口。

交互

hover 即显(桌面主流)+ 点击锁定(Tony 原话「点击问号才显示」)+ 点别处关闭。 AdvancedSection 里的 ❓ 必须 stopPropagation —— 它坐在 AccordionSummary 上, 不拦冒泡的话点它会把整个折叠区一起收起来。

密度

只收窄容器级间距(卡内 padding 2→1.75、容器 Stack 2.5→2 / 2→1.5), spacing={0.x} 这类贴合间距不动 —— 改了会糊在一起。