nex_design_system/docs/04-layout-system.md

98 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 04. Layout System & Page Shells
## 1. 布局治理原则
NEX 统一的是布局的职责分离、信息层级、响应式和交互质量,不要求所有项目使用相同导航结构或像素尺寸。具体 Shell、导航形态、Header/Sider 尺寸、内容边距、断点和滚动策略由项目规范定义。
## 2. 页面类型识别
实施前先按用户主要任务识别页面类型,例如:
- 管理型页面:列表、详情、编辑、设置、权限等。
- 概览型页面:Dashboard、监控和分析。
- 专业工作区:文档、聊天、流程、画布、IDE、媒体编辑等。
- 独立入口:登录、分享、公开展示、向导等。
以上是分类参考,不要求项目必须拥有所有类型。不存在的类型标记 `NOT_APPLICABLE`。
## 3. Shell 模式(概念性,不是组件命名要求)
### 3.1 应用 Shell
适用于需要全局导航、模块切换和统一页面容器的产品。可采用侧边导航、顶部导航、混合导航或其他经过验证的模式。
职责建议:
- 全局导航、当前上下文和用户入口清晰。
- 导航区域与主内容区滚动行为明确。
- 页面内容区域具有可预测的留白和宽度策略。
- 导航折叠/展开状态可恢复,且键盘操作可达。
### 3.2 内容/文档工作区
仅在产品存在文档阅读、编辑或文件管理任务时采用。
- 文件树、工具栏、编辑区/预览区职责分离。
- 需要独立滚动时,应明确每个滚动容器的边界。
- 编辑与预览应保持合理一致的内容宽度和阅读节奏。
- 嵌套 Flex/Grid 子项在需要收缩时检查 `min-width: 0`、`min-height: 0`。
### 3.3 对话工作区
仅在产品存在 AI Chat 或多轮消息任务时采用。
- 消息历史与输入区职责分离。
- 输入区在长消息流中保持可达。
- 会话列表、消息区和工具面板的滚动关系明确。
- 停止、重试、复制、引用和工具执行状态可理解。
### 3.4 专业工作台/画布
适用于流程编辑、数据分析、多面板控制和复杂创作任务。
- 主工作区优先获得足够空间。
- 可折叠/可调整面板的状态可预测。
- 拖拽操作应有键盘或其他非拖拽替代路径。
- 不使用普通后台页面的最大宽度限制挤压画布,除非产品规范明确要求。
### 3.5 独立页面 Shell
适用于登录、公开分享、邀请和向导等无需完整应用导航的页面。保持品牌和组件语义一致,但不强制显示全局导航。
## 4. 普通业务页面的信息顺序
可按任务选择:
1. 页面上下文/标题/面包屑。
2. 关键指标(只有帮助判断时才展示)。
3. 搜索、筛选、视图切换或批量操作。
4. 主内容(表格、卡片、表单、详情或图表)。
5. 帮助、审计信息或辅助说明。
不要为了填满空间添加没有业务价值的卡片或模块。
## 5. 响应式布局
- 优先复用项目已有断点和组件库响应式规则。
- 不强制采用某一固定断点数值;新增断点必须有真实布局需求和验证依据。
- 明确桌面、平板、窄屏下导航、表格、表单、工具栏和多栏工作区的变化。
- 不应简单缩小桌面布局来冒充移动端体验。
- 避免无意的整页横向滚动;宽表格可按项目设计采用横向滚动或替代呈现。
## 6. 滚动与尺寸约束
- 明确页面主滚动容器和嵌套工作区滚动容器。
- 不要在多个祖先层级重复设置 `overflow: auto/hidden` 而不清楚滚动归属。
- 检查长文本、长文件名、代码块、表格和媒体内容是否撑破布局。
- 固定高度应有产品理由;优先使用父容器约束、弹性布局或视口计算。
- 对 Flex/Grid 子项检查 `min-width: 0` 和 `min-height: 0`,但不要机械地全局添加。
## 7. 实施前必须记录
页面或 Shell 改造前,记录:
- 当前 Shell 和导航行为;
- 关键尺寸的权威来源;
- 视口变化时的布局行为;
- 滚动容器归属;
- 受影响页面清单;
- 现有视觉截图或可用回归检查。