跳转至

ISSUE-0224 设置页 tab CJK 逐字断行错位

来源

2026-10-02 Tony 截图报障(v0.16.75,截图 docs/raw/screenshots/2026-10-02-settings-tab-wrap-tony.png): 「设置里的 tab 错位到第二行了 优化处理下」。

实测形态(截图判读)

  • 设置页 tab 条(本地设置 / 云端设置 / AI)中,两个中文 tab 的文字在 trigger 内部逐字断行 ——「本地」一行、「设置」一行——tab 被撑成两行高,视觉上「错位到第二行」。
  • 截图右缘内容被裁切,水平溢出迹象。
  • 触发条件:面板可用宽度不足(窗口窄 / Chrome 侧栏窄 / 显示比例 zoom 放大——zoom 是 CSS zoom 挂 #root 的等比缩放,110% 即等效布局宽度 ÷1.1)。

根因(刀前勘验)

src/sections/settings/view/settings-view.tsx settings-tab-bar:flex items-center justify-between (左 Tabs + 右显示比例下拉),两侧 flex item 均无收缩防护。宽度不足时 Tabs 被压缩; src/components/ui/tabs.tsx TabsTrigger 基类 flex flex-1 flex-col——flex-basis 0% 的 等分项不抵抗压缩,且内容 span 无 whitespace-nowrap——CJK 文字可在任意字符间断行, 每个 tab 均分到窄于文字宽度的空间时逐字断行成两行。

公共 tabs 组件的 flex-col「标题+说明」两行设计(v0.16.48,为官网/地图切换设计)对设置页 单行 tab 是放大暴露面;本刀修设置页局部(className 级),不动公共组件基类。

修法方向

  • trigger 内容 whitespace-nowrap(禁 CJK 断行)+ TabsList/Tabs 收缩防护(shrink-0), 宽度不足改由右侧下拉区吸收或整条不溢出。
  • 保留 sticky 吸顶契约(settings-shell overflow:visible + bar sticky + bg-background—— 仓内多条 🔴 注释钉着,不许顺手改)。
  • L2 harness 进 tests/layout/:宽度×zoom 矩阵,先钉失败形态再修,断言失败形态消失
  • mutation 自证(拆 nowrap 必红)。

状态

  • 2026-10-02 开账,v0.16.76 处理。
  • 2026-10-02 v0.16.76 修复入仓:settings-view.tsx className 级 (trigger max-w-[7.5rem] shrink-0 whitespace-nowrap / Tabs 根 shrink-0 pr-4 / List+zoom 区 shrink-0 / bar overflow-x-auto+内联 scrollbarWidth:none), 公共 tabs.tsx 未动。L2 harness tests/layout/scan-settings-tab.mjs 退出码 0 (broken 724 点全断行复现 / fixed 0 失败 / mutation 全红自证); 全量 186 files / 2882 tests 绿;devlog 见 v0.16.76 条目。
  • 未来注意点(v0.16.76 回炉补记):① trigger 是 max-w-[7.5rem] + whitespace-nowrap 且无 overflow-hidden——≥5 字标题会画出框外(不截断不顶爆),届时必须补 overflow-hidden/截断策略(当前最长 114px 无溢出);② zoom 下拉在等效宽度 <331px 时完全滚出画面、初屏无视觉暗示,是否加渐隐 mask 属下刀裁量,本刀未做。