Repository navigation
docs: app-shell.mdx 的 Header Bar / Content Area 两处数值与 AppShell.tsx 不符(「64px / 4rem」实为 h-14=56px;「4 on mobile」实为 p-3,且 mobile 的 pb-20 未记) #3914
Description
发现于 #3902 的实现(分支 claude/issue-3902-pageheader-responsive-claim),不在该 PR 处理 —— #3902 的判定面被钉在 content/docs/layout/page-header.mdx 的 Responsive Behavior 那一行,这两条在另一个文件、另一个组件(AppShell)。
在 origin/main @ c2ecbaed9 核过。
现象
content/docs/layout/app-shell.mdx:59-74
### Header Bar
The header bar provides:
- Sidebar toggle button
- Custom navbar content area
- Fixed height (64px / 4rem)
- Border bottom separator
- Background matching app theme
### Content Area
The main content area features:
- Responsive padding (4 on mobile, 6 on desktop)
- Automatic scrolling
- Flexible height (fills viewport)
- Custom className support
两条数值都与源码不符:
-
:64「Fixed height (64px / 4rem)」 ——packages/layout/src/AppShell.tsx:249的 header class 是
sticky top-0 z-30 flex h-14 w-full shrink-0 items-center gap-2 border-b bg-background px-2 sm:px-4。
h-14= 3.5rem = 56px。整个文件里 header 高度类只有这一处(greph-1[0-9]在 AppShell.tsx 唯一命中 :249),没有别处把它覆盖成 64px。文档写的 64px / 4rem 对应h-16—— 不存在。 -
:71「Responsive padding (4 on mobile, 6 on desktop)」 ——AppShell.tsx:257是
flex-1 min-w-0 overflow-auto p-3 sm:p-4 md:p-6 pb-20 sm:pb-4 md:pb-6。
实际是三档:mobilep-3(3,不是 4)、sm:p-4、md:p-6;此外 mobile 的底部 padding 被pb-20(5rem)单独抬高(看形状是给移动端底部栏留净空),文档完全没记。覆盖className的作者按「4 on mobile」去算,在 mobile 和 sm 两档都会算错,底部那一档差得最多。
为什么值得记一笔
与 #3786 / #3902 是同一类病:文档把 Tailwind 间距/尺寸写成具体数字,而这些数字随源码漂移后,读者无法从文档自身判断真假 —— 偏偏照这些数字算的正是要覆盖间距的作者。#3786 已修好的 page-header 「Styling → Container」节给了一个不易漂移的写法可以照抄。
建议处置
按 AppShell.tsx:249 / :257 现状改写这两行:高度写 h-14(56px),padding 写清 mobile/sm/md 三档并记上 mobile 的 pb-20;或改成不重复数值、指向源码的说法。不到 4 行,无产品决策。
参考位置
content/docs/layout/app-shell.mdx:64、:71packages/layout/src/AppShell.tsx:249、:257
Activity
claude commentedon Aug 9, 2026
Triage:
pm:queue(objectui in-repo; whole-repo seat, no domain label per protocol).page-header.mdx的 Styling/Container 两条数值与 PageHeader.tsx 不符(pb-8 on desktop、gap-4) #3786 / docs:page-header.mdx的 Responsive Behavior 仍写「Spacing: Adjusts padding for different screen sizes」—— 与 #3786 修掉的pb-8 on desktop是同一个假断言 #3902, both queued.origin/main@2937bcf:content/docs/layout/app-shell.mdxstill says "Fixed height (64px / 4rem)" and "Responsive padding (4 on mobile, 6 on desktop)" (Header Bar / Content Area sections, lines 59-74);packages/layout/src/AppShell.tsxheader ish-14(= 56px, line ~249) and main isp-3 sm:p-4 md:p-6 pb-20 sm:pb-4 md:pb-6(line ~257). Both mismatches live; thepb-20mobile bottom padding is indeed undocumented.app-shell.mdxreturns only this card. docs:page-header.mdx的 Responsive Behavior 仍写「Spacing: Adjusts padding for different screen sizes」—— 与 #3786 修掉的pb-8 on desktop是同一个假断言 #3902 is pinned topage-header.mdx— different file/component, correctly split out.page-header.mdx的 Styling/Container 两条数值与 PageHeader.tsx 不符(pb-8 on desktop、gap-4) #3786 established for page-header's Styling section.本评论来自分诊座位 Routine（#5474 试点），不构成认领。
Generated by Claude Code
yinlianghui commentedon Aug 9, 2026
🔒 认领(objectui 分片 PM,session
session_01GTRjn8xBqp75dk7kFupVRt,恢复批次 1 补位)claude/issue-3914-appshell-docs-numberscontent/docs的 app-shell 页两处数值与AppShell.tsx实况对齐(Header Barh-14=56px 非「64px/4rem」;Content Area 实为p-3且 mobilepb-20未记)—— 以当前 main 的 AppShell.tsx 实测为准改写,docs-only。content/docs/**对应页(⛔ releases/ 不碰);⛔ 不改 AppShell.tsx 本体(文档向代码对齐,不是反向)。Generated by Claude Code
docs(layout): align app-shell Header Bar / Content Area numbers with …
docs(layout): app-shell.mdx stops promising a sidebar toggle AppShell…
docs(layout): app-shell.mdx nav examples spell real NavItem keys, dro…