设置页解释文字收进 ❓ —— 以及「藏警告」这个新风险面¶
起因¶
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} 这类贴合间距不动 —— 改了会糊在一起。