Appearance
pro/layout 组件目录
文档定位:索引 · 源码实际归属forge-compose,文档仍按八组登记;应用由forge聚合转出。
panel 保留但已废弃,计划在 1.0-alpha 删除;本轮不删除、不改变公开 API。layout 收外壳/页面布局,compose 收跨组组合。
| 组件 | 文档组 | 源码 / 既有 API 文档 |
|---|---|---|
| AppAside | 布局 | 源码 · API |
| AppBody | 布局 | 源码 · API |
| AppFooter | 布局 | 源码 · API |
| AppHeader | 布局 | 源码 · API |
| AppLayout | 布局 | 源码 · API |
| AppPage | 布局 | 源码 · API |
| AppShell | 布局 | 源码 |
| AppSidebar | 布局 | 源码 · API |
| AppPageDetail | 布局 | 源码 · API |
| AppPageListDetailLayout | 布局 | 源码 · API |
| AppPageListDetailSheet | 布局 | 源码 |
| AppPageListDetailSplit | 布局 | 源码 |
| ViewLayout | 布局 | 源码 · API |
| ViewLayoutNavigation | 布局 | 源码 |
| ViewLayoutToolbar | 布局 | 源码 |
组件专属 hook/测试/类型与组件收纳;组内单文件组件直接留在组目录。职责桶按package.json exports提供包间组合,不等于扩增应用公开白名单。完整迁移映射见仓根 scripts/core-component-path-map.json。
本批事件
AppBody 按需采集 body-scroll;sidebar/aside 由 bridge setter 单发折叠事件,组件不重复发。
新增组件指引
新增组件必须补埋点:按统一要求更新矩阵、事件文档和 reference,运行 pnpm core:instrumentation;无事件写明原因。AppBody 负责文档滚动,sidebar/aside 由 bridge setter 单发;组合布局不重复报。
C 源码迁移
本组件及配套类型/hooks/测试/API迁至 packages/forge-compose/src/components,去掉 pro 重复层。应用消费 @done-coding/forge;组件 API、槽与事件不变,Panel已由pn1031退役(C拆包时曾保留)。
无障碍 API(td1v4s)
内部 ViewLayoutNavigation 的上下条图标按钮默认名称为“上一条”“下一条”,不新增 prop。